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

List all tokens

get

Responses

200

A list of tokens

application/json

totalCountintegerOptional

get

/tokens

HTTPcURLJavaScriptPython

GET /v1/tokens HTTP/1.1
Host: api.pareto.credit
Accept: */*

200

A list of tokens

{
  "data": [
    {
      "_id": "text",
      "name": "text",
      "symbol": "text",
      "decimals": 1,
      "address": "text",
      "chainId": "text",
      "logoURI": "text",
      "underlying": true,
      "createdAt": "2026-03-20T11:46:40.373Z",
      "updatedAt": "2026-03-20T11:46:40.373Z",
      "createdBy": "text",
      "updatedBy": "text"
    }
  ],
  "totalCount": 1
}

Get token by ID

get

Path parameters

tokenIdstringRequired

Responses

200

Token details

application/json

_idstringOptional

namestringOptional

symbolstringOptional

decimalsnumberOptional

addressstringOptional

chainIdstringOptional

logoURIstringOptional

underlyingbooleanOptional

createdAtstring · date-timeOptional

updatedAtstring · date-timeOptional

createdBystringOptional

updatedBystringOptional

get

/tokens/{tokenId}

HTTPcURLJavaScriptPython

GET /v1/tokens/{tokenId} HTTP/1.1
Host: api.pareto.credit
Accept: */*

200

Token details

{
  "_id": "text",
  "name": "text",
  "symbol": "text",
  "decimals": 1,
  "address": "text",
  "chainId": "text",
  "logoURI": "text",
  "underlying": true,
  "createdAt": "2026-03-20T11:46:40.373Z",
  "updatedAt": "2026-03-20T11:46:40.373Z",
  "createdBy": "text",
  "updatedBy": "text"
}