Get a list of all assets

curl --request GET \
  --url https://api.tokenterminal.com/v2/assets \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "asset_id": "<string>",
      "asset_type": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "coingecko_id": "<string>",
      "addresses": [
        {
          "chain_id": "<string>",
          "token_address": "<string>",
          "token_name": "<string>",
          "token_symbol": "<string>"
        }
      ],
      "products": [
        {
          "data_id": "<string>",
          "product_id": "<string>",
          "tags": [
            "<string>"
          ],
          "relation_to_the_project": "<string>"
        }
      ],
      "created_at": "<string>",
      "inserted_at": "<string>"
    }
  ]
}

GET

assets

curl --request GET \
  --url https://api.tokenterminal.com/v2/assets \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "asset_id": "<string>",
      "asset_type": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "coingecko_id": "<string>",
      "addresses": [
        {
          "chain_id": "<string>",
          "token_address": "<string>",
          "token_name": "<string>",
          "token_symbol": "<string>"
        }
      ],
      "products": [
        {
          "data_id": "<string>",
          "product_id": "<string>",
          "tags": [
            "<string>"
          ],
          "relation_to_the_project": "<string>"
        }
      ],
      "created_at": "<string>",
      "inserted_at": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

asset_ids

string[]

List of asset IDs to filter by.

Allows you to select one or more assets. When including multiple assets, separate each one with a comma. Example: usdc,usdt.

asset_types

string[]

List of asset types to filter by.

Allows you to filter assets by their type. When including multiple types, separate each one with a comma.

market_sectors

string[]

List of market sector IDs to filter assets by.

Allows you to select one or more market sectors to filter the results. Only assets belonging to any of the specified market sectors will be included. When including multiple market sectors, separate each one with a comma. Example: blockchains-l1,lending.

The full list of available market sectors can be retrieved from the /v2/market-sectors endpoint.

limit

integer

default:1000

Maximum number of assets to return.

Required range: 1 <= x <= 1000

offset

integer

default:0

Number of assets to skip for pagination.

Required range: x >= 0

Response

200 - application/json

data

object[]

Show child attributes

data.asset_id

string

Required input on the API when retrieving data for an asset.

data.asset_type

string | null

The type of the asset.

data.name

string

The asset's name.

data.symbol

string

The asset's ticker symbol.

data.coingecko_id

string | null

The Coingecko ID for the asset.

data.addresses

object[]

List of addresses where the asset exists across different chains.

Show child attributes

data.addresses.chain_id

string | null

The chain ID where the asset exists.

data.addresses.token_address

string | null

The token contract address on the chain.

data.addresses.token_name

string | null

The token name on the chain.

data.addresses.token_symbol

string | null

The token symbol on the chain.

data.products

object[]

List of products associated with this asset.

Show child attributes

data.products.data_id

string

The project data ID.

data.products.product_id

string

The product ID.

data.products.tags

string[]

Tags associated with the product.

data.products.relation_to_the_project

string | null

The relationship of the asset to the project (e.g., "issuer").

data.created_at

string

Timestamp when the asset was created.

data.inserted_at

string

Timestamp when the asset was inserted into the database.

⌘I

Overview

Endpoints

Get a list of all assets

Authorizations

Query Parameters

Response