첫 Economics 요청 보내기

키를 URL에 넣지 마세요

Narwhal 키를 시크릿 또는 환경 변수로 저장하세요. Authorization 헤더에 Bearer 토큰으로 보내세요. 쿼리 문자열에 넣거나 저장소에 커밋하거나 브라우저 코드에 노출하지 마세요.

CPI 엔드포인트 호출

최근 승인된 완전한 발표를 받으려면 period를 생략하세요.

curl --request GET \
  --url https://api.narwhalapi.com/v1/economics/USA/cpi \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

응답 읽기

응답은 일반적인 data 래퍼가 없는 유형화된 JSON입니다. 클라이언트가 모르게 정밀도를 잃지 않도록 십진 값은 문자열입니다. 누락값은 계속 누락되며 0이 되지 않습니다.

{
  "country": "USA",
  "period": "2026-07",
  "value": "333.918",
  "base_period": "1982-84",
  "base_value": "100",
  "released_on": "2026-08-12"
}

국가 또는 작업 변경

다른 라이브 국가에서 같은 측정값을 요청하려면 USA를 AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD 또는 SGP로 바꾸세요. 인플레이션, 실업률, 경제활동 참가율, GDP, GDP 성장률, 무역, 수출 또는 수입을 요청하려면 cpi를 문서화된 다른 작업 경로로 바꾸세요.

상태와 코드로 오류 처리

400 응답은 요청이 유효하지 않다는 뜻입니다. 401은 API 키가 없거나 유효하지 않다는 뜻입니다. 404는 요청한 경로 또는 시계열을 사용할 수 없다는 뜻입니다. 429는 할당량이 소진되었다는 뜻입니다. 503은 해당 시점에 요청한 데이터나 서비스를 안전하게 제공할 수 없다는 뜻입니다.

오류 본문은 application/problem+json을 사용하며 요청 ID를 포함합니다. 500 및 503 응답은 제한된 백오프로 재시도하세요. 다시 시도하기 전에 400 및 401 응답의 원인을 해결하고, 429는 문서에 명시된 재설정 시점까지 기다린 후 재시도하세요.

REST와 MCP는 동일한 데이터를 사용합니다

MCP 도구는 REST와 동일한 키, 저장된 발표, 응답 스키마 및 데이터 할당량을 사용합니다. 애플리케이션에 맞는 인터페이스를 선택하세요. 기반 경제 데이터는 동일합니다.