Live-Rates.com は、外国為替、商品、インデックス用のリアルタイム JSON / XML Web サービスおよび REST API です。 2019 年からは、サブスクライバーが利用できるストリーミング API も提供されます。
レートは毎秒更新されます。
最新の外国為替参考レートを JSON 形式で取得します。
GET /rates
Host: live-rates.com最新の外国為替参考レートを XML 形式で取得します。
GET /rates?rate_format=xml
Host: live-rates.com (認証が必要です)
利用可能な通貨ペア、商品、インデックス、およびそれらの最終更新日を取得します。
GET /api/rates?key=YOUR_KEY
Host: live-rates.com要求されたパラメータの最新の外国為替参照レートを JSON 形式で取得します。
GET /api/price?rate=EUR_USD,EUR_GBP&key=YOUR_KEY
Host: live-rates.com (認証が必要です)
ストリーミング API を使用すると、毎秒新しいデータをリクエストする必要がなくなりました。更新されたデータがメイン サーバーによって取得されると、Web ソケット テクノロジ (socket.io) を介してクライアントに自動的にプッシュされます。
中央の DNS サーバー (wss.live-rates.com) は、ユーザーの場所とサーバーの可用性に基づいて、優先データセンターに接続します。利用可能なローカルサーバーは次のとおりです。
| 位置 | ソケットアドレス | (*) ソケット V3 アドレス |
|---|---|---|
| ルーターサーバー | wss.live-rates.com | wss3.live-rates.com |
| ヨーロッパ | eu-wss.live-rates.com | eu-wss3.live-rates.com |
| 私たち | us-wss.live-rates.com | us-wss3.live-rates.com |
| アジア | as-wss.live-rates.com | as-wss3.live-rates.com |
(*) 新しいクライアント バージョンの Socketio (3.xx) に必要です
Web ソケット API の例を確認して、Web ソケット API を統合および使用する方法を理解してください。
Web サービス / REST API / ストリーミング API のすべての API は、同じ構造のデータを出力します。すべてのフィールドは文字列形式で送信されます。
{
Currency: "EUR/USD" //Description of the Instrument
Rate: "1.13625" //Same as BID (Deprecated)
Bid: "1.13625" //Bid Value of the Currency / Instrument
Ask: "1.13638" //Ask Value of the Currency / Instrument
High: "1.14081" //24H High of the Currency / Instrument
Low: "1.13527" //24H Low of the Currency / Instrument
Open: "1.13725" //Opening Value of the Daily Session / Previous Day if Market is Active
Close: "1.13625" //Closing Value of the Daily Session / Previous Day if Market is Active
Timestamp: "1551477238763" //Timestamp of the Last Update
}
...(認証が必要です)
Live-Rates は、限られた数の商品 (+-170) の履歴データを提供します。現時点では、外国為替通貨、金属、暗号通貨のみが利用可能です。すべてのエンドポイントには認証が必要です。
これにより、利用可能なすべての楽器が出力されます
GET /historical/list?key=YOUR_KEY
Host: live-rates.com このエンドポイントは、必要な日 (23:59:59 UTC 時間) の終値を提供します。
特定のペアのみが必要な場合は、オプションのパラメーターシンボルを指定できます。
GET /historical?base=EUR&date=YYYY-MM-DD&symbols=USD&key=YOUR_KEY
Host: live-rates.com このエンドポイントは、 30 日を超えることができない過去の特定の期間のレートを提供します。
特定のペアのみが必要な場合は、オプションのパラメーターシンボルを指定できます。
GET /historical/series?base=EUR&start=YYYY-MM-DD&end=YYYY-MM-DD&symbols=USD&key=YOUR_KEY
Host: live-rates.com明らかな理由により、Live-Rates は、可能な数千のクロスレートの組み合わせすべてを直接提供するわけではありません。当社が利用可能なレートはすべて、実際の流動性を備えたプロバイダーから直接提供されます。直接利用できないレートを取得/計算する必要がある場合は、基本通貨を変更してレートを換算できます。
例: MYR/CNY、MYR/GBP、または基本通貨 MYR とのその他のクロスレートは提供されません。ただし、入手できないというわけではありません。このケース/例では、USD/MYR を直接使用してから、必要な USD/XXX を使用できます。
{
"currency" : "USD/MYR" , "rate" : "4.14611" ,
"currency" : "USD/CNY" , "rate" : "6.8421"
}
// 6.84/4.15 = 1.65 MYR/CNYLive-Rates には現在、3 つのデータセンターに複数のサーバーがあります。
live-rates.com に対して行われたリクエストは、ヨーロッパにある当社の中央 DNS サーバーによって転送され、解決されます。
DNS サーバーをバイパスして特定のデータセンターに直接接続すると、接続は高速になりますが、サーバーに問題が発生した場合は、代替サーバーから成功応答の代わりに 502 または 521 を受信します。
認証されていないリクエストについては、IP あたり 1 時間あたり最大 3 ヒットが許可されます。API リクエストを行う必要がある場合、またはライブレートを毎秒更新する必要がある場合は、ライセンスをサブスクライブし、リクエストに次のパラメータを含める必要があります。
GET /rates?key=Your key
Host: live-rates.com不正行為者のアクセスを制限します。ライセンスが 10 分間平均で 1 秒あたり 1 回を超えてアクセスしている場合、ライセンスは 10 分間一時的にロックされます。その期間中は503 Service Unavailable表示されます。
