curl -X POST https://win.oneshotagent.com/v1/tools/lookup/market-freight-rate \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"origin_zip": "90012",
"destination_zip": "94105",
"mode": "ltl",
"pickup_date": "2026-10-20",
"pallets": 2,
"weight_lbs_per_pallet": 800,
"length_in": 48,
"width_in": 40,
"height_in": 48
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/market-freight-rate", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"origin_zip": "90012",
"destination_zip": "94105",
"mode": "ltl",
"pickup_date": "2026-10-20",
"pallets": 2,
"weight_lbs_per_pallet": 800,
"length_in": 48,
"width_in": 40,
"height_in": 48
}),
});
const result = await agent.tool('lookup/market-freight-rate', {
origin_zip: '90012',
destination_zip: '94105',
mode: 'ltl',
pickup_date: '2026-10-20',
pallets: 2,
weight_lbs_per_pallet: 800,
length_in: 48,
width_in: 40,
height_in: 48
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "market_freight_rate",
"result": {
"rate": 329.95,
"currency": "USD",
"mode": "ltl",
"transit_days": 3,
"pickup_date": "2026-10-20",
"delivery_date": "2026-10-23",
"valid_until": "2026-10-18T03:36:09.269Z",
"quote_tier": "indicative",
"included_services": [
"liftgate",
"residential delivery",
"delivery appointment",
"limited access",
"notify before delivery"
]
},
"evidence": {
"source": null,
"source_kind": "commercial",
"retrieved_at": "2026-10-14T03:36:09.269Z",
"calls": [
{
"retrieved_at": "2026-10-14T03:36:09.269Z"
}
],
"as_of": null
}
}
}
Products & vehicles
Freight Rate Quote
Quote a freight lane between two US ZIP codes for a pickup date, by mode.
POST
/
v1
/
tools
/
lookup
/
market-freight-rate
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/market-freight-rate \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"origin_zip": "90012",
"destination_zip": "94105",
"mode": "ltl",
"pickup_date": "2026-10-20",
"pallets": 2,
"weight_lbs_per_pallet": 800,
"length_in": 48,
"width_in": 40,
"height_in": 48
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/market-freight-rate", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"origin_zip": "90012",
"destination_zip": "94105",
"mode": "ltl",
"pickup_date": "2026-10-20",
"pallets": 2,
"weight_lbs_per_pallet": 800,
"length_in": 48,
"width_in": 40,
"height_in": 48
}),
});
const result = await agent.tool('lookup/market-freight-rate', {
origin_zip: '90012',
destination_zip: '94105',
mode: 'ltl',
pickup_date: '2026-10-20',
pallets: 2,
weight_lbs_per_pallet: 800,
length_in: 48,
width_in: 40,
height_in: 48
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "market_freight_rate",
"result": {
"rate": 329.95,
"currency": "USD",
"mode": "ltl",
"transit_days": 3,
"pickup_date": "2026-10-20",
"delivery_date": "2026-10-23",
"valid_until": "2026-10-18T03:36:09.269Z",
"quote_tier": "indicative",
"included_services": [
"liftgate",
"residential delivery",
"delivery appointment",
"limited access",
"notify before delivery"
]
},
"evidence": {
"source": null,
"source_kind": "commercial",
"retrieved_at": "2026-10-14T03:36:09.269Z",
"calls": [
{
"retrieved_at": "2026-10-14T03:36:09.269Z"
}
],
"as_of": null
}
}
}
Quote the rate to move freight between two US ZIP codes on a pickup date, by mode: ltl shares a trailer by the pallet, ftl is a whole 53-foot dry van, van is a cargo van and box_truck is a 26-foot box truck. The answer is one carrier’s quote for that lane: the rate for the whole shipment with every included service, the transit time, the pickup and delivery dates, when the quote lapses and whether it is firm or indicative. Use it to check a billed freight charge against the lane’s going rate. For ltl give the pallets, the weight per pallet and the pallet dimensions; for van and box_truck give the pallets and the weight per pallet; for ftl the lane and date are enough. A lane the mode does not serve is refused as invalid input: try another mode. Covers US lanes. Nothing is booked.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
Where the freight is collected. 5-digit US ZIP code.
string
required
Where the freight is delivered. 5-digit US ZIP code.
string
required
How the freight moves. Picks the quote asked for; there is no default. One of
ltl, ftl, van, box_truck.string
required
The day the freight is collected: today (UTC) or later. YYYY-MM-DD.
integer
How many pallets. Required for ltl, van (up to 3) and box_truck (up to 12); not needed for ftl. At least 1.
integer
The weight of each pallet in pounds. Required for ltl, van (3,500 lb in all) and box_truck (10,000 lb in all); not needed for ftl. At least 1.
integer
The length of each pallet in inches. Required for ltl; ignored for other modes. At least 1.
integer
The width of each pallet in inches. Required for ltl; ignored for other modes. At least 1.
integer
The height of each pallet in inches, up to 85. Required for ltl; ignored for other modes. At least 1.
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_freight_rateobject
The answer, described under Result below
object
Where the answer came from and when
string
null. The data comes from a commercial source.string
public when the data comes from a public body, commercial otherwisestring
When the lookup was made, as an ISO 8601 UTC time
string
When the source says the fact was last updated, or
null when the source gives no dateResult
Nested underdata.result.
number
The quoted price for the whole shipment, every included service counted.
string
The currency of the rate, as an ISO 4217 code.
string
The mode quoted. Differs from the mode asked for when no shared-trailer service covers the lane and a whole truck was quoted instead.
integer
Days from pickup to delivery.
string
YYYY-MM-DD.
string
YYYY-MM-DD.
string
When the quote lapses, ISO 8601.
string
firm: every pricing input was given, so the price stands as quoted. indicative: an optional detail such as the commodity was not given, so the price can change at booking.
string[]
Services the rate already covers, such as liftgate or residential delivery.
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/market-freight-rate \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"origin_zip": "90012",
"destination_zip": "94105",
"mode": "ltl",
"pickup_date": "2026-10-20",
"pallets": 2,
"weight_lbs_per_pallet": 800,
"length_in": 48,
"width_in": 40,
"height_in": 48
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/market-freight-rate", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"origin_zip": "90012",
"destination_zip": "94105",
"mode": "ltl",
"pickup_date": "2026-10-20",
"pallets": 2,
"weight_lbs_per_pallet": 800,
"length_in": 48,
"width_in": 40,
"height_in": 48
}),
});
const result = await agent.tool('lookup/market-freight-rate', {
origin_zip: '90012',
destination_zip: '94105',
mode: 'ltl',
pickup_date: '2026-10-20',
pallets: 2,
weight_lbs_per_pallet: 800,
length_in: 48,
width_in: 40,
height_in: 48
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "market_freight_rate",
"result": {
"rate": 329.95,
"currency": "USD",
"mode": "ltl",
"transit_days": 3,
"pickup_date": "2026-10-20",
"delivery_date": "2026-10-23",
"valid_until": "2026-10-18T03:36:09.269Z",
"quote_tier": "indicative",
"included_services": [
"liftgate",
"residential delivery",
"delivery appointment",
"limited access",
"notify before delivery"
]
},
"evidence": {
"source": null,
"source_kind": "commercial",
"retrieved_at": "2026-10-14T03:36:09.269Z",
"calls": [
{
"retrieved_at": "2026-10-14T03:36:09.269Z"
}
],
"as_of": null
}
}
}
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
- Results return inline. The finished job stays available at
/v1/requests/{request_id}