Planes de API V2: acceso y campos por nivel

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:

{
  "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:

{
  "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:

{
  "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 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 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. La disponibilidad de un precio depende de la fuente y puede cambiar; consulta el recurso individual para comprobarlo.

Documentación

Empezar

API

API V2

API V1 · Deprecada

Índices

Guías

Planes de API V2: acceso y campos por nivel

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

La misma tasa en cada plan

Funciones por plan

Países y mercados

Tasas por país y plan

Campos de /rates y /rates/{id}

La misma tasa en cada plan

Funciones por plan

Países y mercados

Tasas por país y plan

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