API pública

Gratis, sin API key. Base URL: https://tasa-ves-usdt-backend.onrender.com

Límites de uso

600 requests cada 15 minutos por IP en los endpoints de solo lectura (de sobra para un dashboard propio, incluso con polling agresivo). Los dos endpoints que pegan en vivo a Binance P2P (/quote, /market-comparison) tienen un límite más estricto: 60 cada 15 minutos. Pasado el límite, la respuesta es 429.

CORS

Los endpoints marcados abierto aceptan fetch desde cualquier origen — se pueden llamar directo desde el navegador de tu propio sitio. Los marcados restringido solo responden con headers CORS a dollarnow.space (sirven en vivo de un tercero o tocan datos propios) — desde un backend propio (Node, PHP, Python, lo que sea) igual se puede llamar sin problema, CORS solo aplica a fetch desde el navegador.

Endpoints

GET/api/rates/currentabierto

Última tasa recolectada: USDT, USDC, Dólar BTC, BCV oficial, brecha vs BCV, variación de hoy y estadísticas del día (apertura/mín/máx).

GET/api/rates/payment-methodsabierto

Lista de bancos/métodos de pago válidos para filtrar en /quote (todos denominados en bolívares).

GET/api/rates/history?days=7abierto

Snapshots crudos de los últimos N días (uno cada ~5 min).

GET/api/rates/candles?interval=1h&days=7abierto

Velas OHLC de USDT. interval: 15m, 1h, 4h, 1d, 1w, 1M.

GET/api/rates/asset-history?asset=binance&days=7abierto

Serie simple (no OHLC) de un activo. asset: binance (USDT), usdc o btc (Dólar BTC). Rangos de más de 2 días vienen agrupados en baldes de 1 hora.

GET/api/rates/bcv-history?days=30&projectionDays=5abierto

Histórico oficial real del BCV desde 2016 + proyección log-lineal opcional + promedio diario de Binance P2P propio.

GET/api/rates/quote?payType=BancoDeVenezuela&amount=100restringido

Cotización en vivo de USDT filtrada por banco y/o monto (en USDT). Le pega a Binance P2P en el momento — por eso está restringido.

GET/api/rates/market-comparisonrestringido

Comparador secundario: BCV, USDT propio, y dos referencias externas de mercado paralelo (dolarapi.com y yadio.io).

Otros países

Mismo espíritu que Venezuela, alcance más chico por ahora (sin proyección). :country válidos: ar (Argentina), bo (Bolivia), co (Colombia), cl (Chile), uy (Uruguay), mx (México), br (Brasil), pe (Perú).

GET/api/countries/:country/currentabierto

Última tasa recolectada para ese país + variación de hoy. Todos traen usdc y btc (mismo criterio que Venezuela: btc.dolarBtcRate es el precio de BTC en moneda local ÷ precio real de BTC/USD) además de su tasa oficial y usdt. La forma exacta del resto depende del país: Argentina trae además oficial/blue/bolsa/ccl/cripto; Colombia trae trm/dolarapiRef; el resto (Bolivia, Chile, Uruguay, México, Perú) trae oficial. Brasil es un caso aparte: usdt/usdc/btc no vienen de Binance P2P como en el resto -- Binance restringe las ofertas P2P en reales a cuentas registradas en Brasil, así que se usa el precio del mercado spot de Binance (USDTBRL/USDCBRL/BTCBRL) en su lugar. Mismo shape de respuesta, otra fuente.

GET/api/countries/:country/history?days=7abierto

Serie propia (oficial + USDT) desde que este servidor empezó a recolectar cada país -- no hay histórico previo a eso.

GET/api/countries/:country/official-historyabierto

Histórico oficial completo (años, no solo lo que este servidor recolectó). Solo disponible para ar (desde 2011), co (desde 1991), cl (desde 1990) y br (desde el Plan Real, 01/07/1994) -- el resto devuelve {"available":false}.

GET/api/countries/summaryabierto

La tasa oficial, USDT y brecha % de los 24 países (incluyendo Venezuela) en un solo request -- pensado para armar comparadores como la portada sin pegarle a /current 24 veces.

Ejemplo

curl https://tasa-ves-usdt-backend.onrender.com/api/rates/current

{
  "timestamp": "2026-08-25T12:00:00.000Z",
  "binance": { "compra": 930, "venta": 930, "mid": 930 },
  "bcv": 785.07,
  "brechaBcvPercent": 18.46,
  "usdc": { "mid": 928.5, "brechaBcvPercent": 18.27 },
  "btc": { "dolarBtcRate": 931.8, "brechaBcvPercent": 18.7 },
  "todayChangePercent": { "binance": 0.49, "usdc": 2.24, "btc": -1.61, "bcv": 0.78 },
  "todayStats": { "binance": { "open": 925.45, "high": 930, "low": 925.45 } }
}

Notificaciones

Resumen 4 veces al día (9am/1pm/5pm/8pm hora local de cada país) por Telegram o por notificación push del navegador -- las dos opciones están en la sección de alertas de cada página de país. Endpoints usados por el sitio (/api/push/vapid-public-key, /api/push/subscribe, /api/push/unsubscribe) no están pensados para consumo externo, no forman parte de la API pública.

Widget embebible

Un <iframe> chico (~280x150) para poner la tasa de cualquiera de los 24 países en tu propio sitio, con crédito a Dollar Now. Parámetros: country (ve/ar/bo/co/cl/uy/mx/br/pe/do/py/pa/ec/us/ca/sv/ht/hn/cu/cr/jm/tt/gt/ni, default ve) y theme (dark/light, default dark).

<iframe src="https://dollarnow.space/widget.html?country=ve&theme=dark"
  width="280" height="150" style="border:0;border-radius:6px"></iframe>

Algo cambió / algo se rompió

Este backend es de un solo dev, sin SLA. Si algo cambia de forma incompatible, va a ser porque no quedó otra (ej. Binance cambió su API sin avisar) — no hay versión ni changelog formal todavía. Ver cómo se calcula cada tasa para el detalle de cada fuente.