Skip to main content

Base 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 Base. Filter Base assets with token/currency Id values such as base: plus a lowercase contract address.

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

Trading API and EVM addresses

On Base (EVM), the Trading API expects lowercase hex in Id values (e.g. base:0x1f1c…, not mixed-case checksum addresses).

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

Subscribe to Tokens where currency id includes base, with interval duration greater than 1 (second). You get token fields, block time, supply (MarketCap, FullyDilutedValuationUsd), price (OHLC and mean), and volume.

You can run this subscription in the Bitquery IDE.

subscription MyQuery {
  Trading {
    Tokens(
      where: {Currency: {Id: {includes: "base"}}, 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 token on Base?​

Use limit: { count: 1 }, orderBy: { descending: Block_Time }, and filter Token.Id with includesCaseInsensitive (e.g. base: + lowercase contract).

You can run this query in the Bitquery IDE.

query {
  Trading {
    Tokens(
      limit: { count: 1 }
      orderBy: { descending: Block_Time }
      where: {Token: {Id: {includesCaseInsensitive: "base:0x1f1c695f6b4a3f8b05f2492cef9474afb6d6ad69"}}, 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 base:<contract_address> id (lowercase hex).

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

Subscribe when Token.Id matches Base (base) and Supply.MarketCap > 1,000,000 (USD).

You can run this subscription in the Bitquery IDE.

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

Tune Supply.MarketCap and Interval.Time.Duration for your alerts or dashboards. See Tokens cube for more filters.

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

This query ranks Base tokens by Supply.MarketCap. It uses roughly the last 24 hours (since_relative: { hours_ago: 24 }), 1-second intervals, at least $1,000 USD volume, limitBy one row per Token_Id, and 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: "Base" } }
      }
    ) {
      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 Base tokens by market cap change in 1 hour?​

Uses a 1-hour OHLC interval (Duration: { eq: 3600 }) and orders by change_mcap: (close − open) × total supply. Token.Network is Base.

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: "Base" } }
      }
    ) {
      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
        }
      }
    }
  }
}