과거 환율 API

요청

curl --request GET \
  --url "https://api.narwhalapi.com/v1/fx/rates/USD/observations?currencies=EUR,NZD&start_date=2026-08-20&end_date=2026-08-28&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCP 도구는 다음입니다 fx_get_rate_history 해당 항목의 currencies 입력은 JSON 배열이며 다른 모든 필드는 동일한 의미를 가집니다.

응답

{
  "base": "USD",
  "start_date": "2026-08-20",
  "end_date": "2026-08-28",
  "observations": [
    {
      "date": "2026-08-20",
      "rates": [
        { "currency": "EUR", "rate": "0.85609" },
        { "currency": "NZD", "rate": "1.681" }
      ]
    },
    {
      "date": "2026-08-21",
      "rates": [
        { "currency": "EUR", "rate": "0.85477" },
        { "currency": "NZD", "rate": "1.6714" }
      ]
    },
    {
      "date": "2026-08-24",
      "rates": [{ "currency": "EUR", "rate": "0.85734" }]
    }
  ],
  "next_cursor": null,
  "has_more": false
}

각 환율은 십진 문자열입니다. 1단위의 base 반환된 다음 금액과 같습니다 currency 해당 관측 날짜에.

페이지 매김

limit 날짜를 세므로 한 페이지가 한 날짜의 통화 레코드를 나누지 않습니다. 다음 경우 has_more true이면 다음을 전달하세요 next_cursor 동일한 기준 통화, 통화 목록, 시작일 및 종료일로 돌아가세요. 커서는 필터에 연결되며 값을 변경하면 다음을 반환합니다 400 invalid_cursor.

전체 날짜 범위 제한은 없습니다. 전체 과거 데이터 백필은 다음까지 동일한 제한 페이지를 반복 사용합니다 next_cursor null입니다.

누락된 날짜와 통화는 만들어내지 않습니다

실제로 저장된 관측 날짜만 표시됩니다. 주말, 공휴일 및 기타 누락된 발표 날짜는 생략됩니다. Narwhal은 이를 전방 채우기하지 않습니다.

날짜에는 요청한 통화의 일부만 포함될 수 있습니다. 예에서 NZD에는 8월 24일 레코드가 없지만 EUR에는 있습니다. 이는 부분 응답 오류가 아니라 사실에 맞는 희소 관측값입니다.

오류

• 400 invalid_query 잘못된 통화, 날짜 또는 페이지 크기에 대해.
• 400 invalid_cursor 형식이 잘못되었거나 필터가 일치하지 않는 페이지 매김 상태에 대해.
• 401 invalid_api_key 누락되었거나 잘못된 Bearer 키에 대해.
• 404 currency_not_supported 선택한 통화를 이용할 수 없을 때.
• 429 rate_limit_exceeded 단기 구간 제한에 도달했을 때; 다음을 기다리세요 Retry-After 재시도하기 전에.
• 429 quota_exhausted 공유 월간 할당량이 소진되었을 때.
• 503 upstream_unavailable 승인된 과거 데이터를 안전하게 읽을 수 없을 때.

다음 확인 오류 및 제한 가이드 두 가지 속도 제한 헤더 계열과 재시도 동작에 대해.

데이터 범위 및 제한

통화별로 데이터 범위의 시작일이 다릅니다. 지원되는 저장 시계열 중 가장 이른 것은 1971년에 시작하며, 대부분의 일일 데이터 범위는 1999년 또는 2000년에 시작합니다. 이 계약을 변경하지 않고도 데이터 범위가 확장될 수 있습니다.

이 인터페이스는 이전 발표 버전 전체가 아닌 현재 승인된 과거 시계열을 반환합니다. 출처, 제공자, 라이선스, 산출 과정, 오래됨 및 시장 세션 필드는 생략합니다. 다음을 읽으세요 FX 방법론 공개 데이터 정책과 다음에 대해 FX 제품 페이지 모든 라이브 작업에 대해.