> For the complete documentation index, see [llms.txt](https://docs.pareto.credit/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pareto.credit/developers/api/tokens.md).

# Tokens

Tokens are ERC-20 compatible assets used in vaults and tracked by the Pareto protocol across multiple chains.

## Structure

Each token object includes:

* `_id` *(string)* — Unique identifier
* `name` *(string)* — Name of the token
* `symbol` *(string)* — Token symbol (e.g. USDC, WETH)
* `chainId` *(string)* — Chain this token belongs to
* `address` *(string)* — On-chain contract address (0x...)
* `decimals` *(number)* — Token decimal precision
* `color` *(string)* — UI color reference for this token
* `oracle` *(object)* — Price oracle metadata:
  * `address` *(string)* — Oracle contract address
  * `abi` *(array)* — Oracle ABI definition
  * `protocol` *(string)* — Data source (e.g., Idle, AaveV2, Morpho, Clearpool)
  * `fee` *(number, optional)* — Optional oracle fee
  * Additional optional config fields (e.g. `fromBlock`, `USDCAddress`, ...)
* `createdAt`, `updatedAt` *(string)* — ISO timestamps
* `createdBy`, `updatedBy` *(string)* — System actor IDs

## Endpoints

{% openapi src="/files/wYckWbLK8GpnaRCIbupX" path="/tokens" method="get" %}
[Tokens.yaml](https://4223418165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVSPclqPyChB4NMxFfG2X%2Fuploads%2FMRT60r5LlV5Qc5ADOO9j%2FTokens.yaml?alt=media\&token=7e55e202-cd98-4fd6-ae42-23c31451189d)
{% endopenapi %}

{% openapi src="/files/wYckWbLK8GpnaRCIbupX" path="/tokens/{tokenId}" method="get" %}
[Tokens.yaml](https://4223418165-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVSPclqPyChB4NMxFfG2X%2Fuploads%2FMRT60r5LlV5Qc5ADOO9j%2FTokens.yaml?alt=media\&token=7e55e202-cd98-4fd6-ae42-23c31451189d)
{% endopenapi %}