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

# Diccionario de datos

> Interpreta las respuestas de Cotizave V2: códigos de moneda, tasas, campos y objetos JSON. Revisa su significado y las consideraciones de precisión y redondeo.

Este diccionario explica los valores que devuelve V2. Los importes y tasas son números JSON: aplica aritmética decimal y el redondeo de tu aplicación.

## Monedas y códigos

| Código | Moneda | Uso en V2 |
| - | - | - |
| `USD` | dólar estadounidense | Base de la mayoría de referencias. |
| `VES` | bolívar venezolano | Moneda cotizada de `VE`. |
| `COP` | peso colombiano | Moneda cotizada de `CO`. |
| `PEN` | sol peruano | Moneda cotizada de `PE`. |
| `MXN` | peso mexicano | Moneda cotizada de `MX`. |
| `ARS` | peso argentino | Moneda cotizada de `AR`. |
| `CAD` | dólar canadiense | Moneda cotizada de `CA`. |
| `EUR` | euro | Moneda cotizada de `ES` y `PT`, y base de algunas referencias. |
| `USDT`, `USDC`, `EURC` | activos estables | Bases de las referencias estables cuando corresponda. |

`base` es la moneda de una unidad de referencia y `quote` es la moneda en que se expresa esa unidad. Ejemplo: `base=USD`, `quote=COP`, `mid=4000` significa 4.000 COP por 1 USD.

## Objeto de tasa

| Campo | Significado |
| - | - |
| `id` / `market` | ID global canónico (`co-trm`) e identificador local estable (`co_trm`). En VE `market` conserva el valor de V1. |
| `name` / `description` | Nombre y explicación visibles de la referencia. |
| `type` | Tipo público. `official` se presenta como `reference` y `crypto_p2p` como `p2p`; el filtro `?category=` conserva sus valores internos. Consulta [endpoints](https://docs.cotizave.com/api/v2/endpoints.md). |
| `base`, `quote`, `mid`, `bid`, `ask` | Par de monedas, referencia central y lados de compra/venta cuando se publican. `null` no equivale a cero. |
| `updated_at`, `effective_date`, `fetched_at` | Instante de la fuente, fecha valor y momento de captura, almacenamiento o armado de respuesta, según el recurso. En el histórico diario propio, `fetched_at` es estable mientras no cambie el punto; según el recurso puede variar entre consultas. `index.as_of` conserva su nombre propio. |
| `stale`, `stale_after_sec`, `staleness_sec` | Estado de frescura, umbral de frescura y antigüedad en segundos. |
| `change_24h_pct`, `vs_official_pct` | Variación frente a 24 horas y diferencia frente a una referencia oficial comparable; pueden ser `null` u omitirse. |
| `tags` | Etiquetas de clasificación y filtro. |
| `available`, `required_plan` | Disponibilidad y plan mínimo interno (`free`, `hobby`, `indie`, `pro`). Su presencia depende del [plan](https://docs.cotizave.com/api/v2/plans.md). |
| `conversion_directions` | Solo en `/markets`: pares `{from,to}` admitidos por `/convert` para la tasa. `[]` significa que esa tasa no es convertible; no garantiza acceso ni precio vigente. |

## Categoría del filtro y tipo público

`?category=` conserva los nombres internos del filtro. En el JSON de una tasa aparece `type`; los valores siguientes provienen del mapeo del backend. No conviertas otras categorías por reglas de texto ni supongas que una categoría implica una tasa publicada en tu país.

| `category` del filtro | `type` de la respuesta |
| - | - |
| `official` | `reference` |
| `interbank` | `interbank` |
| `parallel` | `parallel` |
| `securities` | `securities` |
| `crypto_p2p` | `p2p` |
| `crypto_exchange` | `crypto_exchange` |
| `crypto` | `crypto` |
| `bank_board` | `bank_board` |
| `remittance` | `remittance` |
| `cash` | `cash` |
| `card` | `card` |
| `exchange_house` | `exchange_house` |

## Otros objetos de respuesta

| Recurso | Campos | Significado |
| - | - | - |
| Conversión | `from`, `to`, `rate`, `via`, `market`, `type`, `updated_at`, `effective_date`, `date`, `stale`, `staleness_sec`, `legs` | Importe, ID global, mercado local, tipo y frescura. `stale` y `staleness_sec` siguen disponibles en Free. `legs` aparece en el cruce entre dos monedas locales y describe ambas referencias oficiales. |
| Histórico | `id`, `market`, `base`, `quote`, `date`, `from`, `to`, `granularity`, `count`, `next_cursor`, `points` | Identidad, rango y puntos. Cada punto tiene `date`, `mid`, `updated_at` y `fetched_at`; algunas fuentes incluyen `bid`/`ask`. |
| País | `code`, `name`, `flag`, `continent`, `region`, `region_code`, `currency`, `timezone`, `rates` | Identidad, geografía, moneda, zona horaria e IDs de tasas publicados. |
| Moneda | `code`, `numeric_code`, `name`, `minor_unit`, `symbol` | ISO alfabético y numérico, nombre, decimales monetarios y símbolo. |
| Banco | `country`, `code`, `name`, `type`, `bank_rates` | Identidad bancaria y, cuando existe, enlace relativo a su pizarra de tasas. |
| Feriado | `date`, `local_name`, `name`, `type`, `types`, `fixed`, `global` | Fecha, nombres, clasificación y alcance del feriado. |
| Día hábil | `country`, `from`, `days`, `result` | País, fecha inicial, cantidad solicitada y fecha resultante. |
| Spread | `reference`, `compared`, `spread`, `fetched_at` | Dos referencias y diferencia absoluta, porcentual y dirección. |
| Ruta | `country`, `from`, `direction`, `best`, `alternatives`, `skipped`, `fetched_at` | Mejor alternativa, alternativas, elementos descartados y motivo. |
| Índice de `VE` | `value`, `version`, `as_of`, `weights`, `components`, `p2p_median`, `p2p_count`, `flags`, `methodology_url` | Índice publicado únicamente como `index` en la colección venezolana de tasas. |
| Lote de conversiones | `count`, `succeeded`, `failed`, `results` | Totales y un resultado por entrada. Cada resultado incluye `index` y exactamente `conversion` o `error`. |

Consulta [tasas V2](https://docs.cotizave.com/api/v2/rates.md) para filtros y disponibilidad, [cobertura](https://docs.cotizave.com/api/v2/coverage.md) para IDs de tasas y [endpoints](https://docs.cotizave.com/api/v2/endpoints.md) para los parámetros válidos.


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