Skip to main content

Solana Token Supply API

In this section we will see how to get Solana Token Supply information using our API.

Supply metrics are part of the broader Token API — transfers, supply and new token creation across chains.

ProductUsing this in production? See the Token API page for plans, free trial and enterprise delivery options.

Overview​

The Solana Token Supply API provides comprehensive access to real-time token supply data on the Solana blockchain. This API enables you to track token creation, monitor supply changes, calculate market capitalization, and analyze token burn events with detailed metadata and real-time updates.

📋 Table of Contents​

🔗 Related Solana APIs​

Subscribe to Token Supply Changes​

This subscription will return the token supply changes in realtime. PostBalance will give you the current supply. Check the query here

For tracking the instructions that cause these supply changes (like token creation and burning), see our Solana Instructions API.

subscription {
  Solana {
    TokenSupplyUpdates {
      TokenSupplyUpdate {
        Amount
        Currency {
          MintAddress
          Name
        }

        PreBalance
        PostBalance
      }
    }
  }
}

Get Supply of specific Token​

This query will return the latest token supply of a specific token. We are getting here supply for this 6D7NaB2xsLd7cauWu1wKk6KBsJohJmP2qZH9GEfVi5Ui token PostBalance will give you the current supply for this token. Check the query here

{
  Solana {
    TokenSupplyUpdates(
      limit: { count: 1 }
      orderBy: { descending: Block_Time }
      where: {
        TokenSupplyUpdate: {
          Currency: { MintAddress: { is: "token mint address" } }
        }
      }
    ) {
      TokenSupplyUpdate {
        Amount
        Currency {
          MintAddress
          Name
        }
        PreBalance
        PostBalance
      }
    }
  }
}

Token Creation Tracking​

Get newly created Pump Fun tokens, Creation Time, Dev Address, Metadata​

Now you can track the newly created Pump Fun Tokens along with their dev address, metadata and supply. PostBalance will give you the current supply for the token. Check the query here

subscription {
  Solana {
    TokenSupplyUpdates(
      where: {
        Instruction: {
          Program: {
            Address: { is: "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P" }
            Method: { is: "create" }
          }
        }
      }
    ) {
      Block {
        Time
      }
      Transaction {
        Signer
      }
      TokenSupplyUpdate {
        Amount
        Currency {
          Symbol
          ProgramAddress
          PrimarySaleHappened
          Native
          Name
          MintAddress
          MetadataAddress
          Key
          IsMutable
          Fungible
          EditionNonce
          Decimals
          Wrapped
          VerifiedCollection
          Uri
          UpdateAuthority
          TokenStandard
        }
        PostBalance
      }
    }
  }
}

Get newly created Moonshot tokens and their Metadata​

Now you can track the newly created Moonshot Tokens along with their metadata and supply. PostBalance will give you the current supply for the token. Check the query here

subscription {
  Solana {
    TokenSupplyUpdates(
      where: {
        Instruction: {
          Program: {
            Address: { is: "MoonCVVNZFSYkqNXP6bxHLPL6QQJiMagDL3qcqUQTrG" }
            Method: { is: "tokenMint" }
          }
        }
      }
    ) {
      TokenSupplyUpdate {
        Amount
        Currency {
          Symbol
          ProgramAddress
          PrimarySaleHappened
          Native
          Name
          MintAddress
          MetadataAddress
          Key
          IsMutable
          Fungible
          EditionNonce
          Decimals
          Wrapped
          VerifiedCollection
          Uri
          UpdateAuthority
          TokenStandard
        }
        PostBalance
      }
    }
  }
}

Market Cap Analysis​

Top 10 Solana tokens with the highest marketcap increase in last 1hr​

Use below query to get top 10 marketcap jump tokens in last 1hr. Test the query here

query MyQuery {
  Solana {
    TokenSupplyUpdates(
      limit: {count: 10}
      orderBy: {descendingByField: "marketcapJump"}
      where: {Transaction: {Result: {Success: true}}, Block: {Time: {since_relative: {minutes_ago: 60}}}}
    ) {
      TokenSupplyUpdate {
        AmountInUSD
        pre: PreBalanceInUSD
        post: PostBalanceInUSD
        Currency {
          MintAddress
          Name
          Symbol
          Decimals
        }
      }
      marketcapJump: calculate(
        expression: "(($TokenSupplyUpdate_post - $TokenSupplyUpdate_pre) / $TokenSupplyUpdate_pre) * 100"
      )
    }
  }
}

Marketcap of a Token​

We use PostBalanceInUSD field to get the marketcap. Since it is built on real-time data, you will get the Marketcap if the token was active in the past 8 hours or is being transacted in real-time. This query returns latest marketcap of a particular token.

query MyQuery {
  Solana {
    TokenSupplyUpdates(
      where: {
        TokenSupplyUpdate: {
          Currency: { MintAddress: { is: "token mint address" } }
        }
      }
      limit: { count: 1 }
      orderBy: { descending: Block_Time }
    ) {
      TokenSupplyUpdate {
        PostBalanceInUSD
      }
    }
  }
}

In case PostAmountInUSD is 0 then, you need to pull price from our Crypto price API. Here is an example which gets both supply and Price.

Run query

{
  Solana {
    TokenSupplyUpdates(
      where: {TokenSupplyUpdate: {Currency: {MintAddress: {is: "4iBhvT6bpCf92u12P1kpbejYrHDS6N3hJCNtAq6wpump"}}}}
      limit: {count: 1}
      orderBy: {descending: Block_Time}
    ) {
      TokenSupplyUpdate {
        Currency {
          Name
          Symbol
          MintAddress
          Decimals
        }
        PostBalance
        PostBalanceInUSD
      }
    }
  }
  Trading {
    Tokens(
      limit: {count: 1}
      where: {Price: {IsQuotedInUsd: true}, Interval: {Time: {Duration: {eq: 1}}}, Token: {Address: {is: "4iBhvT6bpCf92u12P1kpbejYrHDS6N3hJCNtAq6wpump"}}}
    ) {
      Block {
        Time(maximum: Block_Time)
      }
      Price {
        Average {
          Mean
        }
      }
    }
  }
}

Monitor Market Cap Metric for a Pump Fun Token​

The subscription given below could be used to setup a websocket like solution that monitors market cap of a Pump Fun token in real time, where the PostBalanceInUSD is essentially the marketcap of the token.

subscription {
  Solana {
    TokenSupplyUpdates(
      where: {
        TokenSupplyUpdate: {
          Currency: { MintAddress: { is: "token mint address" } }
        }
      }
      limitBy: { by: TokenSupplyUpdate_Currency_MintAddress, count: 1 }
    ) {
      TokenSupplyUpdate {
        PostBalanceInUSD
      }
    }
  }
}

Top Solana Tokens By MarketCap​

This query returns the top Solana tokens based on the latest MarketCap.

query MyQuery {
  Solana {
    TokenSupplyUpdates(
      orderBy: {
        descending: Block_Time
        descendingByField: "TokenSupplyUpdate_Marketcap"
      }
      limitBy: { by: TokenSupplyUpdate_Currency_MintAddress, count: 1 }
    ) {
      TokenSupplyUpdate {
        Marketcap: PostBalanceInUSD
        Currency {
          Name
          Symbol
          MintAddress
          Fungible
          Decimals
        }
      }
    }
  }
}

Top 100 Pump Fun Tokens By MarketCap​

This query returns the top Solana tokens based on the latest MarketCap.

query MyQuery {
  Solana {
    TokenSupplyUpdates(
      where: {
        TokenSupplyUpdate: { Currency: { MintAddress: { includes: "pump" } } }
      }
      orderBy: {
        descending: Block_Time
        descendingByField: "TokenSupplyUpdate_Marketcap"
      }
      limitBy: { by: TokenSupplyUpdate_Currency_MintAddress, count: 1 }
      limit: { count: 100 }
    ) {
      TokenSupplyUpdate {
        Marketcap: PostBalanceInUSD
        Currency {
          Name
          Symbol
          MintAddress
          Fungible
          Decimals
          Uri
        }
      }
    }
  }
}

Get Solana Tokens With a Specific MarketCap​

Lets say we need to get the tokens whose marketcap has crossed the 1M USD mark but is less than 2M USD for various reasons like automated trading. We can get the token details that have crossed a particular marketcap using this query.

query MyQuery {
  Solana {
    TokenSupplyUpdates(
      where: {
        TokenSupplyUpdate: {
          PostBalanceInUSD: { ge: "1000000", le: "2000000" }
        }
      }
      orderBy: { descending: Block_Time }
      limitBy: { by: TokenSupplyUpdate_Currency_MintAddress, count: 1 }
    ) {
      TokenSupplyUpdate {
        Marketcap: PostBalanceInUSD
        Currency {
          Name
          Symbol
          MintAddress
          Decimals
          Uri
        }
      }
    }
  }
}

Token Burn Events​

Get Latest Token Burn Events on Solana​

We will be using the token supply API to query recent token liquidity removals (token burn). You can modify this query to track burn events of a specific token using Currency filter in real time or query it.

You can run the query here

query MyQuery {
  Solana(network: solana) {
    TokenSupplyUpdates(
      where: {
        Instruction: { Program: { Method: { in: ["Burn"] } } }
        TokenSupplyUpdate: {}
      }
      limit: { count: 100 }
      orderBy: { descending: Block_Time }
    ) {
      TokenSupplyUpdate {
        PostBalanceInUSD
        PostBalance
        Amount
        Currency {
          Name
          MintAddress
        }
      }
      Instruction {
        Program {
          Name
          Method
        }
      }
    }
  }
}

Video Tutorials​

Video Tutorial on Streaming and Getting Total Supply of a Solana Token​

Video Tutorial on Getting New Pump Fun Token Metadata​

Video Tutorial | How to get Newly Created Pump Fun Tokens, Dev Address, Creation Time, Metadata​

Video Tutorial | How to get Top Solana tokens by Marketcap increase in last 1 hr​

Build with Bitquery

Ready to run this in production?

Get an API key and run these queries in minutes, or talk to us about plans and enterprise delivery.

Get your API keySee pricingTry the MCP serverSubscribe to newsletter
Talk to the teamTelegramEmail

On this page