Skip to content

bitquery/four-meme-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 

Repository files navigation

Four Meme API

Get ultra low latency Four Meme memecoin data on BNB Chain: live trades, bonding curve progress, newly created tokens, prices, OHLC, liquidity, migrations, top traders and more.

The below GraphQL APIs and Streams are examples of data points you can get with Bitquery. If you have questions on other data points, reach out to support.

Need zero-latency BSC data? Read about our Streams and contact us for a trial: https://docs.bitquery.io/docs/streams/

You may also be interested in:

::::note To query or stream data via GraphQL outside the Bitquery IDE, you need to generate an API access token.

Follow the steps here to create one: https://docs.bitquery.io/docs/authorisation/how-to-generate/ ::::


Table of Contents

1. Four Meme Trading & Market Data (BSC)

2. Token Lifecycle, Liquidity & Migrations

3. Trader Insights

4. Market Cap & Getting Started

5. Mempool Data & Pre Confirmation Monitoring

6. Video Tutorials

7. Real World Projects

Bitquery DEX Data Access Options

  • GraphQL APIs: Query historical and real-time EVM data with flexible filtering and aggregation
  • Real-time Streams: Subscribe to live EVM blockchain events via WebSocket subscriptions
  • Cloud Solutions: Access EVM data through AWS, GCP, and Snowflake integrations
  • Kafka Streams: High-throughput data streaming for enterprise applications

Getting Started with Bitquery:

Track All Four Meme Tokens That Have Migrated to Pancakeswap

This query tracks four meme token migrations to Pancakeswap in realtime by monitoring transactions sent to the Four Meme factory address (0x5c952063c7fc8610ffdb798152d69f0b9550762b) and filtering for PairCreated and PoolCreated events. These events are emitted when a token graduates from Four Meme and migrates to Pancakeswap. Test it here.

Click to expand GraphQL query
subscription {
  EVM(network: bsc) {
    Events(
      where: {
        Log: { Signature: { Name: { in: ["PairCreated"] } } }
        Transaction: {
          To: { is: "0x5c952063c7fc8610ffdb798152d69f0b9550762b" }
        }
      }
    ) {
      Arguments {
        Name
        Value {
          ... on EVM_ABI_Address_Value_Arg {
            address
          }
        }
      }
      Transaction {
        Hash
      }
    }
  }
}

Bonding Curve Progress API for FourMeme token

Below query will give you amount of left tokens put it in the below given simplied formulae and you will get Bonding Curve progress for the token.

Bonding Curve Progress Formula

  • Formula: BondingCurveProgress = 100 - ((leftTokens * 100) / initialRealTokenReserves)

Where:

  • leftTokens = realTokenReserves - reservedTokens

  • initialRealTokenReserves = totalSupply - reservedTokens

  • Definitions:

    • initialRealTokenReserves = totalSupply - reservedTokens
      • totalSupply: 1,000,000,000 (Four meme Token)
      • reservedTokens: 200,000,000
      • Therefore, initialRealTokenReserves: 800,000,000
    • leftTokens = realTokenReserves - reservedTokens
      • realTokenReserves: Token balance at the market address.

:::note Simplified Formula: BondingCurveProgress = 100 - (((balance - 200000000) * 100) / 800000000) :::

Additional Notes

  • Balance Retrieval:
    • The balance is the four meme token balance at this Four Meme: Proxy address (0x5c952063c7fc8610FFDB798152D69F0B9550762b).
    • Use this query to fetch the balance: Query Link.
Click to expand GraphQL query ```graphql query MyQuery($token: String) { EVM(dataset: combined, network: bsc) { BalanceUpdates( where: {BalanceUpdate: {Address: {is: "0x5c952063c7fc8610FFDB798152D69F0B9550762b"}}, Currency: {SmartContract: {is: $token}}} orderBy: {descendingByField: "balance"} ) { Currency { Name } balance: sum(of: BalanceUpdate_Amount) BalanceUpdate { Address } } } } ```
Click to expand Query Varibles (Paste this in variables section on IDE) ```json { "token": "0x13378bcbbc386eea99f09bc716f2c80979484444" } ```

Get Four Meme Tokens which are above 95% Bonding Curve Progress

Using the above Bonding Curve formula, we can calculate the token balances for the Four Meme Proxy contract (0x5c952063c7fc8610FFDB798152D69F0B9550762b) corresponding to approximately 95% to 100% progress along the bonding curve, that comes out to be 200,000,000 to 240,000,000. The tokens in the response are arranged in the ascending order of Bonding Curve Percentage, i.e., 95% to 100%. You can run and test the saved query here.

Click to expand GraphQL query
query MyQuery {
  EVM(dataset: combined, network: bsc) {
    BalanceUpdates(
      limit: { count: 10 }
      where: {
        BalanceUpdate: {
          Address: { is: "0x5c952063c7fc8610FFDB798152D69F0B9550762b" }
        }
      }
      orderBy: { descendingByField: "balance" }
    ) {
      Currency {
        SmartContract
        Name
      }
      balance: sum(
        of: BalanceUpdate_Amount
        selectWhere: { ge: "200000000", le: "240000000" }
      )
      BalanceUpdate {
        Address
      }
    }
  }
}

Get Newly Created Tokens on Four Meme

Run Query

This query retrieves newly created tokens on Four Meme by listening to the TokenCreate event. The response provides:

Token Information:

  • creator: Wallet address of the token creator
  • token: Contract address of the newly created token
  • name: Token name
  • symbol: Token symbol/ticker
  • totalSupply: Total supply (always 1 billion tokens)

Launch Details:

  • requestId: Unique identifier for the token creation
  • launchTime: Unix timestamp of when the token launched
  • launchFee: Fee paid
Click to expand GraphQL query
{
  EVM(dataset: realtime, network: bsc) {
    Events(
      where: {
        Transaction: {
          To: { is: "0x5c952063c7fc8610ffdb798152d69f0b9550762b" }
        }
        Log: { Signature: { Name: { is: "TokenCreate" } } }
      }
      limit: { count: 10 }
      orderBy: { descending: Block_Time }
    ) {
      Log {
        Signature {
          Name
          Signature
        }
      }
      Arguments {
        Value {
          ... on EVM_ABI_Integer_Value_Arg {
            integer
          }
          ... on EVM_ABI_Boolean_Value_Arg {
            bool
          }
          ... on EVM_ABI_Bytes_Value_Arg {
            hex
          }
          ... on EVM_ABI_BigInt_Value_Arg {
            bigInteger
          }
          ... on EVM_ABI_Address_Value_Arg {
            address
          }
          ... on EVM_ABI_String_Value_Arg {
            string
          }
        }
        Name
        Type
      }
      Transaction {
        Hash
        To
        From
      }
    }
  }
}

You can refer to this example to track latest trades of a token on other particular DEX's such as Pancake Swap.

Subscribe the Latest Trades on Four Meme

Using subscriptions you can subscribe to the latest trades on Four Meme as shown in this example. The subscription returns latest trade info such as buyers and sellers, buy and sell currency details and amount of currency.

Click to expand GraphQL query
subscription {
  EVM(network: bsc) {
    DEXTrades(
      where: { Trade: { Dex: { ProtocolName: { is: "fourmeme_v1" } } } }
    ) {
      Trade {
        Buy {
          Buyer
          Currency {
            Name
            Symbol
            SmartContract
          }
          Amount
        }
        Sell {
          Seller
          Currency {
            Name
            Symbol
            SmartContract
          }
          Amount
        }
      }
      Transaction {
        Hash
      }
    }
  }
}

Get Latest Buys and Sells for a Four Meme Token

This query retrieves the most recent token buy and sell trades of a specific token on Four Meme Exchange.

Click to expand GraphQL query
query MyQuery($currency: String) {
  EVM(network: bsc, dataset: combined) {
    buys: DEXTrades(
      where: {
        Trade: {
          Buy: { Currency: { SmartContract: { is: $currency } } }
          Success: true
          Dex: { ProtocolName: { is: "fourmeme_v1" } }
        }
      }
      orderBy: { descending: Block_Time }
    ) {
      Block {
        Time
      }
      Trade {
        Buy {
          Amount
          Buyer
          Price
          PriceInUSD
          Seller
        }
        Sell {
          Currency {
            Name
            Symbol
            SmartContract
          }
        }
      }
    }
    sells: DEXTrades(
      where: {
        Trade: {
          Sell: { Currency: { SmartContract: { is: $currency } } }
          Success: true
          Dex: { ProtocolName: { is: "fourmeme_v1" } }
        }
      }
      orderBy: { descending: Block_Time }
    ) {
      Block {
        Time
      }
      Trade {
        Buy {
          Currency {
            Name
            Symbol
            SmartContract
          }
        }
        Sell {
          Amount
          Buyer
          Price
          PriceInUSD
          Seller
        }
      }
    }
  }
}
{
  "currency": "0x9b48a54bcce09e59b0479060e9328ab7dbdb0d40"
}

You can also check if the token is listed on other DEX using this example.

Get Trade Metrics of a Four Meme Token

Use the below query to get trade metrics like volume and trades for a token in different time frames, such as 24 hours, 1 hour and 5 minutes. Test it here.

Click to expand GraphQL query
query MyQuery($currency: String) {
  EVM(network: bsc) {
    DEXTradeByTokens(
      where: {
        Trade: { Currency: { SmartContract: { is: $currency } }, Success: true }
        Block: { Time: { since_relative: { hours_ago: 24 } } }
      }
    ) {
      Trade {
        Currency {
          Name
          Symbol
          SmartContract
        }
      }
      volume_24hr: sum(of: Trade_Side_AmountInUSD)
      volume_1hr: sum(
        of: Trade_Side_AmountInUSD
        if: { Block: { Time: { since_relative: { hours_ago: 1 } } } }
      )
      volume_5min: sum(
        of: Trade_Side_AmountInUSD
        if: { Block: { Time: { since_relative: { minutes_ago: 5 } } } }
      )
      trades_24hr: count
      trades_1hr: count(
        if: { Block: { Time: { since_relative: { hours_ago: 1 } } } }
      )
      trades_5min: count(
        if: { Block: { Time: { since_relative: { minutes_ago: 5 } } } }
      )
    }
  }
}
{
  "currency": "0x9b48a54bcce09e59b0479060e9328ab7dbdb0d40"
}

Get latest price of a Four.meme token

We launched the Price Index in August 2025, allowing you to track price of any token trading onchain. Here's an example of tracking Four.meme token prices.

Click to expand GraphQL query
{
  Trading {
    Pairs(
      where: {Price: {IsQuotedInUsd: false}, Market: {Network: {is: "Binance Smart Chain"}, Program: {is: "0x5c952063c7fc8610ffdb798152d69f0b9550762b"}}, Token: {Address: {is: "0x2157de505dfaa51676d6d22c0424551fbeaf4444"}}, Interval: {Time: {Duration: {eq: 60}}}}
      limit: {count: 1}
      orderBy: {descending: Block_Time}
    ) {
      Market {
        Address
        Network
        Program
        Protocol
        ProtocolFamily
      }
      Price {
        Average {
          ExponentialMoving
          Mean
          SimpleMoving
          WeightedSimpleMoving
        }
        Ohlc {
          Close
          High
          Low
          Open
        }
      }
      Token {
        Address
        Name
        Symbol
      }
      QuoteToken {
        Address
        Name
        Symbol
      }
      Volume {
        Base
        Usd
      }
    }
  }
}

Get Price Change Percentage for a Four Meme Token

Use the below query to get the price change in percentage for various time fields including 24 hours, 1 hour and 5 minutes. Try it here.

Click to expand GraphQL query
query MyQuery($currency: String) {
  EVM(network: bsc) {
    DEXTradeByTokens(
      where: {
        Trade: { Currency: { SmartContract: { is: $currency } }, Success: true }
        Block: { Time: { since_relative: { hours_ago: 24 } } }
      }
    ) {
      Trade {
        Currency {
          Name
          Symbol
          SmartContract
        }
        price_24hr: PriceInUSD(minimum: Block_Time)
        price_1hr: PriceInUSD(
          if: { Block: { Time: { is_relative: { hours_ago: 1 } } } }
        )
        price_5min: PriceInUSD(
          if: { Block: { Time: { is_relative: { minutes_ago: 1 } } } }
        )
        current: PriceInUSD
      }
      change_24hr: calculate(
        expression: "( $Trade_current - $Trade_price_24hr ) / $Trade_price_24hr * 100"
      )
      change_1hr: calculate(
        expression: "( $Trade_current - $Trade_price_1hr ) / $Trade_price_1hr * 100"
      )
      change_5min: calculate(
        expression: "( $Trade_current - $Trade_price_5min ) / $Trade_price_5min * 100"
      )
    }
  }
}
{
  "currency": "0x9b48a54bcce09e59b0479060e9328ab7dbdb0d40"
}

Get OHLCV data of a Four Meme Token

Use the below query to get four meme token OHLCV data. Test it here.

Click to expand GraphQL query
query tradingView($network: evm_network, $token: String) {
  EVM(network: $network, dataset: combined) {
    DEXTradeByTokens(
      limit: { count: 10 }
      orderBy: { descendingByField: "Block_Time" }
      where: {
        Trade: {
          Currency: { SmartContract: { is: $token } }
          PriceAsymmetry: { lt: 0.1 }
          Dex: { ProtocolName: { is: "fourmeme_v1" } }
        }
      }
    ) {
      Block {
        Time(interval: { count: 5, in: minutes })
      }
      Trade {
        open: PriceInUSD(minimum: Block_Number)
        close: PriceInUSD(maximum: Block_Number)
        max: PriceInUSD(maximum: Trade_PriceInUSD)
        min: PriceInUSD(minimum: Trade_PriceInUSD)
      }
      volumeUSD: sum(of: Trade_Side_AmountInUSD, selectWhere: { gt: "0" })
    }
  }
}
{
  "network": "bsc",
  "token": "0x9b48a54bcce09e59b0479060e9328ab7dbdb0d40"
}

Monitor trades of traders on Four meme

You can use our streams to monitor real time trades of a trader on Four Meme, for example run this stream.

Click to expand GraphQL query
subscription {
  EVM(network: bsc) {
    DEXTrades(
      where: {
        Trade: { Dex: { ProtocolName: { is: "fourmeme_v1" } }, Success: true }
        Transaction: {
          From: { is: "0x7db00d1f5b8855d40827f34bb17f95d31990306e" }
        }
      }
    ) {
      Trade {
        Buy {
          Buyer
          Currency {
            Name
            Symbol
            SmartContract
          }
          Amount
          Price
          PriceInUSD
        }
        Sell {
          Seller
          Currency {
            Name
            Symbol
            SmartContract
          }
          Amount
        }
      }
      Transaction {
        Hash
      }
    }
  }
}

You can also get the trade activities of a user on Pancake Swap using our Pancake Swap APIs.

Track Four Meme Tokens in 14k to 18k Marketcap

Tracks live Four Meme tokens on BSC with a market cap between $14K–$18K, filtered by 14k to 18k Marketcap. Useful for spotting emerging small-cap meme tokens in real time. Try the query here.

Click to expand GraphQL query
subscription {
  Trading {
    Pairs(
      where: {
        Interval: { Time: { Duration: { eq: 1 } } }
        Price: {
          IsQuotedInUsd: true
          Average: { Mean: { gt: 0.000014, le: 0.000018 } }
        }
        Market: {
          Protocol: { is: "fourmeme_v1" }
          Network: { is: "Binance Smart Chain" }
        }
        Volume: { Usd: { gt: 5 } }
      }
    ) {
      Token {
        Name
        Symbol
        Address
      }
      Market {
        Protocol
        Program
        Network
        Name
        Address
      }
      Block {
        Date
        Time
        Timestamp
      }
      Interval {
        Time {
          Start
          Duration
          End
        }
      }
      Volume {
        Base
        Quote
        Usd
      }
      marketcap: calculate(expression: "Price_Average_Mean * 1000000000")
      Price {
        Average {
          Mean
        }
        Ohlc {
          Close
          High
          Low
          Open
        }
      }
    }
  }
}

Track Latest and Historical Trades of a Four Meme User

You can use DEX Trades API with combined dataset to get latest and historic trades of a user. Run this query for example.

Click to expand GraphQL query
query MyQuery($address: String) {
  EVM(dataset: combined, network: bsc) {
    DEXTrades(
      where: {
        Trade: { Dex: { ProtocolName: { is: "fourmeme_v1" } }, Success: true }
        Transaction: { From: { is: $address } }
      }
      orderBy: { descending: Block_Time }
    ) {
      Block {
        Time
      }
      Trade {
        Buy {
          Buyer
          Currency {
            Name
            Symbol
            SmartContract
          }
          Amount
          Price
          PriceInUSD
        }
        Sell {
          Seller
          Currency {
            Name
            Symbol
            SmartContract
          }
          Amount
        }
      }
      Transaction {
        Hash
      }
    }
  }
}
{
  "address": "0x7db00d1f5b8855d40827f34bb17f95d31990306e"
}

Top Buyers for a Token on Four Meme

This query returns top buyers of a particular token on Four Meme, with currency smart contract as 0x9b48a54bcce09e59b0479060e9328ab7dbdb0d40 for this example.

Click to expand GraphQL query
query MyQuery($currency: String) {
  EVM(network: bsc, dataset: combined) {
    DEXTrades(
      where: {
        Trade: {
          Buy: { Currency: { SmartContract: { is: $currency } } }
          Success: true
          Dex: { ProtocolName: { is: "fourmeme_v1" } }
        }
      }
      limit: { count: 100 }
    ) {
      Trade {
        Buy {
          Buyer
        }
      }
      trades: count
      bought: sum(of: Trade_Buy_Amount)
    }
  }
}
{
  "currency": "0x9b48a54bcce09e59b0479060e9328ab7dbdb0d40"
}

Get Trade Volume and Number of Trades for a Four Meme Token

This query returns the traded volume and number of trades for a particular Four Meme token in different time frames, namely 24 hours, 1 hour and 5 minutes.

Click to expand GraphQL query
query MyQuery(
  $currency: String
  $time_24hr_ago: DateTime
  $time_1hr_ago: DateTime
  $time_5min_ago: DateTime
) {
  EVM(network: bsc) {
    DEXTradeByTokens(
      where: {
        Trade: { Currency: { SmartContract: { is: $currency } }, Success: true }
        Block: { Time: { since: $time_24hr_ago } }
      }
    ) {
      Trade {
        Currency {
          Name
          Symbol
          SmartContract
        }
      }
      volume_24hr: sum(of: Trade_Side_AmountInUSD)
      volume_1hr: sum(
        of: Trade_Side_AmountInUSD
        if: { Block: { Time: { since: $time_1hr_ago } } }
      )
      volume_5min: sum(
        of: Trade_Side_AmountInUSD
        if: { Block: { Time: { since: $time_5min_ago } } }
      )
      trades_24hr: count
      trades_1hr: count(if: { Block: { Time: { since: $time_1hr_ago } } })
      trades_5min: count(if: { Block: { Time: { since: $time_5min_ago } } })
    }
  }
}
{
  "currency": "0x9b48a54bcce09e59b0479060e9328ab7dbdb0d40",
  "time_24hr_ago": "2024-03-23T15:00:00Z",
  "time_1hr_ago": "2024-03-24T14:00:00Z",
  "time_5min_ago": "2024-03-24T15:55:00Z"
}

Get Realtime Market Cap and Price of a Four Meme Token

To get the market cap of a token we need two things, the latest PriceInUSD and total supply of the token. Total Supply is 1,000,000,000 (1B) for four meme tokens so we just need to get price and multiply it with 1B. This query helps with getting the latest USD price of a token and hence its latest Marketcap.

Market Cap = Total Supply * PriceInUSD
Click to expand GraphQL query
subscription {
  Trading {
    Pairs(
      where: {
        Interval: { Time: { Duration: { eq: 1 } } }
        Price: { IsQuotedInUsd: true }
        Market: {
          Protocol: { is: "fourmeme_v1" }
          Network: { is: "Binance Smart Chain" }
        }
        Volume: { Usd: { gt: 5 } }
        Token: { Address: { is: "0xf5bc78c8c762e4003742dacc31f3ba7091be4444" } }
      }
    ) {
      Token {
        Name
        Symbol
        Address
      }
      Market {
        Protocol
        Program
        Network
        Name
        Address
      }
      Block {
        Date
        Time
        Timestamp
      }
      Interval {
        Time {
          Start
          Duration
          End
        }
      }
      Volume {
        Base
        Quote
        Usd
      }
      marketcap: calculate(expression: "Price_Average_Mean * 1000000000")
      Price {
        Average {
          Mean
        }
        Ohlc {
          Close
          High
          Low
          Open
        }
      }
    }
  }
}

Track Liquidity Add Events for All Tokens on Four Meme

This query tracks all liquidity addition events on the Four Meme Exchange. It listens for LiquidityAdded events emitted from the four meme exchange's smart contract (0x5c952063c7fc8610ffdb798152d69f0b9550762b)

You can run the query here

Click to expand GraphQL query
{
  EVM(dataset: realtime, network: bsc) {
    Events(
      limit: {count: 20}
      where: {LogHeader: {Address: {is: "0x5c952063c7fc8610ffdb798152d69f0b9550762b"}},
        Log: {Signature: {Name: {is: "LiquidityAdded"}}}}
    ) {
      Block {
        Time
        Number
        Hash
      }
      Receipt {
        ContractAddress
      }
      Topics {
        Hash
      }
      TransactionStatus {
        Success
      }
      LogHeader {
        Address
        Index
        Data
      }
      Transaction {
        Hash
        From
        To
      }
      Log {
        EnterIndex
        ExitIndex
        Index
        LogAfterCallIndex
        Pc
        SmartContract
        Signature {
          Name
          Signature
        }
      }
      Arguments {
        Name
        Value {
          ... on EVM_ABI_Integer_Value_Arg {
            integer
          }
          ... on EVM_ABI_Address_Value_Arg {
            address
          }
          ... on EVM_ABI_String_Value_Arg {
            string
          }
          ... on EVM_ABI_BigInt_Value_Arg {
            bigInteger
          }
          ... on EVM_ABI_Bytes_Value_Arg {
            hex
          }
          ... on EVM_ABI_Boolean_Value_Arg {
            bool
          }
        }
      }
    }
  }
}

Track Liquidity Add Events for a Token on Four Meme

This query tracks liquidity addition events for a specific token on the Four Meme Exchange. It listens for LiquidityAdded events emitted from the exchange's smart contract (0x5c952063c7fc8610ffdb798152d69f0b9550762b) BNB network

In this example, the query monitors liquidity events for a specific token (0x5a49ce64a1e44f6fce07e9ff38f54dde8a8a0e94) by filtering the event arguments to only include actions related to this token.

You can run the query here

Click to expand GraphQL query
{
  EVM(dataset: realtime, network: bsc) {
    Events(
      limit: {count: 20}
      where: {LogHeader: {Address: {is: "0x5c952063c7fc8610ffdb798152d69f0b9550762b"}}, Log: {Signature: {Name: {is: "LiquidityAdded"}}}, Arguments: {includes: {Name: {is: "token1"}, Value: {Address: {is: "0x5a49ce64a1e44f6fce07e9ff38f54dde8a8a0e94"}}}}}
    ) {
      Block {
        Time
        Number
        Hash
      }
      Receipt {
        ContractAddress
      }
      Topics {
        Hash
      }
      TransactionStatus {
        Success
      }
      LogHeader {
        Address
        Index
        Data
      }
      Transaction {
        Hash
        From
        To
      }
      Log {
        EnterIndex
        ExitIndex
        Index
        LogAfterCallIndex
        Pc
        SmartContract
        Signature {
          Name
          Signature
        }
      }
      Arguments {
        Name
        Value {
          ... on EVM_ABI_Integer_Value_Arg {
            integer
          }
          ... on EVM_ABI_Address_Value_Arg {
            address
          }
          ... on EVM_ABI_String_Value_Arg {
            string
          }
          ... on EVM_ABI_BigInt_Value_Arg {
            bigInteger
          }
          ... on EVM_ABI_Bytes_Value_Arg {
            hex
          }
          ... on EVM_ABI_Boolean_Value_Arg {
            bool
          }
        }
      }
    }
  }
}

Top Traders of a token

This query will fetch you top traders of a Four Meme token for the BSC network. You can test the query here.

Click to expand GraphQL query
query topTraders($network: evm_network, $token: String) {
  EVM(network: $network, dataset: combined) {
    DEXTradeByTokens(
      orderBy: {descendingByField: "volumeUsd"}
      limit: {count: 100}
      where: {Trade: {Currency: {SmartContract: {is: $token}}, Dex: {ProtocolName: {is: "fourmeme_v1"}}}}
    ) {
      Trade {
        Buyer
        Dex {
          OwnerAddress
          ProtocolFamily
          ProtocolName
        }
      }
      buyVolume: sum(of: Trade_Amount, if: {Trade: {Side: {Type: {is: buy}}}})
      sellVolume: sum(of: Trade_Amount, if: {Trade: {Side: {Type: {is: sell}}}})
      volume: sum(of: Trade_Amount)
      volumeUsd: sum(of: Trade_Side_AmountInUSD)
    }
  }
}
{
  "network": "bsc",
  "token": "0x37e3a59843b056e063780402ef25e12dca394444"
}

Get liquidity of a Four Meme token

Using below API you can get the liquidity of a four meme token. Subtract 200000000 from the Balance that this query returns because 200M tokens are reserved which gets transferred to pancakeswap when this fourmeme token graduates. Test the API here.

Click to expand GraphQL query
query MyQuery {
  EVM(dataset: combined, network: bsc) {
    BalanceUpdates(
      where: {BalanceUpdate: {Address: {is: "0x5c952063c7fc8610FFDB798152D69F0B9550762b"}}, Currency: {SmartContract: {is: "0x87c5b3da05b062480b55c2dbf374ccd084f74444"}}}
      orderBy: {descendingByField: "balance"}
    ) {
      Currency {
        Name
      }
      balance: sum(of: BalanceUpdate_Amount)
      BalanceUpdate {
        Address
      }
    }
  }
}

How Mempool Monitoring Works

When a transaction is broadcasted to the BSC network but not yet included in a block, Bitquery captures and processes it through mempool monitoring:

  • Transaction Simulation: The transaction is executed in the EVM using the current pending block context
  • Data Extraction: The system captures the simulated receipt, trace, and event logs
  • Real-time Streaming: Data is made available instantly through GraphQL subscriptions and Kafka streams
  • Block Context: Each batch of simulated transactions includes the block header used as execution context

Why Monitor Mempool?

  • First-mover Advantage: Detect opportunities before they're confirmed on-chain
  • MEV Opportunities: Identify profitable front-running and back-running opportunities
  • Sniper Bots: Be first to trade newly launched tokens
  • Risk Management: Detect large sells or potential rug pulls before execution
  • Market Intelligence: Monitor smart money and whale activity in real-time

:::tip We provide both GraphQL streams (easy to use) and Kafka streams (ultra-low latency) for mempool monitoring. For production MEV and sniper bots, we recommend Kafka streams.

Read more: Kafka Protobuf Streams for EVM ➤ :::


Stream Four Meme Trades in Mempool - Detect Early

Monitor all Four Meme DEX trades in real-time as they appear in the mempool, before they are confirmed on-chain. This allows you to detect trading opportunities early and execute front-run or back-run strategies.

Run Stream ➤

Click to expand GraphQL query
subscription {
  EVM(network: bsc, mempool: true) {
    DEXTrades(
      where: { Trade: { Dex: { ProtocolName: { is: "fourmeme_v1" } } } }
    ) {
      Trade {
        Buy {
          Buyer
          Currency {
            Name
            Symbol
            SmartContract
          }
          Amount
          Price
          PriceInUSD
        }
        Sell {
          Seller
          Currency {
            Name
            Symbol
            SmartContract
          }
          Amount
          Price
          PriceInUSD
        }
        Dex {
          ProtocolName
          ProtocolFamily
        }
      }
      Transaction {
        Hash
        From
        To
        Gas
        GasPrice
      }
      Block {
        Time
      }
    }
  }
}

Monitor Specific Token Trades in Mempool

Track pending trades for a specific Four Meme token. Perfect for monitoring price impact before large trades execute.

Run Stream ➤

Click to expand GraphQL query
subscription($token: String) {
  EVM(network: bsc mempool:true) {
    DEXTrades(
      where: {Trade:{Dex:{ProtocolFamily:{is:"FourMeme"}}} any:[{Trade:{Buy:{Currency:{SmartContract:{is:$token}}}}},{Trade:{Sell:{Currency:{SmartContract:{is:$token}}}}}]}
    ) {
      Block{
        Time
      }
      Trade {
        Buy {
          Buyer
          Currency {
            Name
            Symbol
            SmartContract
          }
          Amount
          Price
          PriceInUSD
        }
        Dex{
          ProtocolFamily
        }
        Sell {
          Seller
          Currency {
            Name
            Symbol
            SmartContract
          }
          Amount
          PriceInUSD
        }
      }
      Transaction {
        Hash
        From
        Gas
        GasPrice
      }
    }
  }
}
{
  "token": "0x444416a582466fdae0f2fcdf0a859675f8ff6e9f"
}

Track Large Buys in Mempool

Monitor large buy orders in the mempool to detect whale activity and potential price pumps.

Run Stream ➤

Click to expand GraphQL query
subscription {
  EVM(network: bsc, mempool: true) {
    DEXTrades(
      where: {
        Trade: {
          Dex: { ProtocolName: { is: "fourmeme_v1" } }
          Buy: { AmountInUSD: { gt: "1000" } }
        }
      }
    ) {
      Trade {
        Buy {
          Buyer
          Currency {
            Name
            Symbol
            SmartContract
          }
          Amount
          AmountInUSD
          Price
          PriceInUSD
        }
        Sell {
          Currency {
            Name
            Symbol
          }
          Amount
        }
      }
      Transaction {
        Hash
        From
        Gas
        GasPrice
      }
      Block {
        Time
      }
    }
  }
}

Track Large Sells in Mempool

Detect large sell orders before they execute to protect against price dumps.

Run Stream ➤

Click to expand GraphQL query
subscription {
  EVM(network: bsc, mempool: true) {
    DEXTrades(
      where: {
        Trade: {
          Dex: { ProtocolName: { is: "fourmeme_v1" } }
          Sell: { AmountInUSD: { gt: "1000" } }
        }
      }
    ) {
      Trade {
        Buy {
          Currency {
            Name
            Symbol
          }
          Amount
        }
        Sell {
          Seller
          Currency {
            Name
            Symbol
            SmartContract
          }
          Amount
          AmountInUSD
          Price
          PriceInUSD
        }
      }
      Transaction {
        Hash
        From
        Gas
        GasPrice
      }
    }
  }
}

Stream Four Meme Token Creation in Mempool - Be First

Track new Four Meme token creations in the mempool instantly. Be the absolute first to know when a new token is being created, before it's confirmed on-chain. Critical for sniper bots.

Run Stream ➤

Click to expand GraphQL query
subscription {
  EVM(network: bsc, mempool: true) {
    Events(
      where: {
        Transaction: {
          To: { is: "0x5c952063c7fc8610ffdb798152d69f0b9550762b" }
        }
        Log: { Signature: { Name: { is: "TokenCreate" } } }
      }
    ) {
      Log {
        Signature {
          Name
          Signature
        }
      }
      Arguments {
        Value {
          ... on EVM_ABI_Integer_Value_Arg {
            integer
          }
          ... on EVM_ABI_Boolean_Value_Arg {
            bool
          }
          ... on EVM_ABI_Bytes_Value_Arg {
            hex
          }
          ... on EVM_ABI_BigInt_Value_Arg {
            bigInteger
          }
          ... on EVM_ABI_Address_Value_Arg {
            address
          }
          ... on EVM_ABI_String_Value_Arg {
            string
          }
        }
        Name
        Type
      }
      Transaction {
        Hash
        To
        From
        Gas
        GasPrice
      }
      Block {
        Time
      }
    }
  }
}

Monitor Token Launches with Metadata

Get complete token information including name, symbol, and creator details from mempool.

Run Stream ➤

Click to expand GraphQL query
subscription {
  EVM(network: bsc, mempool: true) {
    Events(
      where: {
        Transaction: {
          To: { is: "0x5c952063c7fc8610ffdb798152d69f0b9550762b" }
        }
        Log: { Signature: { Name: { is: "TokenCreate" } } }
      }
    ) {
      Arguments {
        Name
        Value {
          ... on EVM_ABI_Address_Value_Arg {
            address
          }
          ... on EVM_ABI_String_Value_Arg {
            string
          }
          ... on EVM_ABI_BigInt_Value_Arg {
            bigInteger
          }
        }
      }
      Transaction {
        Hash
        From
      }
      Block {
        Time
      }
    }
  }
}

Track Liquidity Add Events in Mempool

Monitor when liquidity is being added to Four Meme tokens before confirmation. Important for detecting graduation events.

Run Stream ➤

Click to expand GraphQL query
subscription {
  EVM(network: bsc, mempool: true) {
    Events(
      where: {
        LogHeader: {
          Address: { is: "0x5c952063c7fc8610ffdb798152d69f0b9550762b" }
        }
        Log: { Signature: { Name: { is: "LiquidityAdded" } } }
      }
    ) {
      Log {
        Signature {
          Name
          Signature
        }
      }
      Arguments {
        Name
        Value {
          ... on EVM_ABI_Address_Value_Arg {
            address
          }
          ... on EVM_ABI_BigInt_Value_Arg {
            bigInteger
          }
          ... on EVM_ABI_Integer_Value_Arg {
            integer
          }
        }
      }
      Transaction {
        Hash
        From
      }
      Block {
        Time
      }
    }
  }
}

Monitor Token Migrations to PancakeSwap in Mempool

Track when Four Meme tokens are graduating to PancakeSwap before the migration completes. Critical for trading strategies.

Run Stream ➤

Click to expand GraphQL query
subscription {
  EVM(network: bsc, mempool: true) {
    Events(
      where: {
        Log: { Signature: { Name: { in: ["PairCreated", "PoolCreated"] } } }
        Transaction: {
          To: { is: "0x5c952063c7fc8610ffdb798152d69f0b9550762b" }
        }
      }
    ) {
      Log {
        Signature {
          Name
          Signature
        }
      }
      Arguments {
        Name
        Value {
          ... on EVM_ABI_Address_Value_Arg {
            address
          }
          ... on EVM_ABI_BigInt_Value_Arg {
            bigInteger
          }
        }
      }
      Transaction {
        Hash
        From
        To
        Gas
        GasPrice
      }
    }
  }
}

Track Bonding Curve Completion in Mempool

Monitor tokens that are about to complete their bonding curve (near graduation) in the mempool.

Run Stream ➤

Click to expand GraphQL query
subscription {
  EVM(network: bsc, mempool: true) {
    Events(
      where: {
        LogHeader: {
          Address: { is: "0x5c952063c7fc8610ffdb798152d69f0b9550762b" }
        }
        Log: {
          Signature: {
            Name: { in: ["LiquidityAdded", "TokenGraduated", "PairCreated"] }
          }
        }
      }
    ) {
      Log {
        Signature {
          Name
        }
      }
      Arguments {
        Name
        Value {
          ... on EVM_ABI_Address_Value_Arg {
            address
          }
          ... on EVM_ABI_String_Value_Arg {
            string
          }
        }
      }
      Transaction {
        Hash
        From
      }
    }
  }
}

Monitor Wallet Activity in Mempool

Track specific wallet addresses (smart money, whales, or known traders) and their pending Four Meme trades.

Run Stream ➤

Click to expand GraphQL query
subscription {
  EVM(network: bsc, mempool: true) {
    DEXTrades(
      where: {
        Trade: { Dex: { ProtocolName: { is: "fourmeme_v1" } } }
        Transaction: {
          From: { is: "0x7db00d1f5b8855d40827f34bb17f95d31990306e" }
        }
      }
    ) {
      Trade {
        Buy {
          Buyer
          Currency {
            Name
            Symbol
            SmartContract
          }
          Amount
          AmountInUSD
        }
        Sell {
          Seller
          Currency {
            Name
            Symbol
            SmartContract
          }
          Amount
          AmountInUSD
        }
      }
      Transaction {
        Hash
        From
        Gas
        GasPrice
      }
    }
  }
}

Track Smart Money Trades in Mempool

Monitor multiple smart money wallets simultaneously for their Four Meme trading activity in mempool.

Run Stream ➤

Click to expand GraphQL query
subscription {
  EVM(network: bsc, mempool: true) {
    DEXTrades(
      where: {
        Trade: { Dex: { ProtocolName: { is: "fourmeme_v1" } } }
        Transaction: {
          From: {
            in: [
              "0x7db00d1f5b8855d40827f34bb17f95d31990306e"
              "0x1234567890123456789012345678901234567890"
              "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd"
            ]
          }
        }
      }
    ) {
      Trade {
        Buy {
          Buyer
          Currency {
            Name
            Symbol
            SmartContract
          }
          Amount
          AmountInUSD
        }
        Sell {
          Currency {
            Name
            Symbol
          }
          Amount
        }
      }
      Transaction {
        Hash
        From
      }
    }
  }
}

Detect Potential Rug Pulls in Mempool

Monitor for suspicious activity like developers selling large amounts in mempool.

Run Stream ➤

Click to expand GraphQL query
subscription {
  EVM(network: bsc, mempool: true) {
    DEXTrades(
      where: {
        Trade: {
          Dex: { ProtocolName: { is: "fourmeme_v1" } }
          Sell: { AmountInUSD: { gt: "5000" } }
        }
      }
    ) {
      Trade {
        Sell {
          Seller
          Currency {
            Name
            Symbol
            SmartContract
          }
          Amount
          AmountInUSD
        }
        Buy {
          Currency {
            Name
            Symbol
          }
        }
      }
      Transaction {
        Hash
        From
        Gas
        GasPrice
      }
      Block {
        Time
      }
    }
  }
}

Real World Projects with Four Meme API

Building a Four Meme Dashboard

Four Meme Sniper Bot

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published