Global Economy & Trade

US trade in one month across commodities

Changed on

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

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/census/trade/by-commodity
  • Auth: API key in header x-api-key

Query parameters

flowstring

exports or imports

partnerstring

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

levelstring

HS2, HS4 or HS6

monthstring nullable

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",
    "data_age_days": 8.532,
    "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"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes