> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cotizave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Catálogo de mercados

> Lista las tasas que puedes pedir, con su nombre, alias y si tu plan las incluye.

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

<span id="request" />

## 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](/api/quickstart#paso-2); configura allí `COTIZAVE_API_KEY`.

<CodeGroup>
  ```bash curl theme={null}
  curl --fail-with-body --max-time 10 "https://api.cotizave.com/v1/fx/markets" \
    -H "X-API-Key: $COTIZAVE_API_KEY"
  ```

  ```javascript Node.js theme={null}
  import { cotizave } from './cotizave.mjs';

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

  ```python Python theme={null}
  from cotizave import cotizave

  data = cotizave('/v1/fx/markets')
  print(data)
  ```
</CodeGroup>

<span id="response" />

## Respuesta

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

```json theme={null}
{
  "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`](/api/endpoints/get-rate-by-market), `via` de [`/convert`](/api/endpoints/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.

<span id="errores" />

## Errores

En los planes Gratis e Inicio responde `402 feature_not_in_plan`. Además pueden producirse los [errores comunes](/api/errors) de autenticación, cuota o disponibilidad.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.