Introdução
A API da Finexly fornece taxas de câmbio em tempo real e históricas para mais de 170 moedas. Começar é fácil:
- Cadastre-se para uma conta gratuita
- Obtenha sua chave de acesso à API no painel de controle
- Faça sua primeira solicitação de API
URL base
https://api.finexly.com/v1/
Autenticação
Todas as solicitações de API exigem autenticação via token Bearer. Inclua sua chave de API no cabeçalho Authorization:
Opção 1: Cabeçalho de Autorização (Recomendado)
Cabeçalho de Autorização (Obrigatório)
Authorization: Bearer YOUR_API_KEY
Opção 2: Parâmetro de Consulta
Passe sua chave de API como um parâmetro de consulta:
GET https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY
⚠ Nota de Segurança: Chaves de API em URLs podem ser registradas nos logs de acesso do servidor e podem vazar através dos cabeçalhos HTTP Referrer. Para uso em produção, recomendamos o método do cabeçalho Authorization. O parâmetro de consulta é fornecido como uma conveniência para testes rápidos e integrações simples.
Limitação de Taxa: Verifique os cabeçalhos de resposta para seu uso atual:
X-RateLimit-Limit,
X-RateLimit-Used,
X-RateLimit-Units
Pontos de Extremidade da API
/v1/currencies
Obter uma lista de todos os códigos de moeda suportados.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|
Exemplo
GET https://api.finexly.com/v1/currencies
// Resposta
[
"AED",
"ANG",
"AUD",
"EUR",
"GBP",
"USD"
]
/v1/rate
Obter a taxa de câmbio para um par de moedas específico.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| from | string | Sim | Código da moeda base (maiúsculas) |
| to | string | Sim | Código da moeda de cotação (maiúsculas) |
Exemplo
GET https://api.finexly.com/v1/rate?from=USD&to=EUR
// Resposta
{
"pair": "USD_EUR",
"rate": 0.9215
}
/v1/convert
Obter taxas de câmbio para múltiplos pares de moedas em uma única solicitação.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| q | string | Sim | Pares separados por vírgula no formato BASE_COTAÇÃO |
Exemplo
GET https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP
// Resposta
{
"USD_EUR": {
"rate": 0.9215
},
"USD_GBP": {
"rate": 0.7892
}
}
/v1/convert-amount
Converter um valor específico de uma moeda para outra.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| from | string | Sim | Código da moeda de origem (maiúsculas) |
| to | string | Sim | Código da moeda de destino (maiúsculas) |
| amount | number | Sim | Valor a converter |
Exemplo
GET https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100
// Resposta
{
"pair": "USD_EUR",
"rate": 0.9215,
"amount": 100,
"result": 92.15
}
Exemplos de Código
# Using Authorization header (recommended)
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.finexly.com/v1/rate?from=USD&to=EUR"
# Using query parameter
curl "https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY"
# Get multiple rates
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP"
# Convert amount
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100"
<?php
$apiKey = 'YOUR_API_KEY';
// Using cURL
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => 'https://api.finexly.com/v1/rate?from=USD&to=EUR',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $apiKey,
],
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
echo "USD/EUR Rate: " . $data['rate'];
const apiKey = 'YOUR_API_KEY';
// Get single rate
const response = await fetch('https://api.finexly.com/v1/rate?from=USD&to=EUR', {
headers: {
'Authorization': `Bearer ${apiKey}`
}
});
const data = await response.json();
console.log(`USD/EUR Rate: ${data.rate}`);
// Convert amount
const convertResponse = await fetch(
'https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100',
{ headers: { 'Authorization': `Bearer ${apiKey}` } }
);
const result = await convertResponse.json();
console.log(`100 USD = ${result.result} EUR`);
import requests
api_key = 'YOUR_API_KEY'
headers = {'Authorization': f'Bearer {api_key}'}
# Get single rate
response = requests.get(
'https://api.finexly.com/v1/rate',
params={'from': 'USD', 'to': 'EUR'},
headers=headers
)
data = response.json()
print(f"USD/EUR Rate: {data['rate']}")
# Convert amount
response = requests.get(
'https://api.finexly.com/v1/convert-amount',
params={'from': 'USD', 'to': 'EUR', 'amount': 100},
headers=headers
)
result = response.json()
print(f"100 USD = {result['result']} EUR")
Códigos de Erro
| Código | Tipo | Descrição |
|---|---|---|
| 400 | BAD_REQUEST | Parâmetros de solicitação inválidos ou campos obrigatórios ausentes. |
| 401 | UNAUTHORIZED | Token de API ausente ou inválido. |
| 403 | FORBIDDEN | Acesso negado. Sua conta pode estar inativa. |
| 413 | PAYLOAD_TOO_LARGE | O tamanho da solicitação excede o tamanho máximo permitido. |
| 429 | RATE_LIMIT_EXCEEDED | Você excedeu seu limite de taxa. Verifique os cabeçalhos X-RateLimit. |
| 500 | INTERNAL_ERROR | Ocorreu um erro interno do servidor. Por favor, tente novamente. |
Tutorials & Guides
Learn how to integrate Finexly with your favorite programming languages and frameworks.
JavaScript Integration Tutorial
Step-by-step guide to integrating Finexly API with JavaScript and Node.js.
Python Integration Tutorial
Complete guide to using Finexly API with Python and popular libraries.
Developer Guide
Comprehensive guide to free currency API features and best practices.
Historical Rates Guide
Learn how to retrieve and work with historical exchange rate data.