EconomicsAPI
Get API key
Get startedIntegrateAPI ReferenceChangelog

trade

Raw trade observations

https://docs.economicsapi.com/endpoints/gettrade
gethttps://api.economicsapi.com/v1/trade

Individual exporter→importer→product→year flows, filtered by reporter, partner, product, flow direction and period.

curl -X GET "https://api.economicsapi.com/v1/trade" \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx"

Authorization

Authorizationstringheaderrequired

Bearer token. API key from your economicsapi dashboard Format: `Bearer sk_live_xxxxxxxxxxxxxxxxxxxx`.

Query parameters

reporterstring | null
partnerstring | null
productstring | null
flowstring | null
fromstring | null
tostring | null
limitintegerdefault 1000

min 1 · max 10000

Response

200Successful Responseapplication/json
dataTradeObservation[]required
request_idstringdefault ""
duration_msintegerdefault 0
401Missing or invalid API keyapplication/json
errorstring
messagestring
request_idstring
422Validation Errorapplication/json
detailValidationError[]
429Rate limit exceededapplication/json
errorstring
messagestring
request_idstring
Response
{
  "data": [
    {
      "exporter": "example",
      "importer": "example",
      "hs6": "example",
      "hs_version": 0,
      "period": "2026-01-01",
      "granularity": "example",
      "value_usd": 0,
      "quantity": 0,
      "quantity_unit": "example"
    }
  ],
  "request_id": "",
  "duration_ms": 0
}