문서
통화 환산 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",
"rate": "147.23",
"converted": "14723",
"market_session": "open",
"timestamp": "2026-08-22T06:29:39Z",
"stale": false
}반올림
Narwhal은 십진 산술을 사용하고 half-even 반올림으로 대상 통화의 ISO 4217 최소 단위까지 한 번 반올림합니다. 반올림하면 0이 되는 0이 아닌 결과는 대신 짝수 반올림으로 유효 숫자를 최대 다섯 자리까지 유지하며, 0을 덧붙이지 않습니다.
오류
from과 to가 같은 통화이면 400 invalid_pair를 반환합니다. 그 밖의 유효하지 않은 통화나 금액은 400 invalid_query를 반환합니다. 지원하지 않는 통화는 404 currency_not_supported를 반환합니다.