Saltar para o conteúdo principal
GET
Símbolos de moeda

Primeiros passos

URL base

Endpoint de validação

O endpoint symbols é o pedido API mais simples do serviço de taxas de câmbio, pois só requer a sua chave API para obter a lista completa de símbolos de moeda disponíveis.
Este pedido bem-sucedido devolve todos os símbolos de moeda disponíveis com as respetivas descrições:

Parâmetros de pedido

api_key
String
obrigatório
A sua chave API única. Tenha em conta que cada utilizador tem chaves API únicas para cada uma das APIs Cleariflow, por isso a sua chave da API de taxas de câmbio não funcionará para a sua API de geolocalização IP, por exemplo.

Parâmetros de resposta

A resposta da API é devolvida num formato JSON universal e leve.
currencies
Object
Um objeto JSON com todos os símbolos de moeda disponíveis como chaves e descrições completas como valores. Isto inclui moedas fiduciárias tradicionais (USD, EUR, GBP, etc.) e criptomoedas populares (BTC, ETH, etc.).
last_updated
Integer
O timestamp Unix da última atualização dos símbolos de moeda a partir da fonte de dados.

Casos de utilização

Obter todas as moedas disponíveis

O endpoint symbols é ideal para:
  • Geração dinâmica de UI: preencher menus pendentes ou seletores de moeda na sua aplicação
  • Validación de divisas: comprobar si un código de divisa está admitido antes de realizar solicitudes de tipos de cambio
  • Descoberta de moedas: explorar todas as moedas disponíveis na API de taxas de câmbio
  • Configuração da aplicação: inicializar a sua aplicação com a lista completa de moedas suportadas

Ejemplo de caso de uso: selector de divisas

Moedas suportadas

A API de taxas de câmbio suporta mais de 80 moedas, incluindo:
  • Divisas fiduciarias principales: USD, EUR, GBP, JPY, AUD, CAD, CHF, CNY
  • Moedas europeias: SEK, NOK, DKK, PLN, CZK, HUF, RON, BGN, HRK, ISK
  • Moedas asiáticas: KRW, SGD, HKD, TWD, MYR, PHP, THB, IDR, INR, ILS
  • Moedas das Américas: BRL, MXN, ARS
  • Moedas africanas: ZAR, MAD, DZD
  • Criptomoedas: BTC, ETH, BNB, DOGE, XRP, BCH, LTC
Todos los códigos de divisa siguen el estándar ISO 4217 para compatibilidad internacional.