Global Economy & Trade

US trade in one month across partners

One month of US exports or imports of one HS code (or all commodities) broken down by partner, largest first. kind picks countries, Census groupings or both.

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

Query parameters

flowstring

exports or imports

commoditystring

'all', or an HS code of 2, 4 or 6 digits (27 = mineral fuels).

monthstring nullable

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

kindstring

country, group or all

Response

One row per partner 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"
    ],
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes

Changed in 2 of the 25 revisions of this API.4

Sep 1, 2026328d061c12ca3See the full diff
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Aug 29, 202618b96293341c1See the full diff
- ○
  endpoint added
  endpoint-added

Full history