Skip to main content

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

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

Trading API and EVM addresses

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

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

Subscribe to Tokens where currency id includes arbitrum, 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: "arbitrum"}}, 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 Arbitrum?​

Use limit: { count: 1 }, orderBy: { descending: Block_Time }, and filter Token.Id with includesCaseInsensitive (e.g. arbitrum: + 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: "arbitrum:0x97e66d3c4d5bcd7c64e3e55af28544c9addf9281"}}, 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 arbitrum:<contract_address> id (lowercase hex).

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

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

You can run this subscription in the Bitquery IDE.

subscription {
  Trading {
    Tokens(
      where: {Token: {Id: {includesCaseInsensitive: "arbitrum"}}, 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 Arbitrum tokens by market cap?​

This query ranks Arbitrum 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: "Arbitrum" } }
      }
    ) {
      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 Arbitrum 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 Arbitrum.

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