Get a live quote

curl -X POST 'https://api.freightratesmcp.com/v1/rates/quote' \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"origin":"CNSHA","destination":"NLRTM","transport_mode":"Sea","shipping_type":"FCL","transport_unit":"40'hc"}'

const res = await fetch("https://api.freightratesmcp.com/v1/rates/quote", {
  method: "POST",
  headers: {
    "Authorization": "Bearer tmcp_YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "origin": "CNSHA",
    "destination": "NLRTM",
    "transport_mode": "Sea",
    "shipping_type": "FCL",
    "transport_unit": "40'hc"
  })
});
const data = await res.json();

import requests

res = requests.post(
    "https://api.freightratesmcp.com/v1/rates/quote",
    headers={"Authorization": "Bearer tmcp_YOUR_API_KEY"},
    json={
      "origin": "CNSHA",
      "destination": "NLRTM",
      "transport_mode": "Sea",
      "shipping_type": "FCL",
      "transport_unit": "40'hc"
    },
)
data = res.json()

{
  "success": true,
  "request_id": "req_7d2e41c0b9",
  "query": {
    "origin": "CNSHA",
    "destination": "NLRTM",
    "transport_mode": "Sea",
    "shipping_type": "FCL",
    "transport_unit": "40'hc",
    "hierarchy": "Sea-FCL-40'hc",
    "container_type": "40HC",
    "shipment_date": null
  },
  "rate_mode": "all",
  "complete": true,
  "quotes_count": 32,
  "quotes": [
    {
      "provider": "navo24",
      "provider_id": "navo24",
      "carrier": "Hapag-Lloyd",
      "mode": "OCEAN_FCL",
      "transport_mode": "Sea",
      "shipping_type": "FCL",
      "transport_unit": "40'hc",
      "hierarchy": "Sea-FCL-40'hc",
      "mode_source": "request",
      "volumetric_divisor": null,
      "total_amount": 3535,
      "currency": "USD",
      "transit_days": 41,
      "valid_from": "2026-10-08",
      "valid_until": "2026-11-01",
      "departure": "2026-11-01",
      "is_indicative": false,
      "includes": "Ocean freight (spot) direct, vessel SINGAPORE EXPRESS 644W, origin terminal fees extra (USD 250)",
      "booking_ref": "nr_5d4f00fa07c41e2",
      "container_type": "40HC",
      "badge": "live"
    },
    {
      "provider": "navo24",
      "provider_id": "navo24",
      "carrier": "CMA CGM",
      "mode": "OCEAN_FCL",
      "transport_mode": "Sea",
      "shipping_type": "FCL",
      "transport_unit": "40'hc",
      "hierarchy": "Sea-FCL-40'hc",
      "mode_source": "request",
      "volumetric_divisor": null,
      "total_amount": 3550,
      "currency": "USD",
      "transit_days": 49,
      "departure": "2026-10-30 06:00:00",
      "valid_from": "2026-10-15",
      "valid_until": "2026-10-29",
      "is_indicative": false,
      "includes": "1x 40HC, port-to-port CNSHA -> NLRTM, ocean freight service FAL8, direct; local charges (THC, DOC etc.) not included",
      "booking_ref": "nr_95af9bb4b7c41e2",
      "container_type": "40HC",
      "badge": "live"
    },
    {
      "provider": "navo24",
      "provider_id": "navo24",
      "carrier": null,
      "mode": "OCEAN_FCL",
      "transport_mode": "Sea",
      "shipping_type": "FCL",
      "transport_unit": "40'hc",
      "hierarchy": "Sea-FCL-40'hc",
      "mode_source": "request",
      "volumetric_divisor": null,
      "total_amount": 3300,
      "currency": "USD",
      "transit_days": 35,
      "departure": null,
      "valid_from": null,
      "valid_until": null,
      "is_indicative": true,
      "includes": "1x 40HC, port-to-port Shanghai -> Rotterdam; ocean 3200 + origin handling/doc 100 USD; excl. customs, origin/destination THC, insurance",
      "booking_ref": "nr_d8eb0d4067c41e2",
      "badge": "indicative",
      "basis": "tariff",
      "container_type": "40HC",
      "badge_label": "Indicative / approximation"
    }
  ],
  "market_indices": [
    {
      "provider": "navo24",
      "provider_id": "navo24",
      "is_indicative": true,
      "applies_to": "China export market (composite)",
      "date": "2026-10-16",
      "unit": "points",
      "value": 3679.58,
      "previous": 3664.11,
      "change_pct": 0.42,
      "note": "Market index, not a bookable price. Public feed gives the composite only."
    }
  ],
  "providers": [
    {
      "provider": "navo24",
      "provider_id": "navo24",
      "status": "ok",
      "quotes": 10,
      "cached": true,
      "cached_at": "2026-10-20T20:53:35.597Z"
    },
    {
      "provider": "navo24",
      "provider_id": "navo24",
      "status": "no_rates",
      "quotes": 0
    },
    {
      "provider": "navo24",
      "provider_id": "navo24",
      "status": "pending",
      "retry_after_s": 25
    }
  ],
  "took_ms": 3927
}