ドキュメント /

APIリファレンス

認証、制限、鮮度フィールド、エンドポイント、エラーのREST要約です。

認証と制限

データエンドポイントは匿名で試せます。IPごとに毎分12リクエスト、毎時100リクエストです。キーを付けるとアカウントの月間枠が使われます。

bash · header
Authorization: Bearer YOUR_KEY
X-RateLimit-Remaining: 9999
X-RateLimit-Reset: 1788220800

鮮度を説明するフィールド

`source`はデータ種別、`market_session`は市場状態、`data_updated_at`は値の書き込み時刻です。3つとも保存してください。

エンドポイント

GET /v1/latest[/{BASE}]現在のレート。全通貨またはsymbolsで絞り込み。
GET /v1/{YYYY-MM-DD}[/{BASE}]指定日とベース通貨の履歴スナップショット。
GET /v1/convert/{FROM}/{TO}[/{AMOUNT}] · POST /v1/convert金額換算。単発GETと一括POST。
GET /v1/rate/{slug}slugで1通貨ペアを取得するフラットなレスポンス。
GET /v1/rangeページングとダウンロードに対応した日次系列。
GET /v1/currencies対応通貨一覧。パラメーターなし。
GET /v1/accountアカウント、プラン、有効キー、当月利用量。

エラー

すべて`{ result: "error", code, message }`形式です。429には`Retry-After`が付き、取得失敗時にモック値へ切り替わることはありません。

json · error
{
  "result": "error",
  "code": "missing_parameter",
  "message": "missing required parameter: symbols"
}

English complete field-by-field reference →

使い慣れた環境で使う

同じリクエストを curl、Python、JavaScript で実行できます。評価に API キーは不要です。

クイックスタートを開く →
curl -fsS --max-time 10 "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP"
レスポンス例
{
  "result": "success",
  "base": "USD",
  "source": "live",
  "sources": {
    "EUR": "live",
    "GBP": "live"
  },
  "market_session": "open",
  "timestamp": "2026-06-15T12:00:00Z",
  "data_updated_at": "2026-06-15T12:00:00Z",
  "effective_at": {
    "EUR": "2026-06-15T12:00:00Z",
    "GBP": "2026-06-15T12:00:00Z"
  },
  "rates": {
    "EUR": 0.86207,
    "GBP": 0.74627
  },
  "derived_symbols": [],
  "notice": "Indicative rates, not for settlement."
}

rates.EUR は 1 USD あたりの EUR 額です。effective_at.EUR は観測時刻、sources.EUR はソース区分を示します。値と時刻は例です。

JSON レスポンスを開く ↗API リファレンス →