Tasa por mercado

GET /v1/fx/rates/:market

Consulta

Sustituye :market por un identificador de la tabla. Puedes usar format según tu plan de formatos. No traduzcas el identificador al cambiar el idioma de lectura.

Mercado	Base	Tipo / acceso mínimo
`reference`	USD	BCV oficial · Gratis
`eur_reference`	EUR	BCV oficial · Gratis
`parallel`	USD	Referencia de mercado libre · Gratis
`binance`, `bybit`, `okx`, `bitget`, `mexc`, `bingx`, `saldo`	USD	Cotizaciones P2P USDT/VES normalizadas · Gratis
`paypal`, `zelle`	USD	Remesas, solo hacia VES · Esencial
`syklo`, `yadio`, `zoom`, `western_union`	USD	Mercados extendidos · Profesional
`cash`, `cucuta`	USD	Efectivo · Escala

Los ejemplos se ejecutan en el servidor. JavaScript y Python usan los clientes del inicio rápido; configura allí COTIZAVE_API_KEY.

curl --fail-with-body --max-time 10 "https://api.cotizave.com/v1/fx/rates/eur_reference" \
  -H "X-API-Key: $COTIZAVE_API_KEY"

import { cotizave } from './cotizave.mjs';

const data = await cotizave('/v1/fx/rates/eur_reference');
console.log(data);

from cotizave import cotizave

data = cotizave('/v1/fx/rates/eur_reference')
print(data)

Respuesta

Respuesta ilustrativa: las cifras y fechas no son cotizaciones actuales.

{
  "market": "eur_reference",
  "type": "reference",
  "base": "EUR",
  "mid": 550.12,
  "updated_at": "2026-10-19T04:00:00Z",
  "effective_date": "2026-10-19"
}

Campo	Significado
`market`	Identificador estable del mercado.
`type`	`reference`, `parallel`, `p2p`, `remittance`, `cash` o `exchange_house`. Tolera nuevos tipos.
`base`	Moneda base opcional. Si falta, USD; `eur_reference` usa EUR.
`mid`	VES por unidad de la moneda base.
`ask`, `bid`	Cotizaciones opcionales; pueden omitirse. No todos los mercados tienen ambos lados.
`updated_at`	Actualización de la cotización, ISO 8601.
`effective_date`	Fecha valor opcional del BCV, `YYYY-MM-DD` en el calendario de Caracas.
`stale_after_sec`	Umbral de antigüedad opcional, en segundos, proporcionado para esa fuente.

Cuándo usarlo

Úsalo cuando necesitas un mercado concreto. Si necesitas varios, todas las tasas reduce consultas y devuelve un snapshot compartido.

Mostrar la tasa

Muestra siempre mercado, moneda base y fecha. Para BCV conserva effective_date. En una interfaz de Australia puedes usar formato numérico en-AU y una zona horaria australiana para presentar timestamps; los valores de la API siguen siendo VES/USD o VES/EUR. Formatear una cifra no la convierte a AUD.

Errores

404 resource_not_found indica que el mercado no está disponible. 402 feature_not_in_plan indica un mercado restringido por plan. No sustituyas uno por otro sin una decisión explícita de tu aplicación. western_union y otros mercados de tipo remittance solo admiten conversiones hacia VES. Además pueden producirse los errores comunes de autenticación, cuota o disponibilidad. Las respuestas de error de la API son JSON; decide por code, no por el texto de message.

Documentación

Empezar

API

Venezuela: endpoints

Índices

Guías

Consulta

Respuesta

Cuándo usarlo

Mostrar la tasa

Errores

​Consulta

​Respuesta

​Cuándo usarlo

​Mostrar la tasa

​Errores

Consulta

Respuesta

Cuándo usarlo

Mostrar la tasa

Errores