​
Filter Structure

The filter structure uses filters with optional nested pools filters for pool-specific properties. All pool-related filters must be placed directly within the pools object: 
{
  "filters": {
    "market_cap": { "gte": 1000, "lte": 100000 },
    "volume_1h": { "gte": 500 },
    "pools": {
      "type": { "in": ["pumpfun", "moonshot-evm"] },
      "bonded": { "equals": false },
      "factory": { "in": ["uniswap-v2", "0x123..."] }
    }
  }
}

​
Available Filter Fields

​
Price Fields

  • latest_price (number): Current price of the token
  • price_1min_ago (number): Price 1 minute ago
  • price_5min_ago (number): Price 5 minutes ago
  • price_1h_ago (number): Price 1 hour ago
  • price_4h_ago (number): Price 4 hours ago
  • price_6h_ago (number): Price 6 hours ago
  • price_12h_ago (number): Price 12 hours ago
  • price_24h_ago (number): Price 24 hours ago

​
Price Change Fields

  • price_change_1min (number): Price change in 1 minute (%)
  • price_change_5min (number): Price change in 5 minutes (%)
  • price_change_1h (number): Price change in 1 hour (%)
  • price_change_4h (number): Price change in 4 hours (%)
  • price_change_6h (number): Price change in 6 hours (%)
  • price_change_12h (number): Price change in 12 hours (%)
  • price_change_24h (number): Price change in 24 hours (%)

​
Market Cap Fields

  • market_cap (number): Current market capitalization
  • latest_market_cap (number): Latest market capitalization

​
Volume Fields

  • volume_1min (number): Volume in 1 minute
  • volume_5min (number): Volume in 5 minutes
  • volume_15min (number): Volume in 15 minutes
  • volume_1h (number): Volume in 1 hour
  • volume_4h (number): Volume in 4 hours
  • volume_6h (number): Volume in 6 hours
  • volume_12h (number): Volume in 12 hours
  • volume_24h (number): Volume in 24 hours

​
Volume Buy/Sell Fields

  • volume_buy_1min (number): Buy volume in 1 minute
  • volume_buy_5min (number): Buy volume in 5 minutes
  • volume_buy_15min (number): Buy volume in 15 minutes
  • volume_buy_1h (number): Buy volume in 1 hour
  • volume_buy_4h (number): Buy volume in 4 hours
  • volume_buy_6h (number): Buy volume in 6 hours
  • volume_buy_12h (number): Buy volume in 12 hours
  • volume_buy_24h (number): Buy volume in 24 hours
  • volume_sell_1min (number): Sell volume in 1 minute
  • volume_sell_5min (number): Sell volume in 5 minutes
  • volume_sell_15min (number): Sell volume in 15 minutes
  • volume_sell_1h (number): Sell volume in 1 hour
  • volume_sell_4h (number): Sell volume in 4 hours
  • volume_sell_6h (number): Sell volume in 6 hours
  • volume_sell_12h (number): Sell volume in 12 hours
  • volume_sell_24h (number): Sell volume in 24 hours

​
Trades Fields

  • trades_1min (number): Number of trades in 1 minute
  • trades_5min (number): Number of trades in 5 minutes
  • trades_15min (number): Number of trades in 15 minutes
  • trades_1h (number): Number of trades in 1 hour
  • trades_4h (number): Number of trades in 4 hours
  • trades_6h (number): Number of trades in 6 hours
  • trades_12h (number): Number of trades in 12 hours
  • trades_24h (number): Number of trades in 24 hours

​
Buys Fields

  • buys_1min (number): Number of buy transactions in 1 minute
  • buys_5min (number): Number of buy transactions in 5 minutes
  • buys_15min (number): Number of buy transactions in 15 minutes
  • buys_1h (number): Number of buy transactions in 1 hour
  • buys_4h (number): Number of buy transactions in 4 hours
  • buys_6h (number): Number of buy transactions in 6 hours
  • buys_12h (number): Number of buy transactions in 12 hours
  • buys_24h (number): Number of buy transactions in 24 hours

​
Sells Fields

  • sells_1min (number): Number of sell transactions in 1 minute
  • sells_5min (number): Number of sell transactions in 5 minutes
  • sells_15min (number): Number of sell transactions in 15 minutes
  • sells_1h (number): Number of sell transactions in 1 hour
  • sells_4h (number): Number of sell transactions in 4 hours
  • sells_6h (number): Number of sell transactions in 6 hours
  • sells_12h (number): Number of sell transactions in 12 hours
  • sells_24h (number): Number of sell transactions in 24 hours

​
Buyers Fields

  • buyers_1min (number): Number of unique buyers in 1 minute
  • buyers_5min (number): Number of unique buyers in 5 minutes
  • buyers_15min (number): Number of unique buyers in 15 minutes
  • buyers_1h (number): Number of unique buyers in 1 hour
  • buyers_4h (number): Number of unique buyers in 4 hours
  • buyers_6h (number): Number of unique buyers in 6 hours
  • buyers_12h (number): Number of unique buyers in 12 hours
  • buyers_24h (number): Number of unique buyers in 24 hours

​
Sellers Fields

  • sellers_1min (number): Number of unique sellers in 1 minute
  • sellers_5min (number): Number of unique sellers in 5 minutes
  • sellers_15min (number): Number of unique sellers in 15 minutes
  • sellers_1h (number): Number of unique sellers in 1 hour
  • sellers_4h (number): Number of unique sellers in 4 hours
  • sellers_6h (number): Number of unique sellers in 6 hours
  • sellers_12h (number): Number of unique sellers in 12 hours
  • sellers_24h (number): Number of unique sellers in 24 hours

​
Traders Fields

  • traders_1min (number): Number of unique traders in 1 minute
  • traders_5min (number): Number of unique traders in 5 minutes
  • traders_15min (number): Number of unique traders in 15 minutes
  • traders_1h (number): Number of unique traders in 1 hour
  • traders_4h (number): Number of unique traders in 4 hours
  • traders_6h (number): Number of unique traders in 6 hours
  • traders_12h (number): Number of unique traders in 12 hours
  • traders_24h (number): Number of unique traders in 24 hours

​
Fees Paid Fields

  • fees_paid_1min (number): Total fees paid in 1 minute
  • fees_paid_5min (number): Total fees paid in 5 minutes
  • fees_paid_15min (number): Total fees paid in 15 minutes
  • fees_paid_1h (number): Total fees paid in 1 hour
  • fees_paid_4h (number): Total fees paid in 4 hours
  • fees_paid_6h (number): Total fees paid in 6 hours
  • fees_paid_12h (number): Total fees paid in 12 hours
  • fees_paid_24h (number): Total fees paid in 24 hours

​
Holdings Analysis Fields

  • bonding_percentage (number): Percentage of tokens in bonding phase
  • dev_holdings_percentage (number): Percentage held by developers
  • bundlers_holdings_percentage (number): Percentage held by bundlers
  • insiders_holdings_percentage (number): Percentage held by insiders
  • snipers_holdings_percentage (number): Percentage held by snipers
  • deployer_migrations (number): Number of deployer migrations
  • twitter_reuses_count (number): Number of Twitter handle reuses
  • pro_traders_holdings_percentage (number): Percentage held by professional traders
  • top_10_holdings_percentage (number): Percentage held by top 10 holders
  • top_50_holdings_percentage (number): Percentage held by top 50 holders
  • top_100_holdings_percentage (number): Percentage held by top 100 holders
  • top_200_holdings_percentage (number): Percentage held by top 200 holders

​
Metadata Fields

  • tokenSymbol (string): Token symbol (e.g., “BTC”, “ETH”)
  • tokenName (string): Token full name (e.g., “Bitcoin”, “Ethereum”)
  • dexscreenerListed (boolean): Whether the token is listed on DexScreener

​
Keyword Filter Fields

  • includeKeywords (string[]): Array of keywords that must be present in the token name or symbol (case insensitive)
  • excludeKeywords (string[]): Array of keywords that must NOT be present in the token name or symbol (case insensitive)

​
Timeframe Filter Fields

  • created_at_offset (object): Filter pools by creation time relative to now
    • gte (number): Minimum age in seconds (e.g., 1800 for 30 minutes)
    • lte (number): Maximum age in seconds (e.g., 3600 for 1 hour)
  • created_at (object): Filter pools by absolute creation date
    • gte (Date): Minimum creation date
    • lte (Date): Maximum creation date
  • latest_trade_date (object): Filter pools by last trade date
    • gte (Date): Minimum last trade date
    • lte (Date): Maximum last trade date

​
Other Fields

  • holders_count (number): Number of token holders
  • liquidity (number): Pool liquidity
  • created_at (Date): Token creation date
  • latest_trade_date (Date): Last trade date
  • source (string): Source launchpad (e.g., “pumpfun”, “moonshot-evm”, “fourmeme”)
  • deployer (string): Address of the token deployer
  • chainId (string): Blockchain identifier
  • twitter (string): Twitter/X social media link
  • telegram (string): Telegram social media link
  • website (string): Website URL
  • pattern (string): Search pattern for token symbol or name (case insensitive)
  • min_socials (number): Minimum number of social media links (1-3)
  • bonded (boolean): Simplified filter for bonded pools (see Bonded Filter section below)

​
Filter Operators

  • equals: Exact equality
  • gte: Greater than or equal
  • lte: Less than or equal
  • gt: Strictly greater than
  • lt: Strictly less than
  • not: Not equal to (useful for not: null)
  • in: In the list

​
Filter Examples

​
Price Filters

{
  "filters": {
    "latest_price": { "gte": 0.0001, "lte": 0.001 },
    "price_change_1h": { "gte": 10 },
    "price_change_24h": { "lte": -5 }
  }
}

​
Market Cap Filters

{
  "filters": {
    "market_cap": { 
      "gte": 10000,
      "lte": 1000000,
      "not": null
    }
  }
}

​
Volume and Activity Filters

{
  "filters": {
    "volume_1h": { "gte": 1000 },
    "trades_24h": { "gte": 50 },
    "holders_count": { "gte": 100 }
  }
}

​
Volume Buy/Sell Filters

{
  "filters": {
    "volume_buy_1h": { "gte": 500 },
    "volume_sell_1h": { "lte": 300 },
    "volume_buy_24h": { "gte": 10000 },
    "volume_sell_24h": { "lte": 8000 }
  }
}

​
Trading Activity Filters

{
  "filters": {
    "buys_1h": { "gte": 10 },
    "sells_1h": { "lte": 20 },
    "buyers_24h": { "gte": 50 },
    "sellers_24h": { "lte": 30 },
    "traders_1h": { "gte": 25 },
    "fees_paid_24h": { "gte": 100 }
  }
}

​
Holdings Analysis Filters

{
  "filters": {
    "bonding_percentage": { "gte": 50 },
    "dev_holdings_percentage": { "lte": 10 },
    "top_10_holdings_percentage": { "lte": 30 },
    "snipers_holdings_percentage": { "lte": 5 },
    "twitter_reuses_count": { "equals": 0 }
  }
}

​
Metadata Filters

{
  "filters": {
    "tokenSymbol": { "equals": "DOGE" },
    "tokenName": { "equals": "Dogecoin" },
    "dexscreenerListed": { "equals": true }
  }
}

​
Date Filters

{
  "filters": {
    "created_at": { 
      "gte": "2024-01-01T00:00:00Z",
      "lte": "2024-12-31T23:59:59Z"
    },
    "latest_trade_date": { "gte": "2024-01-01T00:00:00Z" }
  }
}

​
Source and Deployer Filters

{
  "filters": {
    "source": { "equals": "pumpfun" },
    "deployer": { "equals": "0x123..." },
    "chainId": { "in": ["evm:8453", "solana:solana"] }
  }
}

​
Social Media Filters

{
  "filters": {
    "min_socials": 2
  }
}

​
Pattern Search Filters

{
  "filters": {
    "pattern": "doge",
    "min_socials": 1
  }
}

​
Keyword Filters

{
  "filters": {
    "includeKeywords": ["meme", "doge", "cat"],
    "excludeKeywords": ["scam", "fake", "test"]
  }
}

​
Timeframe Filters

{
  "filters": {
    "created_at_offset": {
      "gte": 1800,
      "lte": 3600
    }
  }
}

{
  "filters": {
    "created_at": {
      "gte": "2024-01-01T00:00:00Z",
      "lte": "2024-12-31T23:59:59Z"
    }
  }
}

{
  "filters": {
    "latest_trade_date": {
      "gte": "2024-01-01T00:00:00Z"
    }
  }
}

​
Bonded Filter

The bonded filter provides a simplified way to filter pools based on their bonding status. This filter automatically converts to the appropriate pool filters:
  • bonded: false: Filters for pools that are not bonded (launchpad pools)
    • Converts to: pools: { bonded: { equals: false } }
  • bonded: true: Filters for pools that have bonded (new pools of tokens that have bonded)
    • Converts to: pools: { bonded: { equals: false }, bondingCurveAddress: { not: null } }

​
Bonded Filter Examples

{
  "filters": {
    "bonded": false,
    "market_cap": { "gte": 1000 }
  }
}

{
  "filters": {
    "bonded": true,
    "volume_1h": { "gte": 500 }
  }
}
Note: The bonded: true filter is equivalent to finding new pools of tokens that have already bonded, which is why it filters for bonded: false (launchpad pools) but with a bondingCurveAddress (indicating the token has bonded).

​
Pool Filters

Pool filters allow filtering on pool properties based on the Pool schema relationship. These are specified directly under filters.pools (no longer under advancedFilters).

​
Available Pool Filter Fields

​
Pool Properties

  • pools.type (string): Pool type (e.g., “pumpfun”, “uniswap-v2”, “raydium”)
  • pools.factory (string | string[]): Factory contract address or name
  • pools.bonded (boolean): Whether the pool is bonded
  • pools.explicit (boolean): Whether the pool is explicit
  • pools.token0_id (number): Token 0 ID
  • pools.token1_id (number): Token 1 ID
  • pools.base_id (number): Base token ID
  • pools.price (number): Pool price
  • pools.createdAt (Date): Pool creation date
  • pools.chainId (string): Pool blockchain

​
Pool Filter Examples

​
Pool Type Filters

{
  "filters": {
    "pools": {
      "type": { "in": ["pumpfun", "moonshot-evm"] },
      "bonded": { "equals": false }
    }
  }
}

​
Factory Filters with Name Resolution

{
  "filters": {
    "pools": {
      "factory": { "equals": "uniswap-v2" }
    }
  }
}

​
Token ID Filters

{
  "filters": {
    "pools": {
      "OR": [
        { "token0_id": { "in": [451088832, 451088651] } },
        { "token1_id": { "in": [451088832, 451088651] } }
      ]
    }
  }
}

​
Pool Creation Date Filters

{
  "filters": {
    "pools": {
      "createdAt": { "gte": "2024-01-01T00:00:00Z" },
      "explicit": { "equals": true }
    }
  }
}