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

# Planes de API V2: acceso y campos por nivel

> Compara Free, Basic, Growth y Pro para saber qué campos, mercados y operaciones V2 puede consultar cada plan.

Los IDs internos de los cuatro planes públicos son `free` (Free), `hobby` (Basic), `indie` (Growth) y `pro` (Pro). Las colecciones `/rates` y `/v2/crypto` incluyen `plan`; las respuestas individuales y otras operaciones no lo incluyen necesariamente. El acceso a una **tasa** y el acceso a sus **metadatos** son decisiones distintas.

## Campos de `/rates` y `/rates/{id}`

| Campos de una tasa disponible | Free | Basic | Growth | Pro |
| - | - | - | - | - |
| `id`, `market`, `type`, `mid`, `updated_at` | Sí | Sí | Sí | Sí |
| `base`, `bid`, `ask`, `effective_date`, `stale_after_sec` | Cuando el dato y el contrato heredado los incluyen | Sí, cuando existen | Sí, cuando existen | Sí, cuando existen |
| `name`, `quote`, `stale`, `staleness_sec`, `available` | No | Sí | Sí | Sí |
| `description`, `tags`, `change_24h_pct`, `vs_official_pct`, `required_plan` | No | No | Sí | Sí |

`change_24h_pct` y `vs_official_pct` pueden ser `null` si falta un punto comparable. `fetched_at` está en la raíz de la colección para todos los planes; en una tasa individual aparece desde Growth. La omisión de `stale_after_sec` en tasas venezolanas conserva la regla de V1. Estas reglas de campos son propias de las respuestas de tasas: `GET /v2/fx/convert` conserva `stale` y `staleness_sec` incluso en Free.

Cuando una tasa venezolana está restringida, Free ve solo `{ "id": "..." }` en la colección; Basic ve `id`, `market`, `type`, `name`, `quote` y `available: false`; Growth ve además la descripción, etiquetas y `required_plan`. Ningún descriptor contiene precio ni fecha de actualización. La consulta individual responde `402 feature_not_in_plan`.

### La misma tasa en cada plan

Estos objetos ilustran la fila `co-trm` de `GET /v2/fx/CO/rates` con los mismos datos de origen y el mismo instante de consulta. Las cifras son ilustrativas. Free y Basic omiten `bid` y `ask` cuando la fuente no los publica; Growth y Pro los serializan como `null`.

Free:

```json theme={null}
{
  "id": "co-trm",
  "market": "co_trm",
  "type": "reference",
  "base": "USD",
  "mid": 3900.12,
  "updated_at": "2026-10-25T00:00:00Z",
  "effective_date": "2026-10-25"
}
```

Basic:

```json theme={null}
{
  "id": "co-trm",
  "market": "co_trm",
  "type": "reference",
  "base": "USD",
  "mid": 3900.12,
  "updated_at": "2026-10-25T00:00:00Z",
  "effective_date": "2026-10-25",
  "name": "TRM",
  "quote": "COP",
  "stale": false,
  "stale_after_sec": 475200,
  "staleness_sec": 43200,
  "available": true
}
```

Growth:

```json theme={null}
{
  "id": "co-trm",
  "market": "co_trm",
  "type": "reference",
  "base": "USD",
  "mid": 3900.12,
  "updated_at": "2026-10-25T00:00:00Z",
  "effective_date": "2026-10-25",
  "name": "TRM",
  "quote": "COP",
  "stale": false,
  "stale_after_sec": 475200,
  "staleness_sec": 43200,
  "available": true,
  "description": "Tasa Representativa del Mercado (TRM) que certifica la Superintendencia Financiera: la oficial para contratos, contabilidad e impuestos. Rige por día; la de un fin de semana es la del viernes.",
  "bid": null,
  "ask": null,
  "change_24h_pct": null,
  "vs_official_pct": null,
  "tags": [
    "trm",
    "oficial"
  ],
  "required_plan": "free"
}
```

Pro entrega los mismos campos de tasa que Growth. Consulta la [matriz por ID](https://docs.cotizave.com/api/v2/rates-by-plan.md) para ver los mercados y permisos.

## Funciones por plan

| Operación o capacidad | Free | Basic | Growth | Pro |
| - | - | - | - | - |
| Tasas base, conversión actual, histórico por fecha sujeto a retención, bancos y pizarra BCV | Sí | Sí | Sí | Sí |
| Tasas oficiales multipaís, límites de histórico, estadísticas, medias móviles y tablero por fecha, sujetos a retención | Sí | Sí | Sí | Sí |
| Directorio de emisores oficiales `/v2/issuers` | Sí | Sí | Sí | Sí |
| Feriados y cálculo de días hábiles en V2 | No | Sí | Sí | Sí |
| CSV/XML, conversión histórica, catálogo de mercados, spread y márgenes | No | No | Sí | Sí |
| Remesas y mercados ampliados de Venezuela; referencias individuales de `/v2/crypto` | No | No | Sí | Sí |
| Efectivo y frontera de Venezuela, rutas, conversión masiva, catálogos de países y monedas | No | No | No | Sí |

La colección `/v2/crypto` muestra descriptores a Free y Basic; el detalle requiere Growth. Basic comparte los permisos de rutas V2 de Free, pero obtiene los campos adicionales indicados arriba, más retención y límites propios. El histórico permite hasta 3 días en Free, 90 en Basic, 180 en Growth y 365 en Pro; la existencia de una observación depende de la fuente. Las cuotas y límites de velocidad se describen en [cuotas](https://docs.cotizave.com/api/rate-limits.md) y se comparten entre V1 y V2.

## Países y mercados

Fuera de Venezuela, todas las tasas **publicadas y aprobadas** están disponibles desde Free. Venezuela mantiene sus restricciones: PayPal y Zelle desde Growth; Syklo, Yadio, Zoom y Western Union desde Growth; efectivo (`ve-cash`) y frontera (`ve-cucuta`) desde Pro.

### Tasas por país y plan

[Ver la matriz completa por tasa y plan](https://docs.cotizave.com/api/v2/rates-by-plan.md).

La disponibilidad de un precio depende de la fuente y puede cambiar; consulta el recurso individual para comprobarlo.


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