Skip to main content

Polygon (Matic) 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 on Polygon (network id matic in the Trading API). Filter with matic: plus a lowercase contract address in Token.Id / Currency.Id.

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

Trading API and EVM addresses

On Polygon (matic in Trading), use lowercase hex in Id values (e.g. matic:0xeb51…, not mixed-case checksum addresses).

How do I stream live Polygon (Matic) token market cap, price, and volume?​

Subscribe to Tokens where currency id includes matic, with interval duration greater than 1 (second).

You can run this subscription in the Bitquery IDE.

subscription MyQuery {
  Trading {
    Tokens(
      where: {
        Currency: { Id: { includes: "matic" } }
        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 Polygon?​

Use limit: { count: 1 }, orderBy: { descending: Block_Time }, and filter Token.Id with includes (or includesCaseInsensitive) for matic: + lowercase contract.

You can run this query in the Bitquery IDE.

query {
  Trading {
    Tokens(
      limit: { count: 1 }
      orderBy: { descending: Block_Time }
      where: {
        Token: {
          Id: { includes: "matic:0xeb51d9a39ad5eef215dc0bf39a8821ff804a0f01" }
        }
        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 includes value with your token’s matic:<contract_address> id (lowercase hex).

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

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

You can run this subscription in the Bitquery IDE.

subscription {
  Trading {
    Tokens(
      where: {
        Token: { Id: { includesCaseInsensitive: "matic" } }
        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 Polygon (Matic) tokens by market cap?​

This query ranks Polygon tokens by Supply.MarketCap. Set Token.Network to Matic (Polygon’s label in the Trading API). It uses roughly the last 24 hours, 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: "Matic" } }
      }
    ) {
      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 Polygon 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 Matic.

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