API로 경제지표 캘린더 직접 만들기
선택한 국가와 날짜의 발표 시각을 UTC로 나열합니다.
가이드 읽기 →모든 API
국제 무역 통계 API
무역 통계 API로 국가별 공식 상품 무역 통계를 REST 또는 MCP로 조회합니다. 최신 승인값, 정확한 기간, 날짜별 이력을 가져올 수 있습니다.
첫 요청
최신 값 가져오기
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/USA/trade?period=2026-06" \
--header "Authorization: Bearer $NARWHAL_API_KEY"엔드포인트
GET상품 무역/v1/economics/{country}/trade
한 기간의 수출액, 수입액, 정확한 상품 무역수지를 조회합니다. 서비스는 제외됩니다.
매개변수
country필수지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.
period선택수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요.
version_id선택선택 사항인 불변 게시 버전입니다. dataset.published 또는 dataset.revised 이벤트의 resource_version을 쓰세요. 생략하면 현재 승인된 지표를 읽습니다.
응답 필드
country문자열요청된 대문자 ISO alpha-3 국가 코드입니다.
period문자열반환된 공식 관측 기간입니다.
exports음이 아닌 십진수 문자열상품 수출 총액입니다.
imports음이 아닌 십진수 문자열상품 수입 총액입니다.
balance십진수 문자열수출에서 수입을 뺀 정확한 값이며 음수일 수 있습니다.
currencyISO 4217 문자열세 금액에 공통으로 적용되는 통화입니다.
released_on날짜Narwhal 조회 시각이 아닌 공식 발표일입니다.
source객체선택 사항인 source 객체는 통계가 배포 기관을 통해 들어온 경우에만 나타납니다. publisher(배포 기관이 밝힌 원 발표 기관)와 distributor(배포한 조직)를 담고 있습니다. source가 있으면 released_on은 배포 기관의 공표일이며 원 발표 기관의 발표일이 아닙니다. 발표 기관에서 직접 받은 시리즈에는 source가 없습니다.
전체 레퍼런스 →
GET상품 무역 과거 데이터/v1/economics/{country}/trade/observations
특정 국가의 현재 승인된 상품 무역 시계열을 조회합니다.
매개변수
country필수지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.
start선택조회 범위의 첫 관측 기간이며, 해당 기간도 포함합니다.
end선택조회 범위의 마지막 관측 기간이며, 해당 기간도 포함합니다.
limit선택반환할 최대 기간 수입니다. 기본값은 100입니다. 한 페이지에 더 적은 기간이 포함될 수 있으므로 next_cursor를 따라가세요.
cursor선택이전 페이지의 next_cursor입니다.
version선택first_reported만 받습니다. 각 기간에 처음 저장된 값을 first_reported_at과 함께 반환합니다. as_of와 함께 쓸 수 없습니다.
as_of선택지정한 UTC 날짜가 끝날 때까지 공표된 그대로의 시리즈를 반환합니다. version과 함께 쓸 수 없습니다.
응답 필드
country문자열요청한 대문자 ISO alpha-3 국가 코드입니다. 관측값마다가 아니라 페이지당 한 번 반환합니다.
start문자열Narwhal이 요청한 start를 더 뒤의 기간으로 옮긴 경우에만 포함됩니다. 그보다 이전 기간은 반환하지 않습니다.
as_ofRFC 3339 타임스탬프이 페이지의 가장 최근 관측값을 소스가 마지막으로 갱신한 시각입니다. UTC 기준이며 소수점 이하 초는 없습니다.
source객체유통업체를 통해 받은 통계의 출처 정보입니다. 최신 값 조회 작업을 참조하세요.
currencyISO 4217 문자열페이지의 모든 값에 적용되는 통화입니다.
observations배열채택된 관측값을 오래된 순서로 기간당 하나씩 반환합니다. 소스에 없는 값은 생략하며 채워 넣지 않습니다. 한 페이지의 관측값 수가 limit보다 적을 수 있으므로 next_cursor가 null이 될 때까지 따라가세요.
observations[].period문자열관측값이 나타내는 공식 월 또는 분기입니다.
observations[].first_reported_atRFC 3339 타임스탬프version=first_reported일 때만 나타납니다. 이 UTC 타임스탬프는 Narwhal이 해당 기간을 처음 저장한 시각입니다(지표가 따로 저장된 경우 가장 늦은 시각). 수집을 시작하기 전에 발표된 기간에는 Narwhal의 첫 수집 시각이 들어갑니다.
observations[].exports십진수 문자열해당 기간의 상품 수출액입니다. 해당 기간의 값이 없으면 생략합니다.
observations[].imports십진수 문자열해당 기간의 상품 수입액입니다. 해당 기간의 값이 없으면 생략합니다.
next_cursor문자열 또는 null다음 페이지를 읽으려면 이 값을 변경하지 않고 cursor로 전달하세요. 마지막 페이지에서는 null입니다.
전체 레퍼런스 →
활용 사례
데이터 범위
지표
국가
출처
- 호주호주 통계청(ABS)
- 오스트리아오스트리아 통계청, 유로스타트(Eurostat)
- 벨기에Statbel, 벨기에 국립은행, Eurostat
- 캐나다캐나다 통계청
- 칠레칠레 중앙은행(BCCh), 칠레 국가통계원(INE)
- 콜롬비아국가통계행정부(DANE)
- 체코체코 통계청(ČSÚ)
- 독일독일 연방통계청(Destatis)
- 덴마크덴마크 통계청, 유로스타트(Eurostat)
- 스페인스페인 국가통계원(INE), 스페인 국세청(AEAT)
- 에스토니아Statistics Estonia
- 핀란드Statistics Finland, 핀란드 관세청(Tulli)
출처 35개 모두 보기
- 프랑스국립통계경제연구소(INSEE), 프랑스 관세청
- 영국국가통계청(ONS)
- 크로아티아크로아티아 통계청(CBS)
- 아일랜드Central Statistics Office (CSO)
- 이탈리아이탈리아 국립통계원(Istat), Eurostat
- 일본일본 통계국, 일본 내각부, 일본 세관
- 리투아니아리투아니아 국가데이터청
- 룩셈부르크STATEC, 유로스타트(Eurostat)
- 라트비아라트비아 중앙통계국(CSB)
- 멕시코국립통계지리정보원(INEGI)
- 말레이시아말레이시아 통계청(DOSM)
- 네덜란드네덜란드 통계청(CBS)
- 노르웨이Statistics Norway(SSB)
- 뉴질랜드Stats NZ
- 파키스탄파키스탄 통계국(PBS)
- 필리핀필리핀 통계청(PSA)
- 폴란드폴란드 통계청, 유로스타트(Eurostat)
- 포르투갈Statistics Portugal(INE)
- 사우디아라비아통계청(GASTAT)
- 싱가포르싱가포르 통계청(SingStat), 싱가포르 정부 공개 데이터 발표
- 슬로베니아슬로베니아 공화국 통계청(SURS)
- 스웨덴Statistics Sweden(SCB)
- 미국노동통계국(BLS), 경제분석국(BEA), 미국 인구조사국
관련 API
자주 묻는 질문
어떤 종류의 무역을 다루나요?
이 유형은 각국 발표 기관의 공식 상품 무역 통계를 다룹니다.
정확한 기간의 무역 데이터를 요청할 수 있나요?
네. API는 정확한 기간 요청, 날짜별 이력, 최신 승인 값을 지원합니다.
MCP로 무역 데이터에 접근할 수 있나요?
네. 무역 데이터는 같은 API 키로 MCP와 REST에서 사용할 수 있습니다.
무료 키로 시작하세요
12개월 동안 매달 10달러 상당의 무료 크레딧을 드립니다. 카드는 필요하지 않습니다.매달 10달러 상당의 무료 크레딧. 카드는 필요하지 않습니다.