무역 데이터 제공 범위 경로 API 레퍼런스
국가별로 어느 출처가 무역 경로에 응답하는지, 무엇을 보유하는지, 어느 월부터 어느 월까지인지 읽습니다.
개요
GET /
GET /는 국가마다 행 하나를 반환합니다. 상대국 경로와 품목 경로에 누가 응답하는지, 현재 응답하는 출처, 보유한 모든 출처, 보유한 월입니다. 무역 국가 페이지가 일반적으로 답하는 질문에 대한 실시간 답입니다.
한 국가를 기반으로 개발하기 전에 호출하세요. answers_는 basis 없는 요청이 현재 응답받는 출처이고, tiers_는 행을 가진 모든 basis 값을 나열합니다. 행 하나만 받으려면 country를 보내고, 모든 국가를 받으려면 생략하세요. 이 호출은 무료입니다. MCP 도구는 trade_이며 동일한 매개변수를 받습니다.
요청
영국의 제공 범위와 실제 응답:
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/trade/coverage?country=GBR"{
"countries": [
{
"country": "GBR",
"partners_tier": "own",
"partner_coverage": "all",
"products_tier": "own",
"answers_with": "own",
"tiers_held": [
"own",
"partner_reported"
],
"first_period": "2010-01",
"latest_period": "2026-09",
"comtrade_latest_period": "2026-08",
"third_party_latest_period": null,
"comtrade_periods": 200,
"comtrade_latest_year": 2025,
"has_headline": true,
"has_services": true,
"has_tariff_book": true
}
]
}영국의 자국 기관이 응답하며(answers_는 own) 품목을 보유합니다(products_는 own). first_와 latest_는 해당 기관에서 보유한 월입니다.
매개변수
| 매개변수 | 위치 | 유형 | 필수 | 기본값 | 허용 값과 의미 |
|---|---|---|---|---|---|
country | 쿼리 | 문자열 | 아니요 | 모든 국가 | 대문자 ISO 3166-1 alpha-3 코드 하나, 또는 유로 지역을 뜻하는 EMU. 생략하면 응답에 국가마다 행 하나가 있습니다. 국가가 아닌 코드는 400을 반환하고, 행이 없는 국가는 404를 반환합니다. |
응답
응답에는 목록인 countries 필드 하나가 있습니다. 각 항목에는 다음 필드가 있습니다.
| 필드 | 의미 |
|---|---|
country | 국가, 또는 유로 지역을 뜻하는 EMU. |
partners_ | Narwhal이 직접 보유한 자료를 기준으로 상대국 경로에 누가 응답하는지: own은 해당 국가의 관세청 또는 통계청이고, partner_는 Narwhal이 해당 국가 자국 기관의 수치를 보유하지 않을 때 수출입 방향을 맞바꾼 다른 국가의 보고 자료입니다. |
partner_ | all은 모든 상대국이 나열된 경우, top_은 발행 기관이 상위 상대국과 기타 행 1개만 게재하는 경우입니다. partners_가 partner_이면 null. |
products_ | 품목 경로에 누가 응답하는지: own, 또는 해당 국가에 자체 품목 파일이 없으면 partner_. UN Comtrade는 상대국 합계만 보유하므로 품목별로는 응답하지 않습니다. |
answers_ | 상대국 경로와 품목 경로가 현재 응답하는 출처이며, 순서는 다음과 같습니다. 해당 국가의 자국 기관(own), UN Comtrade 제출 자료(third_), 다른 국가의 보고 자료(partner_, 공식 수치가 아님). 다른 국가의 보고는 해당 국가에 대해 행을 가진 보고국이 200곳 이상일 때만 UN Comtrade보다 앞서는데, 이는 Narwhal이 보유한 수보다 많으므로 가장 마지막에 옵니다. 류별로는 UN Comtrade에 자료가 없으므로 partner_가 응답합니다. Narwhal이 해당 국가의 자료를 보유하지 않는 동안은 null. |
tiers_ | 현재 행이 있는 모든 출처: 이 국가에 응답하는 basis 값. |
first_ | Narwhal이 해당 국가의 자국 기관에서 보유한 첫 월. 없으면 null. |
latest_ | Narwhal이 해당 국가의 자국 기관에서 보유한 가장 최신 월. 없으면 null. |
comtrade_ | 해당 국가가 UN Comtrade에 제출한 가장 최신 월. 없으면 null. |
third_ | Narwhal이 해당 국가에 대해 UN Comtrade에서 보유한 가장 최신 월. 없으면 null. |
comtrade_ | 해당 국가가 UN Comtrade에 제출한 월 수. |
comtrade_ | 해당 국가가 UN Comtrade에 제출한 가장 최근 연도. |
has_ | 해당 국가가 월간 상품 무역 헤드라인 합계를 발표하면 true. |
has_ | 해당 국가가 서비스 무역을 발표하면 true. |
has_ | 국가 관세율표를 이용할 수 있으면 true. |
추가 예시
자국 기관이 상대국 합계만 제공하는 국가
자국 기관이 상대국 합계만 제공하는 캐나다:
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/trade/coverage?country=CAN"{
"countries": [
{
"country": "CAN",
"partners_tier": "own",
"partner_coverage": "top_n",
"products_tier": "partner_reported",
"answers_with": "own",
"tiers_held": [
"own",
"partner_reported"
],
"first_period": "2010-01",
"latest_period": "2026-09",
"comtrade_latest_period": "2026-08",
"third_party_latest_period": null,
"comtrade_periods": 200,
"comtrade_latest_year": 2025,
"has_headline": true,
"has_services": true,
"has_tariff_book": true
}
]
}partners_는 own이고 products_는 partner_입니다. 캐나다의 상대국 데이터는 캐나다 통계청(Statistics Canada)에서, 류별 품목 데이터는 다른 국가의 보고 자료에서 나옵니다.
제공 범위에 없는 국가
수치가 없는 실제 국가 코드는 404를 반환하며 무료입니다:
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/trade/coverage?country=ATA"{
"type": "https://narwhalapi.com/problems/country-not-covered",
"title": "Country not covered",
"status": 404,
"detail": "ATA is not in the trade coverage list.",
"code": "country_not_covered",
"request_id": "c16523b6-7d27-4e1b-a2c3-f7e2acead523"
}출처
이 경로는 출처를 보고하며 하나를 선택하지는 않습니다. 각 출처가 무엇이고 언제 응답하는지는 무역 국가 페이지를 참고하세요.
통화
이 경로는 값을 반환하지 않으므로 적용되는 통화가 없습니다.
페이징
이 경로에는 페이징이 없습니다. country 없이 요청하면 모든 국가를 한 응답으로 반환합니다.
가격
이 경로는 무료입니다. 호출에 요금이 부과되지 않지만 계정에는 여전히 키가 필요합니다.
오류
이 오류는 request_가 포함된 공통 problem 형식을 사용합니다. 키가 없거나 유효하지 않은 경우(401), 잔액이 호출 요금보다 적은 경우(402), 분당 요청이 너무 많은 경우(429)는 모든 경로가 공통으로 가지는 계정 오류입니다. 자세한 내용은 API 오류 코드와 크레딧을 참고하세요.
| 상태 | 코드 | 발생 조건 |
|---|---|---|
400 | invalid_query | country가 국가 코드가 아닙니다. |
404 | country_not_covered | Narwhal은 어떤 출처에서도 해당 국가의 무역 행을 보유하고 있지 않습니다. |
이 페이지가 도움이 되었나요?