Live-Rates.com — это веб-сервис JSON/XML и 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 больше не нужно запрашивать свежие данные каждую секунду. Когда обновленные данные извлекаются основным сервером, они автоматически передаются клиенту через технологию веб-сокетов (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).
Ознакомьтесь с примерами API веб-сокетов, чтобы понять, как его можно интегрировать и использовать:
Все API — Web-Service/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
}
...(требуется аутентификация)
Live-Rates предоставляет исторические данные для ограниченного числа инструментов (+-170). На данный момент доступны только валюты Форекс, металлы и криптовалюта. Все конечные точки требуют аутентификации.
Это выведет все доступные инструменты.
GET /historical/list?key=YOUR_KEY
Host: live-rates.com Эта конечная точка предоставит цену закрытия на требуемый день (23:59:59 по всемирному координированному времени).
Вы можете предоставить символы дополнительных параметров, если вам нужны только определенные пары.
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 вместо ответа об успехе от альтернативного сервера.
Мы допускаем до 3 обращений в час/IP для неаутентифицированных запросов. Если вам нужно делать запросы API или получать актуальные тарифы каждую секунду, вам необходимо подписаться на лицензию и включить в свои запросы следующий параметр:
GET /rates?key=Your key
Host: live-rates.com Мы ограничиваем доступ злоумышленникам. Если ваша лицензия осуществляет доступ более 1 раза в секунду в среднем за 10 минут, она будет временно заблокирована на 10 минут. В течение этого периода вы получите 503 Service Unavailable .
