API EMpulse Street FX Index
Cotações diárias de câmbio de rua de moedas de mercados emergentes, cotadas em moeda fiduciária por 1 USDT (USDT é tratado como 1 USD): a taxa que as pessoas realmente pagam, não a oficial. Cada série traz uma classe de confiança. O método completo está na metodologia.
Campos de uma linha do índice
| Campo | Significado | Quando é null | Plano |
|---|---|---|---|
buy | Taxa média ponderada do dia pela qual um cliente compra USDT com moeda fiduciária. | O lado de compra tem poucos pontos de dados no dia. | Todos os planos |
sell | O mesmo para o lado em que o cliente vende USDT. | O lado de venda tem poucos pontos de dados no dia. | Todos os planos |
mid | (buy + sell) / 2 quando existem os dois lados; quando existe só um, a taxa desse lado. | Nenhum dos lados tem pontos de dados suficientes. | Todos os planos |
side | De quais lados o mid é construído: both, buy ou sell. Um mid de um só lado fica deslocado em cerca de meio spread em relação a um mid de dois lados. | Não há mid. | Todos os planos |
spread_pct | (buy − sell) / mid × 100. | O lado não é both. | Todos os planos |
confidence | high, medium ou limited: a classe da moeda conforme sua cobertura; um dia com menos pontos de dados que o habitual fica uma classe abaixo. limited significa menos fontes ou pontos de dados: mais ruído, possíveis lacunas. | Nunca. | Todos os planos |
flag | outlier para um dia com poucos pontos de dados cujo mid se desvia da mediana dos mids dos ±15 dias ao redor em mais de 10%. Esse dia mantém seus valores, mas fica fora de mid_7d e dos campos chg_*. | O dia não é um outlier. | Todos os planos |
in_progress | true para o dia mais recente de uma moeda enquanto o dia ainda está sendo coletado e seus pontos de dados estão claramente abaixo da norma dos 7 dias anteriores. | Nunca. | Todos os planos |
mid_7d | Média dos mids válidos nos últimos 7 dias corridos, inclusive. | Não há mid válido na janela. | Todos os planos |
chg_1d_pct | Variação do mid em relação a exatamente 1 dia corrido antes, em porcentagem. | Um dos dois dias não tem mid válido. | Todos os planos |
chg_7d_pct | Variação do mid em relação a exatamente 7 dias corridos antes, em porcentagem. | Um dos dois dias não tem mid válido. | Todos os planos |
chg_30d_pct | Variação do mid em relação a exatamente 30 dias corridos antes, em porcentagem. | Um dos dois dias não tem mid válido. | Todos os planos |
exchange_spread_pct | Quão distantes ficam, no dia, as exchanges que cotam a moeda: (maior − menor mid de exchange) / mediana × 100. Um spread que se amplia é um dos insumos do FX Stress Signals. | Menos de duas exchanges cotam a moeda, ou a chave é gratuita. | Pro, Enterprise |
As datas são dias corridos em UTC. O dia mais recente fica incompleto até fechar e pode ser revisado; os flags dos últimos 15 dias podem mudar quando chegam novos dados.
Taxas por hora (Pro e Enterprise). GET /v1/rates/CUR/hourly?from=&to= retorna o índice por hora UTC (no máximo 31 dias por requisição), /v1/rates/CUR/hourly/latest as 24 horas mais recentes de uma série, /v1/rates/hourly/latest a última hora completa de cada moeda. As linhas por hora trazem os mesmos buy, sell, mid, side, spread_pct, confidence e in_progress; as respostas por moeda acrescentam um summary por dia. Chaves gratuitas recebem 403 tier_not_in_plan.
Índice de rua multifonte. /v1/street-index/*: taxas de rua agregadas de muitas fontes públicas de mercado independentes, com uma pontuação de confiança, para cada moeda coberta pelas fontes (mesma chave).
Envie sua chave no cabeçalho X-API-Key. Free: apenas RUB, UAH, EGP, 100 requisições por dia, até o último dia completo. Pro: todas as moedas, 10,000 requisições por dia, inclui o dia atual (em andamento). Enterprise: conforme contrato. Os limites são reiniciados às 00:00 UTC.
JSON por padrão; envie Accept: text/csv ou adicione ?format=csv para obter CSV. Os erros são retornados em JSON com um objeto error que contém um code e uma message, com status 400 (parâmetros inválidos), 401 (chave ausente ou inválida), 403 (período, moeda ou produto não incluído no plano: tier_delay, currency_not_in_plan, tier_not_in_plan, key_frozen), 404 (moeda ou rota desconhecida), 429 (rate_limit_exceeded, history_quota_exceeded) ou 503.
As linhas com mais de 90 dias contam para uma cota diária por chave (free 1,000, pro 3,000 linhas por dia UTC); exportações completas estão disponíveis mediante um contrato Enterprise. As chaves são pessoais; o download em massa automatizado bloqueia a chave. Consulte os termos.
As taxas de rua não são taxas oficiais nem interbancárias; séries com confidence limited podem ser instáveis e apresentar lacunas. Os dados não constituem aconselhamento de investimento.