Live-Rates.com是一個用於外匯、商品和指數的即時 JSON / XML Web 服務和 Rest API。從 2019 年開始,訂閱者也可以使用 Streaming 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 技術 (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-socket API 範例,了解如何整合和使用它:
所有 API - Web 服務 / Rest API / Streaming 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
}
...
(需要身份驗證)
即時匯率提供有限數量的金融工具 (+-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
出於顯而易見的原因,即時匯率不會直接提供所有數千種可能的交叉匯率組合。我們所有可用的利率都直接來自具有真實流動性的提供者。如果您需要取得/計算無法直接獲得的匯率,您可以對其進行轉換,並更改基礎貨幣。
例如:不提供 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/CNY
Live-Rates 目前在 3 個資料中心擁有多台伺服器:
向 live-rates.com 發出的請求由我們位於歐洲的中央 DNS 伺服器轉送和解析。
如果您繞過 DNS 伺服器並直接連接到特定資料中心,連線速度會更快,但如果伺服器出現問題,您將收到 502 或 521,而不是來自備用伺服器的成功回應。
對於未經身份驗證的請求,我們允許最多 3 個/小時/IP 的點擊次數,如果您需要發出 API 請求或每秒更新即時費率,您需要訂閱授權並在請求中包含以下參數:
GET /rates?key=Your key
Host: live-rates.com
我們限制施虐者的造訪。如果您的許可證在 10 分鐘內平均每秒訪問次數超過 1 次,它將被暫時鎖定 10 分鐘。在此期間您將收到503 Service Unavailable
。