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

# Data dictionary

> Understand Cotizave V2 responses: currency codes, exchange rates, JSON fields and objects. Review their meaning and considerations for precision and rounding.

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](https://docs.cotizave.com/en/api/v2/endpoints.md). |
| `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](https://docs.cotizave.com/en/api/v2/plans.md). |
| `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](https://docs.cotizave.com/en/api/v2/rates.md) for filters and availability, [coverage](https://docs.cotizave.com/en/api/v2/coverage.md) for rate IDs, and [endpoints](https://docs.cotizave.com/en/api/v2/endpoints.md) for valid parameters.


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