API de EMpulse Street FX Index
Tipos de cambio diarios de calle (paralelos) de monedas de mercados emergentes, cotizados en moneda fiat por 1 USDT (USDT se trata como 1 USD): el tipo que la gente realmente paga, no el oficial. Cada serie lleva una clase de confianza. El método completo está en la metodología.
Campos de una fila del índice
| Campo | Significado | Cuándo es null | Plan |
|---|---|---|---|
buy | Tipo medio ponderado del día al que un cliente compra USDT con moneda fiat. | El lado de compra tiene muy pocos puntos de datos para el día. | Todos los planes |
sell | Lo mismo para el lado en el que el cliente vende USDT. | El lado de venta tiene muy pocos puntos de datos para el día. | Todos los planes |
mid | (buy + sell) / 2 cuando existen ambos lados; cuando solo existe uno, el tipo de ese lado. | Ninguno de los lados tiene suficientes puntos de datos. | Todos los planes |
side | Los lados a partir de los cuales se construye el mid: both, buy o sell. Un mid construido con un solo lado se desplaza aproximadamente medio diferencial respecto a uno de dos lados. | No hay mid. | Todos los planes |
spread_pct | (buy − sell) / mid × 100. | El lado no es both. | Todos los planes |
confidence | high, medium o limited: la clase de la moneda según su cobertura; un día con menos puntos de datos de lo habitual baja una clase. limited significa menos fuentes o puntos de datos: más ruido y posibles vacíos. | Nunca. | Todos los planes |
flag | outlier para un día con pocos puntos de datos cuyo mid se desvía de la mediana de los mid de los ±15 días circundantes en más de 10%. Ese día conserva sus valores, pero se excluye de mid_7d y de los campos chg_*. | El día no es atípico. | Todos los planes |
in_progress | true para el último día de una moneda mientras el día aún se está recopilando y sus puntos de datos están claramente por debajo de la norma de los 7 días anteriores. | Nunca. | Todos los planes |
mid_7d | Media de los mid válidos de los últimos 7 días naturales, ambos inclusive. | No hay ningún mid válido en la ventana. | Todos los planes |
chg_1d_pct | Variación del mid respecto a exactamente 1 día natural antes, en porcentaje. | Alguno de los dos días no tiene un mid válido. | Todos los planes |
chg_7d_pct | Variación del mid respecto a exactamente 7 días naturales antes, en porcentaje. | Alguno de los dos días no tiene un mid válido. | Todos los planes |
chg_30d_pct | Variación del mid respecto a exactamente 30 días naturales antes, en porcentaje. | Alguno de los dos días no tiene un mid válido. | Todos los planes |
exchange_spread_pct | Cuánto se separan en el día los exchanges que cotizan la moneda: (mid más alto − mid más bajo entre exchanges) / mediana × 100. Un diferencial que se amplía es una de las entradas de FX Stress Signals. | Menos de dos exchanges cotizan la moneda, o la clave es gratuita. | Pro, Enterprise |
Las fechas son días naturales UTC. El último día está incompleto hasta que cierra y puede revisarse; los indicadores de los últimos 15 días pueden cambiar al llegar nuevos datos.
Tipos por hora (Pro y Enterprise). GET /v1/rates/CUR/hourly?from=&to= devuelve el índice por hora UTC (como máximo 31 días por solicitud), /v1/rates/CUR/hourly/latest las últimas 24 horas de una serie y /v1/rates/hourly/latest la última hora completa de cada moneda. Las filas por hora incluyen los mismos buy, sell, mid, side, spread_pct, confidence e in_progress; las respuestas por moneda añaden un summary por día. Las claves gratuitas reciben 403 tier_not_in_plan.
Índice de calle multifuente. /v1/street-index/*: tipos de cambio de calle agregados a partir de numerosas fuentes de mercado públicas e independientes, con una puntuación de confianza, para cada moneda que cubren las fuentes (misma clave).
Envíe su clave en el encabezado X-API-Key. Gratuito: solo RUB, UAH, EGP, 100 solicitudes al día, hasta el último día completo. Pro: todas las divisas, 10,000 solicitudes al día, incluye el día en curso (en progreso). Enterprise: según contrato. Los límites se restablecen a las 00:00 UTC.
JSON por defecto; envíe Accept: text/csv o añada ?format=csv para obtener CSV. Los errores se devuelven en JSON con un objeto error que contiene un code y un message, con estado 400 (parámetros incorrectos), 401 (clave ausente o no válida), 403 (período, divisa o producto no incluido en el plan: tier_delay, currency_not_in_plan, tier_not_in_plan, key_frozen), 404 (divisa o ruta desconocida), 429 (rate_limit_exceeded, history_quota_exceeded) o 503.
Las filas con más de 90 días de antigüedad cuentan para una cuota diaria por clave (gratuito 1,000, Pro 3,000 filas por día UTC); las exportaciones completas están disponibles mediante un acuerdo Enterprise. Las claves son personales; la descarga masiva automatizada bloquea la clave. Consulte los términos.
Los tipos de cambio paralelos no son tipos oficiales ni interbancarios; las series con confidence limited pueden presentar ruido y vacíos. Los datos no constituyen asesoramiento de inversión.