# TradePulse Freight Rates API

> TradePulse Freight Rates API is a paid API for AI agents from tradepulse.theaslangroupllc.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

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

## Facts

- Endpoint: GET https://tradepulse.theaslangroupllc.com/api/trade/freight-rates
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tradepulse-freight-rates-api-be8999c7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LmdXTgDqgsKTi00Q_ajtG

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-rates-api-be8999c7
```

Example prompt: Pull the current container freight rates for the Shanghai to Los Angeles lane, including how today's rates compare to the 90-day benchmark and what carrier options are available.

## When to prefer this

Use this endpoint when you need real-time freight rate intelligence for a specific trade lane, particularly when you need carrier comparisons and historical benchmarking. Best suited for logistics agents, freight procurement tools, and supply chain cost estimators that need live market rates rather than static tariff schedules.

## Known failure modes

- Unknown or unsupported trade lane returns empty results or 404
- Invalid shipping mode parameter returns 400 bad request
- Rate data temporarily unavailable for a lane returns partial or stale data
- Payment not processed returns 402 payment required
- Malformed lane or port codes return validation 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 container and air freight rates for the requested trade lane, a 90-day historical benchmark for context, current route status (e.g. congestion, delays), available carrier options, and per-unit cost estimates.

## 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-rates-api-be8999c7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tradepulse.theaslangroupllc.com](https://www.zero.xyz/host/tradepulse.theaslangroupllc.com/llms.txt)
