Global Economy & Trade

US trade in one month across partners

Changed on

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

Request

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

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"
    ],
    "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