모든 API

국내총생산(GDP) API

공식 기관이 발표한 자국 통화 기준 분기별 GDP.

첫 요청

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

응답 예시 예시 응답 · 라이브 요청 아님

{
  "country": "USA",
  "period": "2026-Q2",
  "value": "31000100000000",
  "currency": "USD",
  "price_basis": "current",
  "seasonal_adjustment": "seasonally_adjusted",
  "annualization": "annualized",
  "released_on": "2026-07-30"
}

엔드포인트

GET국내총생산/v1/economics/{country}/gdp

country: 지원되는 대문자 국가 코드 하나입니다: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP 및 USA.
period: 최근 승인된 완전한 발표를 받으려면 생략하고, 하나의 정확한 기간을 지정하려면 전달하세요.

MCP · economics_get_gdp

API 레퍼런스 →

GET국내총생산 과거 데이터/v1/economics/{country}/gdp/observations

country: 지원되는 대문자 국가 코드 하나입니다: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP 및 USA.
start: 최초 관측 기간을 포함합니다.
end: 최종 관측 기간을 포함합니다.
limit: 반환할 최대 관측값 수입니다. 기본값은 100입니다.
cursor: 이전 페이지의 next_cursor입니다.

MCP · economics_get_gdp_history

API 레퍼런스 →

과거 데이터

cURL

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

응답 예시 예시 응답 · 라이브 요청 아님

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