US trade in one month across customs ports
Changed onOne 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.
Request
- Base URLhttps://sugra.ai
- URLhttps://sugra.ai/api/v1/census/trade/by-port
- AuthAPI key in header x-api-key
Query parameters
exports or imports
Partner: 'world', or a Census partner code from /census/trade/partners (5700 = China, 0003 = European Union).
'all', or an HS code of 2, 4 or 6 digits (27 = mineral fuels).
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
- info
- 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
detaillist-of-types was narrowed by removing typesnullfrom media typeapplication/jsonof response429
This list may be incomplete.
- breaking