{"uid":"cap_W3N0mk79FDbEv-04Ds9UM","slug":"tradepulse-freight-rate-intelligence-8dbeb487","name":"TradePulse Freight Rate Intelligence","description":"Live freight rate intelligence for logistics and trade agents. Returns container and air rates by lane with a 90-day benchmark, route status, carrier options, and cost estimates.","url":"https://tradepulse-five.vercel.app/api/trade/freight-rates","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"lang":{"type":"string"},"mode":{"type":"string"},"origin":{"type":"string"},"destination":{"type":"string"},"container_type":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"lane":"Shanghai → Los Angeles","mode":"ocean","benchmark":{"vs_90day_pct":"+12%","90day_avg_usd":2550},"current_rate":{"unit":"per 40ft container","trend":"rising","usd_per_unit":2850},"route_status":{"congestion_level":"medium","active_disruptions":["Red Sea diversions"]},"top_carriers":[{"name":"Maersk","reliability_score":"8.2/10"}],"transit_time":{"typical":"14-16 days","days_max":16,"days_min":14}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LifWqu26lpRZKW_Ze7MLx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live container and air freight rates by shipping lane with 90-day benchmark, route status, carrier options, and cost estimates","exampleAgentPrompt":"What are the current container freight rates for a 40-foot FCL shipment from Shanghai to Los Angeles, and how do they compare to the 90-day benchmark? Also show me available carriers on that lane.","exampleUseCases":null,"resultDescription":"Returns live freight rates for the requested lane broken down by carrier, container type, and mode (ocean/air), alongside a 90-day historical benchmark for context, current route/port status indicators, a list of carrier options servicing the lane, and fully loaded cost estimates including surcharges.","failureModes":["Unsupported or unrecognized origin/destination lane returns no results or 404","Invalid shipping mode parameter returns validation error","Rate data temporarily unavailable for a specific lane returns partial or stale data","Missing required origin or destination parameter returns 400 bad request","Payment not processed (x402 payment required) returns 402 error"],"whenToPreferThis":"Choose this endpoint when you need real-time freight rate quotes with historical context (90-day benchmark) for specific shipping lanes, especially when carrier selection and route status are also needed. Prefer over generic logistics APIs when the query involves international container or air freight cost intelligence with benchmarking. Pairs well with the same platform's HS code, tariff, and trade policy endpoints for full landed cost analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-07-27T18:45:19.263Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:31:31.431Z","isFirstParty":false}