상품 수입 API

국가와 기간 하나의 상품 수입 합계를 조회합니다.

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

엔드포인트 및 요청

REST 엔드포인트

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

요청 예시

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

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

REST는 다음을 전송합니다 product 및 classification 별도의 쿼리 매개변수로 사용합니다. MCP는 이를 하나의 다음에 중첩합니다 product 객체:

MCP 필터 무역 인수

{
  "country": "USA",
  "period": "2026-06",
  "partner": "CAN",
  "product": {
    "classification": "HS2022",
    "code": "27"
  }
}

매개변수

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

이름	필수	유형	의미
`country`	예	경로 · ISO alpha-3	지원되는 대문자 국가 코드 하나입니다: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP 및 USA.
`period`	아니요	쿼리 · YYYY 또는 YYYY-MM	최근 승인된 완전한 발표를 받으려면 생략하고, 하나의 정확한 기간을 지정하려면 전달하세요.
`partner`	아니요	쿼리 · ISO alpha-3	계약상 승인되었지만 현재 베타에서는 파트너별 필터 합계를 게시하지 않습니다.
`product`	아니요	쿼리 · 2, 4 또는 6자리	HS 상품 코드입니다. 분류 정보와 함께 제공하십시오.
`classification`	아니요	쿼리 · HSYYYY	통일상품분류체계 판입니다. product와 함께 제공하세요.

응답

응답 예시

{
  "country": "USA",
  "period": "2026-06",
  "flow": "import",
  "value": "275000000000",
  "currency": "USD",
  "coverage": "merchandise",
  "partner": null,
  "product": null,
  "released_on": "2026-08-04"
}

필드	유형	필수	의미
`country`	문자열	예	요청된 대문자 ISO alpha-3 국가 코드입니다.
`period`	문자열	예	반환된 공식 관측 기간입니다.
`flow`	"export" 또는 "import"	예	경로가 지정한 상품 무역 방향입니다.
`value`	십진 문자열	예	선택한 방향의 금전 값입니다.
`currency`	ISO 4217 문자열	예	금전 값의 통화입니다.
`coverage`	"merchandise"	예	서비스 무역이 포함되지 않는지 확인합니다.
`partner`	ISO alpha-3 문자열 또는 null	아니요	있는 경우 요청된 상대국 필터입니다. 공개 비필터 합계에서는 null이거나 생략될 수 있습니다.
`product`	객체 또는 null	아니요	있는 경우 요청된 HS 분류 및 제품 코드입니다. 공개 비필터 합계에서는 null이거나 생략될 수 있습니다.
`released_on`	날짜	예	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에 대해 공개됩니다. 상대국 및 제품 필터는 계약상 허용되지만 필터 합계가 게시될 때까지 404를 반환합니다.

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

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

엔드포인트 및 요청

매개변수

응답

오류 및 할당량

최신성

현재 공개 베타 데이터 범위