통화 변환 API
선택한 하나의 환율로 양의 십진 금액 하나를 변환합니다.
REST 및 fx_convert_currency 동일한 금액, 환율, 결과, 타임스탬프, 최신성 및 시장 세션을 반환합니다.
요청
REST
curl --request GET \
--url "https://api.narwhalapi.com/v1/fx/convert?from=USD&to=JPY&amount=100.00" \
--header "Authorization: Bearer $NARWHAL_API_KEY"| 매개변수 | 규칙 |
|---|---|
from | 필수 출처 통화입니다. |
to | 필수 대상 통화입니다. 다음과 달라야 합니다 from. |
amount | 다음까지의 양의 십진 문자열 1000000000000. |
응답
200 OK
{
"from": "USD",
"to": "JPY",
"amount": "100.00",
"rate": "147.23",
"converted": "14723",
"market_session": "open",
"timestamp": "2026-08-22T06:29:39Z",
"stale": false
}반올림
Narwhal은 십진 산술을 사용하고 half-even 반올림으로 대상 통화의 ISO 4217 최소 단위까지 한 번 반올림합니다.
오류
잘못된 통화쌍 또는 금액은 다음을 반환합니다 400 invalid_query 지원되지 않는 통화는 다음을 반환합니다: 404 currency_not_supported.