All APIs

Merchandise trade API

Query official merchandise trade statistics by country through REST or MCP. Retrieve the latest accepted value, an exact period or dated history.

First request

Quickstart →

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/trade?period=2026-06" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

Example response Illustrative response · not a live request

{
  "country": "USA",
  "period": "2026-06",
  "exports": "189000000000",
  "imports": "275000000000",
  "balance": "-86000000000",
  "currency": "USD",
  "coverage": "merchandise",
  "released_on": "2026-08-04"
}

Endpoints

GETMerchandise trade/v1/economics/{country}/trade

Retrieve exports, imports, and the exact merchandise-trade balance for one period.

country: One supported uppercase country code; see this operation’s coverage list.
period: Omit it for the latest accepted complete release, or pass one exact period.

MCP · economics_get_trade

API reference →History →

GETMerchandise exports/v1/economics/{country}/trade/exports

Retrieve the merchandise-export total for one country and period.

country: One supported uppercase country code; see this operation’s coverage list.
period: Omit it for the latest accepted complete release, or pass one exact period.
partner: Accepted by the contract, but filtered partner totals are not published in the current beta.
product: An HS product code. Supply it together with classification.
classification: The Harmonized System edition. Supply it together with product.

MCP · economics_get_trade_exports

API reference →History →

GETMerchandise imports/v1/economics/{country}/trade/imports

Retrieve the merchandise-import total for one country and period.

country: One supported uppercase country code; see this operation’s coverage list.
period: Omit it for the latest accepted complete release, or pass one exact period.
partner: Accepted by the contract, but filtered partner totals are not published in the current beta.
product: An HS product code. Supply it together with classification.
classification: The Harmonized System edition. Supply it together with product.

MCP · economics_get_trade_imports

API reference →History →