The tokens table contains information about tokens: address, total_supply, reserve, metadata and more.

Field NameTypeDescription
addressString!The address of the token on the blockchain.
assetassetsAn object relationship representing the associated asset. This links the token to its corresponding asset.
asset_idIntThe ID of the associated asset, linking this token to a specific asset in the assets table.
chain_idString!The ID of the blockchain network where the token exists.
circulating_supplynumeric!The circulating supply of the token, representing the total amount currently in circulation.
created_attimestamp!The timestamp when the token was created.
decimalsInt!The number of decimal places the token can be divided into, typically used for calculations.
listed_attimestampThe timestamp when the token was listed on an exchange, indicating its availability for trading.
nameString!The name of the token, used to identify it.
price_usdfloat8The current price of the token in USD, reflecting its market value.
reserve_usdfloat8!The reserve value of the token in USD, representing the backing or reserve for the token.
symbolString!The symbol of the token, such as ETH for Ethereum, used for trading and identification.
total_supplynumeric!The total supply of the token, representing the maximum amount that can exist.
total_supply_enabledBoolean!Indicates if the total supply of the token is enabled or fixed, controlling its issuance.
updated_attimestamp!The timestamp when the token’s information was last updated.
volume_24h_usdfloat8!The trading volume of the token over the last 24 hours in USD, indicating market activity.

Query examples

Query all tokens

query {
  tokens {
    address
    name
    symbol
    price_usd
    total_supply
  }
}

Query a specific token

query {
  tokens(where: { symbol: { _eq: "ETH" } }) {
    address
    name
    symbol
    price_usd
    total_supply
  }
}

Query tokens with pagination

query {
  tokens(limit: 10, offset: 10) {
    address
    name
    symbol
    price_usd
    total_supply
  }
}

Query tokens with ordering

query {
  tokens(order_by: { price_usd: desc }) {
    address
    name
    symbol
    price_usd
    total_supply
  }
}

Query tokens with filtering

query {
  tokens(where: { total_supply: { _gt: 1000000 } }) {
    address
    name
    symbol
    price_usd
    total_supply
  }
}
query {
  tokens {
    address
    name
    symbol
    price_usd
    total_supply
    asset {
      name
      symbol
      price_usd
      market_cap_usd
    }
  }
}