상품 무역 API

첫 요청

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

응답 예시 예시 응답 · 실제 요청 아님

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

엔드포인트

GET상품 무역/v1/economics/{country}/trade

country: 지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.
period: 수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요.
version_id: 선택 사항인 변경 불가능한 공개 버전입니다. `dataset.published` 또는 `dataset.revised` 이벤트의 `resource_version`을 사용할 수 있으며, 생략하면 현재 승인된 지표를 읽습니다.

MCP · economics_get_trade

API 레퍼런스 →

GET상품 무역 과거 데이터/v1/economics/{country}/trade/observations

country: 지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.
start: 첫 관측 기간이며 해당 기간을 포함합니다. Free와 Basic에서는 시작 기간이 요금제 범위보다 이전이면 범위 내 첫 기간으로 옮깁니다. 이 경우 응답에 start가 포함됩니다.
end: 조회 범위의 마지막 관측 기간이며, 해당 기간도 포함합니다.
limit: 반환할 최대 기간 수입니다. 기본값은 100입니다. 한 페이지에 더 적은 기간이 포함될 수 있으므로 next_cursor를 따라가세요.
cursor: 이전 페이지의 next_cursor입니다.

MCP · economics_get_trade_history

API 레퍼런스 →

과거 데이터

cURL

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

응답 예시 예시 응답 · 실제 요청 아님

{
  "country": "USA",
  "currency": "USD",
  "as_of": "2026-08-12T00:00:00Z",
  "observations": [
    {
      "period": "2026-06",
      "exports": "189000000000",
      "imports": "275000000000"
    }
  ],
  "next_cursor": null
}