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:

  1. Cadastre-se para uma conta gratuita
  2. Obtenha sua chave de acesso à API no painel de controle
  3. 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:

Cabeçalho de Autorização (Obrigatório)

Authorization: Bearer YOUR_API_KEY

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

GET /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"
]
GET /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
}
GET /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
    }
}
GET /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

# Get single rate
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.finexly.com/v1/rate?from=USD&to=EUR"

# Get multiple rates
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP,BTC_USD"

# 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.