전체 문서 탐색

산업생산 API

한 국가의 최신 월별 산업생산지수를 기준과 출처와 함께 조회합니다.

economics_get_industrial_production —REST와 다음 economics_get_industrial_production MCP 도구입니다. 둘 다 같은 데이터 형식을 반환하며 같은 크레딧을 사용합니다.

엔드포인트 및 요청

REST 엔드포인트
GET /v1/economics/{country}/industrial-production
요청 예시
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/industrial-production" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCP에서 사용하는 도구: economics_get_industrial_production —아래의 해당 인수로 호출하세요.

매개변수

이 작업에서 허용되는 기간 형식: YYYY-MM.

이름필수유형의미
country예경로 · ISO alpha-3지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요.
period아니요쿼리 · YYYY-MM수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요.
series_id아니요쿼리 · UUID선택 사항입니다. 이전 응답에서 얻은 시계열 하나의 `series_id`입니다. 생략하면 해당 국가의 기본 시계열을 읽습니다.

응답

응답 예시
{
  "source": {
    "publisher": "OECD",
    "distributor": "OECD"
  },
  "seasonal_adjustment": "seasonally_and_calendar_adjusted",
  "base_period": "2015",
  "base_value": "100",
  "period": "2026-09",
  "value": "102.9",
  "country": "USA",
  "series_id": "ea690cc4-a528-4c6d-b07a-5ecbdac08575",
  "unit": "index"
}
필드유형필수의미
source객체예수치를 발행한 기관입니다. publisher는 해당 수치를 낸 통계 기관이고, distributor는 Narwhal이 읽어 오는 기관입니다. 시계열당 전체 이력에 하나의 출처만 있습니다. released_on은 없습니다.
seasonal_adjustment문자열예Always seasonally_and_calendar_adjusted.
base_period문자열예지수가 100인 연도: Eurostat 시계열은 2021, OECD 시계열은 2015입니다.
base_value십진수 문자열예기준 연도의 지수 값입니다. 여기서는 모든 시계열이 100입니다.
period문자열예반환된 공식 관측 기간입니다.
value십진수 문자열예지수 수준이며, 기준은 base_period와 base_value에 있습니다. 증가율이 아니라 수준입니다.
status문자열아니요발행 기관이 표시한 수치에만 포함됩니다: estimated, break_in_series, definition_differs, break_in_series_and_definition_differs. 그렇지 않으면 생략됩니다.
release_status문자열아니요발행 기관이 수치를 잠정치로 표시한 경우 preliminary입니다. 그렇지 않으면 생략됩니다.
country문자열예요청된 대문자 ISO alpha-3 국가 코드입니다.
series_id문자열예수치가 나온 시계열입니다. 같은 시계열을 다시 읽으려면 series_id로 전달하세요.
unit문자열예Always index.

API 오류 코드와 크레딧

  • 400 invalid_query: A query parameter is unknown or repeated, country is not three uppercase letters, series_id is not a UUID, or period is not a month in YYYY-MM format. version_id, version and as_of are not accepted on this route.
  • 401 invalid_api_key: Bearer 키가 누락되었거나 거부되었습니다.
  • 402 insufficient_credits: 잔액이 호출 비용에 부족합니다.
  • 404 series_not_found: 해당 국가가 이 페이지의 지원 국가 목록에 없거나, series_id가 그 국가의 시계열이 아니거나, period와 일치하는 관측값이 없습니다. 목록에 없는 국가에는 해당 지표군을 이용할 수 없다는 상세 설명이 반환됩니다. 404는 요금이 부과되지 않습니다.
  • 429 rate_limit_exceeded: 네트워크 또는 계정의 단기 구간 한도에 도달했습니다. Retry-After 이후에 다시 시도하세요.
  • 503 economics_unavailable: Narwhal이 저장된 시계열을 안전하게 제공할 수 없습니다.

Only a successful data response costs credit. 확인 모든 오류, 헤더 및 재시도 규칙.

최신성

period를 생략하면 저장된 가장 최신 관측값을 반환합니다. 이 API 호출은 Narwhal의 데이터베이스를 읽으며 발행 기관을 실시간으로 호출하지 않습니다. 배포 기관이 표시하는 날짜는 발행 기관의 발표일이 아니므로 응답에 released_on이 없습니다.

읽기 출처 확인, 검증, 발표 데이터 저장 및 확인 실패 시 처리 방식.

현재 공개 베타 데이터 범위

15 국가

BEL, BGR, BRA, CHL, CZE, EST, FIN, FRA, HRV, IRL, ITA, KOR, SVN, SWE, USA

월별 지수 수준이며 달력 조정 및 계절 조정이 되어 있습니다. Eurostat 시계열은 2021=100, OECD 시계열은 2015=100을 사용하며, 국가가 어느 쪽인지는 source와 base_period에 나옵니다. 기준은 국가마다 다르므로 수준 비교는 한 국가 안에서만 하세요. 기간은 YYYY-MM 형식의 월입니다. 다른 국가는 404 not_found를 반환하며 요금이 부과되지 않습니다.

일일 환율을 제공하는 API: 환율 API.

다음으로 돌아가기 모든 경제 데이터 작업.

이 페이지가 도움이 되었나요?