Skip to main content

Ethereum Token Market Cap API

Use Bitquery’s Trading API Tokens cube to stream or query market cap, fully diluted valuation (USD), total supply, price (OHLC and averages), and volume for tokens traded on Ethereum. Rows are tied to a time interval; filter Ethereum assets via token/currency Id (for example eth: plus the contract address).

For schema details and field meanings, see the Tokens cube and Supply fields.

Trading API and EVM addresses

In the Trading API, use lowercase hex for EVM contract addresses in token/currency Id values (e.g. eth:0xabc…, not checksum 0xAbC…).

How do I stream live Ethereum token market cap, price, and volume?​

Subscribe to Tokens updates for assets whose currency id includes eth (Ethereum), with an interval duration greater than 1 (second). Each payload can include token metadata, block time, supply (including MarketCap and FullyDilutedValuationUsd), price (OHLC and average mean), and volume.

You can run this subscription in the Bitquery IDE.

subscription MyQuery {
  Trading {
    Tokens(
      where: {
        Currency: { Id: { includes: "eth" } }
        Interval: { Time: { Duration: { gt: 1 } } }
      }
    ) {
      Token {
        Name
        Id
        Address
        Symbol
      }
      Block {
        Time
      }
      Supply {
        TotalSupply
        FullyDilutedValuationUsd
        MarketCap
      }
      Price {
        Average {
          Mean
        }
        Ohlc {
          Open
          Low
          High
          Close
        }
      }
      Volume {
        Base
        BaseAttributedToUsd
        Quote
        Usd
      }
    }
  }
}

How do I get the latest market cap for a specific Ethereum token?​

Return the most recent row for one token by Token.Id (e.g. eth: + lowercase contract address). Use limit: { count: 1 } and orderBy: { descending: Block_Time }.

You can run this query in the Bitquery IDE.

query {
  Trading {
    Tokens(
      limit: { count: 1 }
      orderBy: { descending: Block_Time }
      where: {
        Token: {
          Id: { includes: "eth:0xe53ec727dbdeb9e2d5456c3be40cff031ab40a55" }
        }
        Interval: { Time: { Duration: { gt: 1 } } }
      }
    ) {
      Token {
        Name
        Id
        Address
        Symbol
      }
      Block {
        Time
      }
      Supply {
        TotalSupply
        FullyDilutedValuationUsd
        MarketCap
      }
      Price {
        Average {
          Mean
        }
        Ohlc {
          Open
          Low
          High
          Close
        }
      }
      Volume {
        Base
        BaseAttributedToUsd
        Quote
        Usd
      }
    }
  }
}

Replace the includesCaseInsensitive value with your token’s eth:<contract_address> id.

How do I stream Ethereum tokens with market cap above $1 million?​

Subscribe to Tokens where the token id matches Ethereum (eth) and Supply.MarketCap is greater than 1,000,000 (USD). The example selects currency, supply, and market cap fields suitable for dashboards and alerts.

You can run this subscription in the Bitquery IDE.

subscription {
  Trading {
    Tokens(
      where: {
        Token: { Id: { includes: "eth" } }
        Interval: { Time: { Duration: { gt: 1 } } }
        Supply: { MarketCap: { gt: 1000000 } }
      }
    ) {
      Currency {
        Name
        Id
        Symbol
      }
      Supply {
        TotalSupply
        FullyDilutedValuationUsd
        MarketCap
      }
    }
  }
}
Threshold and interval

Adjust Supply.MarketCap and Interval.Time.Duration filters to match your use case. See Tokens cube for other filter fields.

How do I get top Ethereum tokens by market cap?​

This query ranks Ethereum tokens by Supply.MarketCap (latest in the window). It uses data from roughly the last 24 hours (since_relative: { hours_ago: 24 }), 1-second intervals (Duration: { eq: 1 }), at least $1,000 USD volume, limitBy one row per Token_Id, and returns up to 50 tokens.

You can run this query in the Bitquery IDE.

{
  Trading {
    Tokens(
      limit: { count: 50 }
      limitBy: { count: 1, by: Token_Id }
      orderBy: { descending: Supply_MarketCap }
      where: {
        Block: { Time: { since_relative: { hours_ago: 24 } } }
        Interval: { Time: { Duration: { eq: 1 } } }
        Volume: { Usd: { gt: 1000 } }
        Token: { Network: { is: "Ethereum" } }
      }
    ) {
      Currency {
        Id
        Name
        Symbol
      }
      Price {
        Average {
          Mean(maximum: Block_Time)
        }
      }
      Volume {
        Base(maximum: Block_Time)
        Quote(maximum: Block_Time)
        Usd(maximum: Block_Time)
      }
      Token {
        Network
        Symbol
        Address
      }
      Supply {
        MarketCap(maximum: Block_Time)
        FullyDilutedValuationUsd(maximum: Block_Time)
        TotalSupply(maximum: Block_Time)
      }
    }
  }
}

How do I get top Ethereum tokens by market cap change in 1 hour?​

This query uses a 1-hour OHLC interval (Duration: { eq: 3600 }) and orders by a calculated field change_mcap: (close − open) × total supply, approximating USD market cap change over the period. Filter Token.Network is Ethereum.

You can run this query in the Bitquery IDE.

{
  Trading {
    Tokens(
      limit: { count: 50 }
      orderBy: { descendingByField: "change_mcap" }
      where: {
        Interval: { Time: { Duration: { eq: 3600 } } }
        Token: { Network: { is: "Ethereum" } }
      }
    ) {
      Currency {
        Id
        Name
        Symbol
      }
      Token {
        Network
        Symbol
        Address
      }
      Supply {
        MarketCap
        FullyDilutedValuationUsd
        CirculatingSupply
        TotalSupply
        MaxSupply
      }
      change_mcap: calculate(
        expression: "($Price_Ohlc_Close-$Price_Ohlc_Open) * Supply_TotalSupply"
      )
      Price {
        Ohlc {
          Open
          Close
        }
      }
    }
  }
}

Video tutorial​