> ## 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.

# Tasa por mercado

> Consulta una cotización por su identificador de mercado.

`GET /v1/fx/rates/:market`

<span id="request" />

## Consulta

Sustituye `:market` por un identificador de la tabla. Puedes usar `format` según tu [plan de formatos](/api/formats). 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](/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/rates/eur_reference" \
    -H "X-API-Key: $COTIZAVE_API_KEY"
  ```

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

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

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

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

<span id="response" />

## Respuesta

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

```json theme={null}
{
  "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. |

<span id="cuando-usar" />

## Cuándo usarlo

Úsalo cuando necesitas un mercado concreto. Si necesitas varios, [todas las tasas](/api/endpoints/get-rates) reduce consultas y devuelve un snapshot compartido.

<span id="casos-uso" />

## 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.

<span id="errores" />

## 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](/api/errors) de autenticación, cuota o disponibilidad. Las respuestas de error de la API son JSON; decide por `code`, no por el texto de `message`.


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