Live-Rates.com é uma API JSON/XML Webservice & Rest em tempo real para forex, commodities e índices. Também existe uma API de Streaming disponível para assinantes, a partir de 2019.
As taxas são atualizadas a cada segundo .
Obtenha as taxas de câmbio de referência mais recentes no formato JSON.
GET /rates
Host: live-rates.com
Obtenha as taxas de câmbio de referência mais recentes em formato XML.
GET /rates?rate_format=xml
Host: live-rates.com
(requer autenticação)
Obtenha os pares de moedas, commodities e índices disponíveis e também quando foram atualizados pela última vez
GET /api/rates?key=YOUR_KEY
Host: live-rates.com
Obtenha as taxas de câmbio de referência mais recentes para os parâmetros solicitados, no formato JSON.
GET /api/price?rate=EUR_USD,EUR_GBP&key=YOUR_KEY
Host: live-rates.com
(requer autenticação)
Com a API de streaming, não é mais necessário solicitar novos dados a cada segundo. Quando os dados atualizados são recuperados pelo servidor principal, eles são automaticamente enviados ao cliente por meio da tecnologia Web-socket (socket.io).
O servidor DNS central (wss.live-rates.com) conecta você ao datacenter preferido com base na sua localização e disponibilidade do servidor. Os servidores locais disponíveis são:
Localização | Endereço de soquete | (*) Endereço do soquete V3 |
---|---|---|
Servidor roteador | wss.live-rates.com | wss3.live-rates.com |
Europa | eu-wss.live-rates.com | eu-wss3.live-rates.com |
NÓS | us-wss.live-rates.com | us-wss3.live-rates.com |
Ásia | as-wss.live-rates.com | as-wss3.live-rates.com |
(*) Necessário para nova versão cliente do socketio (3.xx)
Verifique os exemplos da API Web-socket para entender como você pode integrá-la e usá-la:
Todas as APIs - Web-Service / Rest API / Streaming API - geram dados com a mesma estrutura. Todos os campos são enviados em formato string:
{
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
}
...
(requer autenticação)
Live-Rates fornece dados históricos para um número limitado de instrumentos (+-170). No momento, apenas moedas Forex, metais e criptografia estão disponíveis. Todos os endpoints exigem autenticação.
Isso produzirá todos os instrumentos disponíveis
GET /historical/list?key=YOUR_KEY
Host: live-rates.com
Este Endpoint fornecerá o preço de fechamento para o dia necessário (23:59:59, horário UTC).
Você pode fornecer os símbolos de parâmetros opcionais se precisar apenas de pares específicos.
GET /historical?base=EUR&date=YYYY-MM-DD&symbols=USD&key=YOUR_KEY
Host: live-rates.com
Este Endpoint fornecerá as tarifas para um determinado período passado que não pode ser superior a 30 dias .
Você pode fornecer os símbolos de parâmetros opcionais se precisar apenas de pares específicos.
GET /historical/series?base=EUR&start=YYYY-MM-DD&end=YYYY-MM-DD&symbols=USD&key=YOUR_KEY
Host: live-rates.com
Por razões óbvias, o Live-Rates não fornece diretamente todas as milhares de combinações possíveis de taxas cruzadas. Todas as nossas taxas disponíveis vêm diretamente de provedores com liquidez real. Caso necessite obter/calcular uma taxa não disponível diretamente, você pode convertê-la, alterando a moeda base.
Exemplo: MYR/CNY, MYR/GBP ou quaisquer outras taxas cruzadas com a moeda base MYR não são fornecidas. No entanto, isso não significa que você não possa obtê-los. Neste caso/exemplo, você pode usar diretamente o USD/MYR e depois o USD/XXX desejado.
{
"currency" : "USD/MYR" , "rate" : "4.14611" ,
"currency" : "USD/CNY" , "rate" : "6.8421"
}
// 6.84/4.15 = 1.65 MYR/CNY
Live-Rates possui atualmente vários servidores em 3 datacenters:
As solicitações feitas ao live-rates.com são encaminhadas e resolvidas pelo nosso servidor DNS central na Europa.
Se você ignorar o servidor DNS e se conectar diretamente a um datacenter específico, a conexão será mais rápida. No entanto, em caso de problema com o servidor, você receberá um 502 ou 521 em vez de uma resposta de sucesso do servidor alternativo.
Permitimos até 3 acessos/hora/ip para solicitações não autenticadas. Se você precisar fazer solicitações de API ou obter taxas atualizadas a cada segundo, será necessário assinar uma licença e incluir em suas solicitações os seguintes parâmetros:
GET /rates?key=Your key
Host: live-rates.com
Restringimos o acesso aos abusadores. Se sua licença acessar mais de 1x por segundo em média de 10 minutos, ela será temporariamente bloqueada por 10 minutos. Você receberá 503 Service Unavailable
durante esse período.