Sign in
Global Economy & Trade

US trade in one month across commodities

One month of US exports or imports with one partner (or the world) broken down by HS code at one level (HS2 chapters, HS4 headings, HS6 subheadings), largest first.

get/api/v1/census/trade/by-commodity

Query parameters

flowstring

exports or imports

exports or imports

partnerstring

Partner: 'world', or a Census partner code from /census/trade/partners (5700 = China, 0003 = European Union).

Partner: 'world', or a Census partner code from /census/trade/partners (5700 = China, 0003 = European Union).

levelstring

HS2, HS4 or HS6

HS2, HS4 or HS6

monthstring nullable

Month YYYY-MM (default: the latest published month).

Month YYYY-MM (default: the latest published month).

Response

One row per HS code with the month's value and year-to-date value in USD.

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}

Changes

Changed in 1 of the 22 revisions of this API.1

Of the 22 revisions, 1 has no diff computed.