Tokens Cube

Looking for one token's price? Use the Pairs cube with rank 1

The price on this cube is a volume-weighted blend of every pool where the token is the base asset. That is what you want for a chain-wide number or a firehose of all tokens on a chain. But for a specific token — especially one whose liquidity is spread across many pools — thin pools contribute to the blend and can pull the price away from where the token actually trades. For a single token's price, query the Pairs cube with Ranking: { Position: { eq: 1 } } to get the quote from its top market.

The Tokens cube provides chain-specific, aggregated price and volume data for individual tokens. For a query example that returns tokens with volume and average price over the last 24h (including conditional metrics for 1h, 4h, 24h), see Aggregated Token Data or the Crypto Price API examples.

Fields in the Schema

subscription {
  Trading {
    Tokens(where: { Interval: { Time: { Duration: { eq: 60 } } } }) {
      Token {
        Address
        Id
        IsNative
        Name
        Network
        Symbol
        TokenId
      }
      Block {
        Date
        Time
        Timestamp
      }
      Interval {
        Time {
          Start
          Duration
          End
        }
      }
      Volume {
        Base # Volume of the token itself
        Quote # Volume of all tokens it traded against
        Usd # Combined USD volume across all trades
      }
      Supply {
        TotalSupply
        FullyDilutedValuationUsd
        MarketCap
      }
      Price {
        IsQuotedInUsd # Whether price values are in USD (true/false)
        Ohlc {
          Open
          High
          Low
          Close
        }
        Average {
          Mean
          SimpleMoving
          WeightedSimpleMoving
          ExponentialMoving
        }
      }
      Currency {
        Name
        Symbol
        Id
      }
    }
  }
}

Key Points to Understand:

• What is the Tokens Cube?
  The Tokens cube provides chain-specific, aggregated price and volume data for individual tokens. This includes OHLC values, moving averages, and volume across all pairs the token is traded with.

• Volume Section Explained:

  • Base: Volume of the token itself (the token in question) for all pairs.
  • Quote: Sum of quote token amounts (the tokens it traded against). This is not USD—for USD amounts use Usd. (As of March 11 2026, see Price Index Algorithm.)
  • Usd: Total volume in USD. Use this when you need USD amounts.

• IsQuotedInUsd:
  A boolean indicating whether the OHLC and average prices are expressed in USD (true) or in the quote token's value (false).

• Clarification on "Quote":
  The Tokens cube does not show the specific quote tokens used in each trade. Instead, it aggregates across all pairs the token is involved in—regardless of which token acted as the quote in those trades.

• If you need pair-level granularity (i.e., to know exactly which token was the quote in a specific pair), use the Pairs Cube instead.

• Where the blend can mislead: because every pool contributes in proportion to its decay-weighted volume, tokens with fragmented liquidity (one primary pool plus a tail of thin ones) can report a price that drifts from the primary market. Check Ranking.Weight on the Pairs cube: a top-market weight near 1 means the blend is effectively one pool and this cube's price is equivalent; a low weight means you should price the token from its rank-1 market instead.

• Supply: Currency-level metrics for the asset (aggregated across chains); price and volume on the row remain chain-specific. See Supply fields reference for each subfield (CirculatingSupply, TotalSupply, MaxSupply, MarketCap, FullyDilutedValuationUsd).

Field notes

Price.Average.Estimate — the valuation price

Estimate is the price the supply valuations are built from: Supply.FullyDilutedValuationUsd is TotalSupply x Estimate, and MarketCap is CirculatingSupply x Estimate. If you are reconciling a market cap, use Estimate — not Mean, and not Ohlc.Close.

Volume.BaseAttributedToUsd

The portion of base-token volume the index could attribute to a USD value. It is always less than or equal to Volume.Base; how often the two are equal varies by chain. Use it when you need volume you can trust a USD figure for.

Ranking

Ranking.Position and Ranking.Weight are present on Tokens as well as Pairs. See how Position and Weight behave.

Identity fields

Field	Notes
Token.Id	Chain-qualified: bid:<chain>:<address>. A bare address returns 0 rows silently — use Token.Address for a raw address
Token.Address	The raw contract address. Empty for native assets
Token.NetworkBid	Populated — the chain bid, e.g. bid:solana
Token.Did	A chain-level DID, empty on essentially every row. Not a per-token identifier
Token.Decimals	Does not exist on this cube

Price.IsQuotedInUsd is a constant true here — filtering on false returns nothing.

(Token.Id, Interval.Time.Start) is not a unique key

A small share of mints return two rows for the same token and bar. The duplicates are identical on identity and ranking and differ only in mutable metadata — typically one row has an empty Token.Symbol while the other has arrived — which is a metadata-arrival split on freshly launched tokens.

Aggregate by Token.Id rather than treating one row as one token. Do not build a natural key from metadata columns: Symbol can change.