전체 문서 살펴보기

경제활동 참가율 API

관측 기간 하나의 공식 경제활동 참가율을 조회합니다.

economics_get_labour_force_participation REST와 다음을 통해 이용할 수 있습니다 economics_get_labour_force_participation MCP 도구입니다. 두 도구는 동일한 데이터 구조를 반환하고 동일한 월간 할당량을 소비합니다.

엔드포인트 및 요청

REST 엔드포인트
GET /v1/economics/{country}/labour-force-participation
요청 예시
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/labour-force-participation?period=2026-07" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCP 사용 도구 economics_get_labour_force_participation 아래 대응 인수와 함께.

매개변수

이 작업에서 허용되는 기간 형식은 다음입니다 YYYY, YYYY-MM, or YYYY-QN.

이름필수유형의미
country경로 · ISO alpha-3지원되는 대문자 국가 코드 하나입니다: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP 및 USA.
period아니요쿼리 · YYYY, YYYY-MM 또는 YYYY-QN최근 승인된 완전한 발표를 받으려면 생략하고, 하나의 정확한 기간을 지정하려면 전달하세요.

응답

응답 예시
{
  "country": "USA",
  "period": "2026-07",
  "rate": "62.3",
  "unit": "percent",
  "released_on": "2026-08-07"
}
필드유형필수의미
country문자열요청된 대문자 ISO alpha-3 국가 코드입니다.
period문자열반환된 공식 관측 기간입니다.
rate십진 문자열0에서 100 사이의 게시된 백분율입니다.
unit"percent"환율의 단위입니다.
released_on날짜Narwhal 조회 시각이 아닌 공식 발표일입니다.

오류 및 할당량

  • 400 invalid_query — 국가, 기간 또는 필터 형식이 잘못되었습니다.
  • 401 invalid_api_key — Bearer 키가 누락되었거나 거부되었습니다.
  • 404 series_not_found — 요청과 일치하는 승인 관측값이 없습니다.
  • 429 rate_limit_exceeded — 네트워크 또는 계정 단기 제한에 도달했습니다. 다음 이후 재시도하세요 Retry-After.
  • 429 quota_exhausted — 계정이 월간 허용량에 도달했습니다.
  • 503 economics_unavailable — Narwhal이 승인 발표를 안전하게 제공할 수 없습니다.

성공한 데이터 응답만 할당량을 소비합니다. 다음을 확인하세요 모든 오류, 헤더 및 재시도 규칙.

최신성

생략 period Narwhal의 최근 저장 승인 발표를 반환합니다. API 호출은 Narwhal 데이터베이스를 읽으며 공식 제공 기관을 실시간 호출하지 않습니다.

released_on 공식 발표일입니다.

읽기 출처 확인, 검증, 저장된 발표 및 실패한 확인이 작동하는 방법.

현재 공개 베타 데이터 범위

관측 빈도는 각 공식 국가 발표를 따르며 AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP 및 USA에서 월간 또는 분기별일 수 있습니다.

인도네시아, 지역별 경로 및 상품은 공개되지 않습니다. FX는 별도의 경로를 통해 이용할 수 있습니다 FX API.

다음으로 돌아가기 모든 Economics 작업.