현재 환율 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개 목록입니다. 지원되는 모든 상대 통화를 사용하려면 생략하세요. |
응답
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 주말 응답도 타임스탬프와 오래됨 상태가 명확하면 계속 사용할 수 있습니다.
오류
400 invalid_query · 401 invalid_api_key · 404 currency_not_supported · 429 quota_exhausted · 503 upstream_unavailable