curl -X POST https://win.oneshotagent.com/v1/tools/lookup/market-truck-rates \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"origin": "Salinas",
"destination": "Chicago",
"weeks": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/market-truck-rates", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"origin": "Salinas",
"destination": "Chicago",
"weeks": 1
}),
});
const result = await agent.tool('lookup/market-truck-rates', {
origin: 'Salinas',
destination: 'Chicago',
weeks: 1
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "market_truck_rates",
"result": {
"lanes": [
{
"origin": "SALINAS-WATSONVILLE CALIFORNIA",
"region": "CALIFORNIA",
"destination": "CHICAGO",
"distance_miles": 2220,
"commodities": [
"BROCCOLI",
"CAULIFLOWER",
"BOSTON LETTUCE",
"GREEN LETTUCE LEAF",
"ICEBERG LETTUCE",
"RED LETTUCE LEAF",
"ROMAINE LETTUCE",
"STRAWBERRIES"
],
"weeks": [
{
"week_of": "2026-10-20",
"low_usd": 5090,
"high_usd": 5400,
"midpoint_usd": 5245,
"rate_per_mile_usd": 2.3626,
"availability": 3
}
]
}
]
},
"evidence": {
"source": "US Department of Agriculture",
"source_kind": "public",
"retrieved_at": "2026-10-25T00:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-25T00:00:00.000Z"
}
],
"as_of": "2026-10-20"
}
}
}
Products & vehicles
Truck Rates
Look up weekly refrigerated produce truck rates and availability by shipping district and destination.
POST
/
v1
/
tools
/
lookup
/
market-truck-rates
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/market-truck-rates \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"origin": "Salinas",
"destination": "Chicago",
"weeks": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/market-truck-rates", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"origin": "Salinas",
"destination": "Chicago",
"weeks": 1
}),
});
const result = await agent.tool('lookup/market-truck-rates', {
origin: 'Salinas',
destination: 'Chicago',
weeks: 1
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "market_truck_rates",
"result": {
"lanes": [
{
"origin": "SALINAS-WATSONVILLE CALIFORNIA",
"region": "CALIFORNIA",
"destination": "CHICAGO",
"distance_miles": 2220,
"commodities": [
"BROCCOLI",
"CAULIFLOWER",
"BOSTON LETTUCE",
"GREEN LETTUCE LEAF",
"ICEBERG LETTUCE",
"RED LETTUCE LEAF",
"ROMAINE LETTUCE",
"STRAWBERRIES"
],
"weeks": [
{
"week_of": "2026-10-20",
"low_usd": 5090,
"high_usd": 5400,
"midpoint_usd": 5245,
"rate_per_mile_usd": 2.3626,
"availability": 3
}
]
}
]
},
"evidence": {
"source": "US Department of Agriculture",
"source_kind": "public",
"retrieved_at": "2026-10-25T00:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-25T00:00:00.000Z"
}
],
"as_of": "2026-10-20"
}
}
}
Returns reported weekly rates for refrigerated produce loads, not a quote, from the US Department of Agriculture. Origins are shipping districts. Each lane includes weekly low, high, midpoint and rate per mile, plus truck availability: 1 means surplus, 3 adequate supply and 5 shortage, with intermediate values 2 and 4.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
Shipping district substring, for example Salinas or Florida. 2 to 80 characters.
string
Destination city substring, for example Chicago. 2 to 80 characters.
integer
Most recent weeks per lane. From 1 to 26. Defaults to
4.Response (200 OK)
Top-level envelope:success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status:
completedstring
Always
market_truck_ratesobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always
US Department of Agriculture.string
public when the data comes from a public body, commercial otherwisestring
When the lookup was made, as an ISO 8601 UTC time
string | null
When the source says the fact was last updated, or
null when the source gives no dateResult
Nested underdata.result.
object[]
Lanes ordered by newest week, then origin and destination.
string
Shipping district.
string
Source region.
string
Destination city.
number | null
Estimated lane distance in miles.
null when the source gives no value.string[]
Commodity mix for the newest reported week.
object[]
Newest reported weeks first.
string
Reported week ending date (YYYY-MM-DD).
number | null
Lowest reported truck rate during the week.
null when the source gives no value.number | null
Highest reported truck rate during the week.
null when the source gives no value.number | null
Source average of the weekly low and high.
null when the source gives no value.number | null
Source midpoint divided by distance, rounded to four decimal places.
null when the source gives no value.integer | null
Truck supply: 1 surplus, 3 adequate, 5 shortage; intermediate values are 2 and 4.
null when the source gives no value.curl -X POST https://win.oneshotagent.com/v1/tools/lookup/market-truck-rates \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"origin": "Salinas",
"destination": "Chicago",
"weeks": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/market-truck-rates", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"origin": "Salinas",
"destination": "Chicago",
"weeks": 1
}),
});
const result = await agent.tool('lookup/market-truck-rates', {
origin: 'Salinas',
destination: 'Chicago',
weeks: 1
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "market_truck_rates",
"result": {
"lanes": [
{
"origin": "SALINAS-WATSONVILLE CALIFORNIA",
"region": "CALIFORNIA",
"destination": "CHICAGO",
"distance_miles": 2220,
"commodities": [
"BROCCOLI",
"CAULIFLOWER",
"BOSTON LETTUCE",
"GREEN LETTUCE LEAF",
"ICEBERG LETTUCE",
"RED LETTUCE LEAF",
"ROMAINE LETTUCE",
"STRAWBERRIES"
],
"weeks": [
{
"week_of": "2026-10-20",
"low_usd": 5090,
"high_usd": 5400,
"midpoint_usd": 5245,
"rate_per_mile_usd": 2.3626,
"availability": 3
}
]
}
]
},
"evidence": {
"source": "US Department of Agriculture",
"source_kind": "public",
"retrieved_at": "2026-10-25T00:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-25T00:00:00.000Z"
}
],
"as_of": "2026-10-20"
}
}
}
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers
200.Notes
- Origin and optional destination match uppercase substrings. Omit destination to return several lanes.
- Reads one page of weeks × 40 rows, capped at 1000, newest first; keeps up to weeks rows per lane from that page. History is available from the first call.
- Lane details use the newest row. Empty numeric fields are null. No match returns an empty lanes list.
- Results return inline. The finished job stays available at
/v1/requests/{request_id}