문서
현재 환율 API
기준 통화와 상대 통화별 현재 환율을 요청합니다.
반환되는 각 환율은 기준 통화 1단위에 해당하는 상대 통화의 금액입니다. REST 및 fx_get_rates 모두 동일한 스키마를 사용합니다.
요청
REST
curl --request GET \
--url "https://api.narwhalapi.com/v1/fx/rates/USD?currencies=EUR,JPY" \
--header "Authorization: Bearer $NARWHAL_API_KEY"| 매개변수 | 규칙 |
|---|---|
base | 유통 중인 통화의 대문자 ISO 4217 코드를 반드시 지정해야 합니다. |
currencies | 선택 사항인 쉼표 구분 목록으로, 중복 없는 상대 통화 1–64개를 지정합니다. 기준 통화는 목록에 포함할 수 없습니다. 생략하면 지원하는 모든 상대 통화를 반환합니다. MCP 도구는 JSON 배열을 받습니다. |
응답
200 OK
{
"base": "USD",
"market_session": "open",
"rates": [
{
"currency": "EUR",
"rate": "0.9200",
"timestamp": "2026-08-22T06:29:41Z",
"stale": false
},
{
"currency": "JPY",
"rate": "147.23",
"timestamp": "2026-08-22T06:29:39Z",
"stale": false
}
]
}환율은 동적 키가 아닌 정렬된 레코드로 반환됩니다. 각 환율에는 고유한 타임스탬프와 데이터가 오래되었는지 여부가 포함됩니다.
최신성
market_session 다음입니다 open, weekend, 또는 interbank_closed. 주말 응답도 타임스탬프와 데이터가 오래되었는지 여부가 명확하면 계속 사용할 수 있습니다.
Free에서는 오늘 00:00 UTC 기준의 전일 마감 환율을 제공합니다. Basic 및 Pro에서는 실시간 환율을 제공합니다. 두 요금제의 가격 스트림은 각 환율이 변경될 때 동일한 형식으로 전송합니다. 가격 스트림 레퍼런스
오류
400 invalid_query · 401 invalid_api_key · 404 currency_not_supported · 429 rate_limit_exceeded · 429 quota_exhausted · 503 upstream_unavailable
통화 코드 형식이 잘못되면 400을 반환합니다. 형식은 올바르지만 Narwhal이 제공하지 않는 통화 코드는 404를 반환합니다.