llms.txt Content
# ShippingRates Shipping Intelligence API
# https://api.shippingrates.org
# x402 v2 Payment Protocol — USDC on Base Mainnet + Solana Mainnet
## Free Endpoints (no payment required)
GET /api/stats — Database statistics (record counts, shipping lines, countries)
GET /api/lines — List all 7 shipping lines with per-country breakdowns
GET /api/search?keyword=X — Search shipping data by keyword
GET /api/fx?from=USD&to=INR — Currency exchange rates
## Paid Endpoints (x402 — USDC on Base or Solana)
POST /api/dd/calculate — D&D cost calculation ($0.10/call)
POST /api/dd/compare — Cross-line D&D comparison ($0.25/call)
POST /api/local-charges — Port local charges ($0.05/call)
POST /api/inland-search — Inland transport route search ($0.03/call)
POST /api/cfs — CFS handling tariffs ($0.05/call)
POST /api/inland — Inland haulage rates ($0.05/call)
GET /api/port?code=INNSA — Port details ($0.01/call)
GET /api/transit?origin=INNSA&destination=AEJEA — Transit times ($0.02/call)
GET /api/rates?origin=INNSA&destination=AEJEA&container_type=40HC — Freight rates ($0.03/call)
GET /api/surcharges?line=maersk&country=IN — Surcharges ($0.02/call)
GET /api/congestion?port=INNSA — Port congestion ($0.02/call)
GET /api/reliability?line=maersk — Schedule reliability ($0.02/call)
GET /api/vessel-schedule?port=INNSA — Vessel schedule ($0.02/call)
GET /api/regulatory?country=IN — Regulatory updates ($0.01/call)
GET /api/total-cost?line=maersk&origin=INNSA&destination=AEJEA&container_type=40HC — Full landed cost ($0.15/call)
POST /api/transit-schedules — Transit schedules by carrier ($0.03/call)
POST /api/facilities — ICD/CFS facility directory ($0.02/call)
POST /api/congestion-news — Port congestion news alerts ($0.02/call)
POST /api/inland/compare — Compare inland haulage rates ($0.08/call)
POST /api/risk-score — Route risk score with chokepoint analysis ($0.10/call)
## Free Tier
25 free requests per month per IP across all paid endpoints. N
OpenAPI Spec (preview)
{"openapi":"3.1.0","info":{"title":"ShippingRates API","version":"2.2.0","description":"Shipping intelligence API for demurrage, detention, freight rates, local charges, transit times, port congestion, inland haulage, and risk scoring. Covers 7 shipping lines across 195 countries with 20,187 verified d&d tariffs across 2,519 ports. Supports x402 micropayments (USDC on Base and Solana) and MCP protocol for AI agent integration.","contact":{"name":"ShippingRates","email":"vinay@shippingrates.org",