Diccionario de datos - Cotizave

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.
`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.
`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 para filtros y disponibilidad, cobertura para IDs de tasas y endpoints para los parámetros válidos.