List assets

List supported assets and tokens.

GEThttps://api-v2.syncrone.fi/api/catalog/assets

Every token a catalog vault takes as deposit, once per network, with its USD price and currency group.

← Vaults API overview

Try it#

GET/assets?perPage=3&network=mainnet

API keyx-api-key

Kept in this browser tab only, and sent to Syncrone with each request. No key yet? Create one ↗

Parameters

pagequery

perPagequery

networkquery

Response

Paste an API key, then press Send. The parameters are pre-filled with a real example.

curl

curl "https://api-v2.syncrone.fi/api/catalog/assets?perPage=3&network=mainnet" \
  -H "x-api-key: $SYNCRONE_API_KEY"

Example#

A real response to the pre-filled Try it request, recorded from Syncrone data. Values move with every indexing run.

200GET /assets?perPage=3&network=mainnet

{
  "itemsOnPage": 3,
  "nextPage": 1,
  "data": [
    {
      "address": "0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9",
      "assetCaip": "eip155:1/erc20:0x7Fc66500c84A76Ad7e9c93437bFc5Ac33E2DDaE9",
      "name": "Aave Token",
      "symbol": "AAVE",
      "decimals": 18,
      "assetLogo": "https://static.debank.com/image/eth_token/logo_url/0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9/7baf403c819f679dc1c6571d9d978f21.png",
      "assetPriceInUsd": "156.8663",
      "assetGroup": "OTHER",
      "network": {
        "name": "mainnet",
        "chainId": 1,
        "networkCaip": "eip155:1"
      }
    },
    {
      "address": "0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf",
      "assetCaip": "eip155:1/erc20:0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf",
      "name": "Coinbase Wrapped BTC",
      "symbol": "cbBTC",
      "decimals": 8,
      "assetLogo": "https://static.debank.com/image/eth_token/logo_url/0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf/a4ae837a6ca2fc45f07a74898cc4ba45.png",
      "assetPriceInUsd": "81698.433",
      "assetGroup": "BTC",
      "network": {
        "name": "mainnet",
        "chainId": 1,
        "networkCaip": "eip155:1"
      }
    },
    {
      "address": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
      "assetCaip": "eip155:1/erc20:0x6B175474E89094C44Da98b954EedeAC495271d0F",
      "name": "Dai Stablecoin",
      "symbol": "DAI",
      "decimals": 18,
      "assetLogo": "https://static.debank.com/image/eth_token/logo_url/0x6b175474e89094c44da98b954eedeac495271d0f/549c4205dbb199f1b8b03af783f35e71.png",
      "assetPriceInUsd": "0.9999",
      "assetGroup": "USD",
      "network": {
        "name": "mainnet",
        "chainId": 1,
        "networkCaip": "eip155:1"
      }
    }
  ]
}

Parameters#

Name	Type	Description
pagequery	`integer`	Page number, starting from 0. default: 0
perPagequery	`integer`	Items per page, 1 to 1000. default: 50
networkquery	`string`	Only assets on this network (name, CAIP-2 id or chain id).

Response#

200 returns JSON with these fields. APY values are fractions (0.04 = 4%); timestamps are Unix seconds.

Field	Type	Description
itemsOnPage	`integer`	Number of items in `data`.
nextPage	`integer`	Next page number. Absent on the last page.
data[].address	`string`	Token address, checksummed.
data[].assetCaip	`string`	CAIP-19 id of the token.
data[].name	`string`	Token name.
data[].symbol	`string`	Token symbol.
data[].decimals	`integer`	Token decimals.
data[].assetLogo	`string \| null`	Logo URL.
data[].assetPriceInUsd	`string \| null`	USD price on the vault's latest bar: USD TVL divided by native TVL.
data[].assetGroup	`string`	`USD`, `ETH`, `BTC`, `EUR` or `OTHER`: the currency the asset is worth, from its price against $1, ETH and BTC.
data[].network.name	`string`	Network name.
data[].network.chainId	`integer`	EVM chain id.
data[].network.networkCaip	`string`	CAIP-2 id, e.g. `eip155:1`.

Errors#

Status	Meaning
400	Invalid query or path parameter, or unknown network.
401	Missing or rejected API key.
429	Too many requests from the docs playground. Wait a minute.
500	The service failed.

Error bodies carry error and, for invalid parameters, details.

← PreviousList vaults Next →List networks