Money supply API
한 국가의 IMF 최신 월별 광의통화를 자국 통화로 조회합니다.
economics_ —REST와 다음 economics_ MCP 도구입니다. 둘 다 같은 데이터 형식을 반환하며 같은 크레딧을 사용합니다.
엔드포인트 및 요청
GET /v1/economics/{country}/money-supplycurl --request GET \
--url "https://api.narwhalapi.com/v1/economics/KWT/money-supply" \
--header "Authorization: Bearer $NARWHAL_API_KEY"MCP에서 사용하는 도구: economics_ —아래의 해당 인수로 호출하세요.
매개변수
이 작업에서 허용되는 기간 형식: YYYY-MM.
| 이름 | 필수 | 유형 | 의미 |
|---|---|---|---|
country | 예 | 경로 · ISO alpha-3 | 지원되는 대문자 국가 코드 1개입니다. 이 작업의 범위 목록을 확인하세요. |
period | 아니요 | 쿼리 · YYYY-MM | 수집·검증이 완료된 최신 발표 데이터를 조회하려면 생략하고, 특정 기간을 조회하려면 해당 기간을 정확히 지정하세요. |
series_ | 아니요 | 쿼리 · UUID | 선택 사항입니다. 이전 응답에서 얻은 시계열 하나의 `series_id`입니다. 생략하면 해당 국가의 기본 시계열을 읽습니다. |
응답
{
"source": {
"publisher": "Country authorities; National Summary Data Pages; European Central Bank; IMF Staff Calculations",
"distributor": "International Monetary Fund"
},
"seasonal_adjustment": "not_seasonally_adjusted",
"aggregate": "broad_money",
"definition_label": "Broad Money",
"period": "2026-08",
"value": "42767544300",
"country": "KWT",
"series_id": "94322188-0436-47b7-b127-01f3f73cfab9",
"unit": "currency",
"currency": "KWD"
}| 필드 | 유형 | 필수 | 의미 |
|---|---|---|---|
source | 객체 | 예 | 수치를 발행한 기관입니다. publisher는 IMF 시계열 메타데이터에 명시된 원래 발행 기관이고, distributor는 Narwhal이 읽어 오는 IMF입니다. 시계열당 전체 이력에 하나의 출처만 있습니다. released_은 없습니다. |
seasonal_ | 문자열 | 예 | Always not_. |
aggregate | 문자열 | 예 | Always broad_. |
definition_ | 문자열 | 예 | IMF 데이터셋에서의 집계 이름: Broad Money. |
period | 문자열 | 예 | 반환된 공식 관측 기간입니다. |
value | 십진수 문자열 | 예 | 월말 광의통화이며, currency의 자국 통화 정수 단위로 표시합니다. |
status | 문자열 | 아니요 | 발행 기관이 표시한 수치에만 포함됩니다: estimated, break_, definition_, break_. 그렇지 않으면 생략됩니다. |
release_ | 문자열 | 아니요 | 발행 기관이 수치를 잠정치로 표시한 경우 preliminary입니다. 그렇지 않으면 생략됩니다. |
country | 문자열 | 예 | 요청된 대문자 ISO alpha-3 국가 코드입니다. |
series_ | 문자열 | 예 | 수치가 나온 시계열입니다. 같은 시계열을 다시 읽으려면 series_로 전달하세요. |
unit | 문자열 | 예 | Always currency. |
currency | ISO 4217 문자열 | 예 | 해당 국가의 자국 통화이며, 예를 들어 KWD입니다. |
API 오류 코드와 크레딧
400 invalid_: A query parameter is unknown or repeated,query countryis not three uppercase letters,series_is not a UUID, orid periodis not a month inYYYY-MMformat.version_,id versionandas_are not accepted on this route.of 401 invalid_: Bearer 키가 누락되었거나 거부되었습니다.api_ key 402 insufficient_: 잔액이 호출 비용에 부족합니다.credits 404 series_: 해당 국가가 이 페이지의 지원 국가 목록에 없거나,not_ found series_가 그 국가의 시계열이 아니거나,id period와 일치하는 관측값이 없습니다. 목록에 없는 국가에는 해당 지표군을 이용할 수 없다는 상세 설명이 반환됩니다. 404는 요금이 부과되지 않습니다.429 rate_: 네트워크 또는 계정의 단기 구간 한도에 도달했습니다.limit_ exceeded Retry-After이후에 다시 시도하세요.503 economics_: Narwhal이 저장된 시계열을 안전하게 제공할 수 없습니다.unavailable
Only a successful data response costs credit. 확인 모든 오류, 헤더 및 재시도 규칙.
최신성
period를 생략하면 저장된 가장 최신 관측값을 반환합니다. 이 API 호출은 Narwhal의 데이터베이스를 읽으며 발행 기관을 실시간으로 호출하지 않습니다. 배포 기관이 표시하는 날짜는 발행 기관의 발표일이 아니므로 응답에 released_이 없습니다.
현재 공개 베타 데이터 범위
4 국가
DOM, KAZ, KWT, MUS
월별이며, 해당 국가 자국 통화의 정수 단위이고 계절 미조정입니다. 광의통화의 정의는 국가마다 다르므로 수준 비교는 한 국가 안에서만 하세요. 국제통화기금(IMF)이 시계열을 배포하며 source.publisher가 원래 발행 기관을 나타냅니다. 기간은 YYYY-MM 형식의 월입니다. 다른 국가는 404 not_를 반환하며 요금이 부과되지 않습니다.
일일 환율을 제공하는 API: 환율 API.
다음으로 돌아가기 모든 경제 데이터 작업.
무료 키로 시작하세요
매달 10달러 상당의 무료 크레딧을 드립니다. 카드는 필요하지 않습니다.매달 10달러 상당의 무료 크레딧. 카드는 필요하지 않습니다.
이 페이지가 도움이 되었나요?