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
。