Cotação API

Integre valores da atual cotação do Dólar, Euro e outras moedas ao seu site.

Leia a documentação

Introdução

Esta API foi criada para facilitar o acesso à cotação de algumas moedas para a nossa.
Os dados são atualizados a cada 1 hora e salvos em um banco de dados (se diferentes) para consulta no momento que for necessário.

Como usar?

É possível obter o retorno dos dados em formato JSON (padrão) e XML.
Os dados disponíveis para cada moeda são nome (string), valor (float), última consulta (timestamp) e fonte (string).


Vamos trabalhar

Obtendo os dados

O endereço de consulta padrão é:
GET http://api.promasters.net.br/cotacao/v1/valores

O resultado obtido é:
{
	"status": true,
	"valores": {
		"USD": {
			"nome": "Dólar",
			"valor": 2.333,
			"ultima_consulta": 1386349203,
			"fonte": "UOL Economia - http://economia.uol.com.br/cotacoes/"
		},
		"EUR": {
			"nome": "Euro",
			"valor": 3.195,
			"ultima_consulta": 1386349203,
			"fonte": "UOL Economia - http://economia.uol.com.br/cotacoes/"
		},
		"BTC": {
			"nome": "Bitcoin",
			"valor": 2620,
			"ultima_consulta": 1386352803,
			"fonte": "Mercado Bitcoin - http://www.mercadobitcoin.com.br/"
		}
	}
}

Retorno em linguagem diferente

Para obter o retorno em XML ou JSON, use o parâmetro GET[alt] para informar a intenção. Exemplo:
GET http://api.promasters.net.br/cotacao/v1/valores?alt=xml

O resultado obtido é:
<root>
	<status>1</status>
	<valores>
		<USD>
			<nome>Dólar</nome>
			<valor>2,333</valor>
			<ultima_consulta>1386349203</ultima_consulta>
			<fonte>UOL Economia - http://economia.uol.com.br/cotacoes/</fonte>
		</USD>
		<EUR>
			<nome>Euro</nome>
			<valor>3,195</valor>
			<ultima_consulta>1386349203</ultima_consulta>
			<fonte>UOL Economia - http://economia.uol.com.br/cotacoes/</fonte>
		</EUR>
		<BTC>
			<nome>Bitcoin</nome>
			<valor>2620</valor>
			<ultima_consulta>1386352803</ultima_consulta>
			<fonte>Mercado Bitcoin - http://www.mercadobitcoin.com.br/</fonte>
		</BTC>
	</valores>
</root>

Obtendo uma ou mais moedas específicas

Para obter uma moeda específica, use o parâmetro GET[moedas] para informar a intenção. Exemplo:
GET http://api.promasters.net.br/cotacao/v1/valores?moedas=USD&alt=json

O resultado obtido é:
{
	"status": true,
	"valores": {
		"USD": {
			"nome": "Dólar",
			"valor": 2.333,
			"ultima_consulta": 1386349203,
			"fonte": "UOL Economia - http://economia.uol.com.br/cotacoes/"
		}
	}
}

Para obter mais de uma moeda específica, use também o parâmetro GET[moedas] para informar a intenção separando as moedas por vírgula. Exemplo:
GET http://api.promasters.net.br/cotacao/v1/valores?moedas=USD,BTC&alt=json

O resultado obtido é:
{
	"status": true,
	"valores": {
		"USD": {
			"nome": "Dólar",
			"valor": 2.333,
			"ultima_consulta": 1386349203,
			"fonte": "UOL Economia - http://economia.uol.com.br/cotacoes/"
		},
		"BTC": {
			"nome": "Bitcoin",
			"valor": 2620,
			"ultima_consulta": 1386352803,
			"fonte": "Mercado Bitcoin - http://www.mercadobitcoin.com.br/"
		}
	}
}

Descobrindo quais moedas estão disponíveis

Para saber quais são as moedas disponíveis no sistema, o endereço da consulta é:
GET http://api.promasters.net.br/cotacao/v1/moedas

O resultado obtido é:
{
	"status": true,
	"moedas": {
		"USD": {
			"moeda": "USD",
			"nome": "Dólar",
			"fonte": "UOL Economia - http://economia.uol.com.br/cotacoes/"
		},
		"ARS": {
			"moeda": "ARS",
			"nome": "Peso Argentino",
			"fonte": "UOL Economia - http://economia.uol.com.br/cotacoes/"
		},
		"EUR": {
			"moeda": "EUR",
			"nome": "Euro",
			"fonte": "UOL Economia - http://economia.uol.com.br/cotacoes/"
		},
		"BTC": {
			"moeda": "BTC",
			"nome": "Bitcoin",
			"fonte": "Mercado Bitcoin - http://www.mercadobitcoin.com.br/"
		}
	}
}

Contribua!

Estará ajudando a manter a qualidade em um serviço 100% gratuito e bastante útil.

Ainda tem dúvida, achou algum bug, quer ajuda?

Entre em contato que vamos te ajudar.