Data dictionary - Cotizave

This dictionary explains V2 values. Amounts and rates are JSON numbers: use decimal arithmetic and your application’s rounding policy.

Currencies and codes

Code	Currency	V2 use
`USD`	United States dollar	Base of most references.
`VES`	Venezuelan bolívar	Quoted currency for `VE`.
`COP`	Colombian peso	Quoted currency for `CO`.
`PEN`	Peruvian sol	Quoted currency for `PE`.
`MXN`	Mexican peso	Quoted currency for `MX`.
`ARS`	Argentine peso	Quoted currency for `AR`.
`CAD`	Canadian dollar	Quoted currency for `CA`.
`EUR`	euro	Quoted currency for `ES` and `PT`, and base of some references.
`USDT`, `USDC`, `EURC`	stable assets	Bases of stable references where applicable.

base is the currency of one reference unit and quote is the currency used to express that unit. Example: base=USD, quote=COP, mid=4000 means 4,000 COP per 1 USD.

Rate object

Field	Meaning
`id` / `market`	Canonical global ID (`co-trm`) and stable local identifier (`co_trm`). In VE `market` keeps its V1 value.
`name` / `description`	The reference’s visible name and explanation.
`type`	Public type. `official` is presented as `reference`, and `crypto_p2p` as `p2p`; the `?category=` filter retains internal values. See endpoints.
`base`, `quote`, `mid`, `bid`, `ask`	Currency pair, central reference, and published buy/sell sides where available. `null` does not mean zero.
`updated_at`, `effective_date`, `fetched_at`	Source instant, value date, and capture, storage, or response-build time, depending on the resource. In V2’s own daily history, `fetched_at` is stable while the point does not change; depending on the resource it can vary between requests. `index.as_of` keeps its own name.
`stale`, `stale_after_sec`, `staleness_sec`	Freshness state, freshness threshold, and age in seconds.
`change_24h_pct`, `vs_official_pct`	Change versus 24 hours and difference versus a comparable official reference; they can be `null` or omitted.
`tags`	Classification and filter labels.
`available`, `required_plan`	Account availability and minimum internal plan (`free`, `hobby`, `indie`, `pro`). Their presence depends on the plan.
`conversion_directions`	Only in `/markets`: `{from,to}` pairs accepted by `/convert` for this rate. `[]` means the rate is not convertible; it does not guarantee access or a current price.

Filter category and public type

?category= keeps the internal filter names. A rate’s JSON contains type; the values below follow the backend mapping. Do not transform other categories by string rules or assume a category means a rate is published in your country.

Filter `category`	Response `type`
`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`

Other response objects

Resource	Fields	Meaning
Conversion	`from`, `to`, `rate`, `via`, `market`, `type`, `updated_at`, `effective_date`, `date`, `stale`, `staleness_sec`, `legs`	Amount, global ID, local market, type, and freshness. `stale` and `staleness_sec` remain available on Free. `legs` appears for a cross between two local currencies and describes both official references.
History	`id`, `market`, `base`, `quote`, `date`, `from`, `to`, `granularity`, `count`, `next_cursor`, `points`	Identity, range, and points. Each point has `date`, `mid`, `updated_at`, and `fetched_at`; some sources include `bid`/`ask`.
Country	`code`, `name`, `flag`, `continent`, `region`, `region_code`, `currency`, `timezone`, `rates`	Identity, geography, currency, timezone, and published rate IDs.
Currency	`code`, `numeric_code`, `name`, `minor_unit`, `symbol`	Alphabetic and numeric ISO codes, name, monetary decimals, and symbol.
Bank	`country`, `code`, `name`, `type`, `bank_rates`	Bank identity and, where available, relative link to its rate board.
Holiday	`date`, `local_name`, `name`, `type`, `types`, `fixed`, `global`	Date, names, classification, and holiday scope.
Business day	`country`, `from`, `days`, `result`	Country, initial date, requested count, and resulting date.
Spread	`reference`, `compared`, `spread`, `fetched_at`	Two references and absolute, percentage, and direction difference.
Route	`country`, `from`, `direction`, `best`, `alternatives`, `skipped`, `fetched_at`	Best alternative, alternatives, skipped items and reason.
`VE` index	`value`, `version`, `as_of`, `weights`, `components`, `p2p_median`, `p2p_count`, `flags`, `methodology_url`	Index published only as `index` in the Venezuelan rate collection.
Conversion batch	`count`, `succeeded`, `failed`, `results`	Totals and one result per input. Each result includes `index` and exactly one of `conversion` or `error`.

Read V2 rates for filters and availability, coverage for rate IDs, and endpoints for valid parameters.