# TradePulse Freight Rate Intelligence

> TradePulse Freight Rate Intelligence is a paid API for AI agents from tradepulse-five.vercel.app, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-13).

Returns live container and air freight rates by shipping lane with 90-day benchmark, route status, carrier options, and cost estimates

## Facts

- Endpoint: GET https://tradepulse-five.vercel.app/api/trade/freight-rates
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 3
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tradepulse-freight-rate-intelligence-8dbeb487
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_W3N0mk79FDbEv-04Ds9UM

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tradepulse-freight-rate-intelligence-8dbeb487
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradepulse-freight-rate-intelligence-8dbeb487/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tradepulse-five.vercel.app](https://www.zero.xyz/host/tradepulse-five.vercel.app/llms.txt)
