상품 무역 과거 데이터 API

국가 하나의 현재 승인 상품 무역 시계열을 조회합니다.

economics_get_trade_history REST와 다음을 통해 이용할 수 있습니다 economics_get_trade_history MCP 도구입니다. 두 도구는 동일한 데이터 구조를 반환하고 동일한 월간 할당량을 소비합니다.

엔드포인트 및 요청

REST 엔드포인트

GET /v1/economics/{country}/trade/observations

요청 예시

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

MCP 사용 도구 economics_get_trade_history 아래 대응 인수와 함께.

매개변수

이 작업에서 허용되는 기간 형식은 다음입니다 YYYY-MM.

이름	필수	유형	의미
`country`	예	경로 · ISO alpha-3	지원되는 대문자 국가 코드 하나입니다: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP 및 USA.
`start`	아니요	쿼리 · YYYY-MM	최초 관측 기간을 포함합니다.
`end`	아니요	쿼리 · YYYY-MM	최종 관측 기간을 포함합니다.
`limit`	아니요	쿼리 · 정수, 1~1000	반환할 최대 관측값 수입니다. 기본값은 100입니다.
`cursor`	아니요	쿼리 · 불투명 문자열	이전 페이지의 next_cursor입니다.

응답

응답 예시

{
  "observations": [
    {
      "country": "USA",
      "measure": "trade_exports",
      "value": "189000000000",
      "unit": "USD",
      "transformation": "",
      "period": "2026-06"
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T16:00:00Z"
}

필드	유형	필수	의미
`observations`	배열	예	승인된 관측값을 오래된 순으로 제공합니다. 누락된 출처 값은 채우지 않고 생략합니다.
`observations[].country`	문자열	예	요청된 대문자 ISO alpha-3 국가 코드입니다.
`observations[].measure`	문자열	예	이 관측값이 나타내는 표준 측정값입니다.
`observations[].period`	문자열	예	관측값이 나타내는 공식 월 또는 분기입니다.
`observations[].value`	십진 문자열	예	이진 부동소수점 변환 없는 승인 출처 값입니다.
`observations[].unit`	문자열	예	측정값의 출처 단위 또는 통화 코드입니다.
`observations[].transformation`	문자열	예	측정값 변환이며 수준값인 경우 빈 문자열입니다.
`next_cursor`	문자열 또는 null	아니요	다음 페이지를 읽을 때 이 값을 변경하지 않고 cursor로 전달하세요.
`as_of`	RFC 3339 타임스탬프	아니요	Narwhal이 현재 저장된 시계열 스냅샷을 승인한 시점입니다.

오류 및 할당량

400 invalid_query — 국가, 기간 또는 필터 형식이 잘못되었습니다.
401 invalid_api_key — Bearer 키가 누락되었거나 거부되었습니다.
404 series_not_found — 요청과 일치하는 승인 관측값이 없습니다.
429 rate_limit_exceeded — 네트워크 또는 계정 단기 제한에 도달했습니다. 다음 이후 재시도하세요 Retry-After.
429 quota_exhausted — 계정이 월간 허용량에 도달했습니다.
503 economics_unavailable — Narwhal이 승인 발표를 안전하게 제공할 수 없습니다.

성공한 데이터 응답만 할당량을 소비합니다. 다음을 확인하세요 모든 오류, 헤더 및 재시도 규칙.

현재 공개 베타 데이터 범위

AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP 및 USA의 사용 가능한 공식 이력은 공개되어 있습니다. 최초 사용 가능 기간은 소스마다 다릅니다.

인도네시아, 지역별 경로 및 상품은 공개되지 않습니다. FX는 별도의 경로를 통해 이용할 수 있습니다 FX API.

다음으로 돌아가기 모든 Economics 작업.

엔드포인트 및 요청

매개변수

응답

오류 및 할당량

최신성

현재 공개 베타 데이터 범위