Catálogo de mercados - Cotizave

GET /v1/fx/markets · Desde el plan Esencial. No devuelve precios: es la lista de mercados que existen y cómo pedirlos.

Consulta

Sin parámetros. Parámetros desconocidos producen 400 unknown_parameter. 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/markets" \
  -H "X-API-Key: $COTIZAVE_API_KEY"

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

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

from cotizave import cotizave

data = cotizave('/v1/fx/markets')
print(data)

Respuesta

Respuesta ilustrativa: la lista real depende de los mercados disponibles en ese momento.

{
  "markets": [
    {
      "id": "reference",
      "name": "BCV dólar",
      "type": "reference",
      "base": "USD",
      "aliases": ["bcv"],
      "stale_after_sec": 475200,
      "available": true,
      "required_plan": null
    },
    {
      "id": "binance",
      "name": "Binance P2P",
      "type": "p2p",
      "base": "USD",
      "aliases": [],
      "stale_after_sec": 1800,
      "available": true,
      "required_plan": null
    },
    {
      "id": "cash",
      "name": "Efectivo",
      "type": "cash",
      "base": "USD",
      "aliases": [],
      "stale_after_sec": 10800,
      "available": false,
      "required_plan": "Escala"
    }
  ]
}

Campo	Qué es
`id`	El nombre que se usa en `/rates/:market`, `via` de `/convert` y el resto de la API.
`name`	Nombre para mostrar a tus usuarios.
`type`	`reference`, `parallel`, `p2p`, `remittance`, `exchange_house` o `cash`.
`base`	Moneda contra la que cotiza en VES: `USD` o `EUR`.
`aliases`	Otros nombres que la API acepta para ese mercado, como `bcv`. La respuesta de los demás endpoints usa siempre `id`.
`stale_after_sec`	Desde qué antigüedad la cotización se marca `stale`. Cada fuente tiene su propio umbral.
`available`	Si tu plan incluye ese mercado.
`required_plan`	Si no lo incluye, el plan más económico que sí. `null` si lo tienen todos.

El orden es el de la tabla de tasas: oficiales, paralelo, P2P, remesas, casas de cambio y efectivo.

Errores

En los planes Gratis e Inicio responde 402 feature_not_in_plan. Además pueden producirse los errores comunes de autenticación, cuota o disponibilidad.