Global Economy & Trade

US trade in one month across customs ports

Changed on

One month of US exports or imports of one HS code (or all commodities) with one partner (or the world), broken down by customs port of lading (exports) or unlading (imports). PORT is the Census 4-character Schedule D/K code, not a UN/LOCODE and not an IMF PortWatch port.

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

Request

  • Base URL
    https://sugra.ai
  • URL
    https://sugra.ai/api/v1/census/trade/by-port
  • 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).

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).

Response

One row per customs port, largest value first.

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).",
    "source_url": "https://fred.stlouisfed.org/series/UNRATE",
    "citation": "Federal Reserve Bank of St. Louis (FRED) - Unemployment Rate (UNRATE) - https://fred.stlouisfed.org/series/UNRATE - retrieved 2026-11-02",
    "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

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • breaking

      removed the required property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      the response property became required for the status

    • info

      response property detail list-of-types was narrowed by removing types null from media type application/json of response 429

    This list may be incomplete.