メインコンテンツへスキップ
GET
通貨シンボル

はじめに

ベースURL

検証エンドポイント

symbolsエンドポイントは為替レートサービスで最もシンプルなAPI呼び出しで、APIキーのみで利用可能な通貨シンボルの完全なリストを取得できます。
この成功したリクエストは、対応する説明付きの利用可能なすべての通貨シンボルを返します。

リクエストパラメータ

api_key
String
必須
固有のAPIキーです。各ユーザーはCleariflowの各APIごとに固有のAPIキーを持っているため、為替レートAPIのキーはIPジオロケーションAPIなどでは動作しません。

レスポンスパラメータ

APIレスポンスは、汎用的で軽量な JSON形式 で返されます。
currencies
Object
利用可能なすべての通貨シンボルをキーとし、完全な説明を値とするJSONオブジェクトです。従来の法定通貨(USD、EUR、GBPなど)と主要な暗号通貨(BTC、ETHなど)が含まれます。
last_updated
Integer
データソースから通貨シンボルが最後に更新されたUnixタイムスタンプです。

ユースケース

利用可能なすべての通貨を取得

symbolsエンドポイントは次の用途に最適です。
  • 動的UI生成:アプリケーションのドロップダウンメニューや通貨セレクターを生成
  • 通貨検証:為替レートリクエストを行う前に通貨コードがサポートされているか確認
  • 通貨の探索:為替レートAPIで利用可能なすべての通貨を調査
  • アプリケーションのセットアップ:サポート対象通貨の完全なリストでアプリケーションを初期化

ユースケース例:通貨セレクター

サポート対象通貨

為替レートAPIは 80以上の通貨 をサポートしており、以下を含みます。
  • 主要法定通貨:USD、EUR、GBP、JPY、AUD、CAD、CHF、CNY
  • 欧州通貨:SEK、NOK、DKK、PLN、CZK、HUF、RON、BGN、HRK、ISK
  • アジア通貨:KRW、SGD、HKD、TWD、MYR、PHP、THB、IDR、INR、ILS
  • 南北アメリカ通貨:BRL、MXN、ARS
  • アフリカ通貨:ZAR、MAD、DZD
  • 暗号通貨:BTC、ETH、BNB、DOGE、XRP、BCH、LTC
すべての通貨コードは国際互換性のため ISO 4217 標準に従います。