Mode Selection: Pulse Stream V2 supports two modes:
- Asset Mode (
assetMode: true): Token-based filtering usingTokensStatsRealTimeschema - Pool Mode (
assetMode: false): Pool-based filtering with nestedpoolsfilters
Asset Mode Filter Structure
In Asset Mode, filters are applied directly to token statistics without nestedpools filters:
Pool Mode Filter Structure
In Pool Mode, pool-specific filters must be placed within thepools object:
Asset Mode Filters (assetMode: true)
These filters apply to token-based queries using the
TokensStatsRealTime schema. Use these when assetMode: true.Available Filter Fields (Asset Mode)
Price Fields
latest_price(number): Current price of the tokenprice_1min_ago(number): Price 1 minute agoprice_5min_ago(number): Price 5 minutes agoprice_1h_ago(number): Price 1 hour agoprice_4h_ago(number): Price 4 hours agoprice_6h_ago(number): Price 6 hours agoprice_12h_ago(number): Price 12 hours agoprice_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 capitalizationlatest_market_cap(number): Latest market capitalization
Volume Fields
volume_1min(number): Volume in 1 minutevolume_5min(number): Volume in 5 minutesvolume_15min(number): Volume in 15 minutesvolume_1h(number): Volume in 1 hourvolume_4h(number): Volume in 4 hoursvolume_6h(number): Volume in 6 hoursvolume_12h(number): Volume in 12 hoursvolume_24h(number): Volume in 24 hours
Volume Buy/Sell Fields
volume_buy_1min(number): Buy volume in 1 minutevolume_buy_5min(number): Buy volume in 5 minutesvolume_buy_15min(number): Buy volume in 15 minutesvolume_buy_1h(number): Buy volume in 1 hourvolume_buy_4h(number): Buy volume in 4 hoursvolume_buy_6h(number): Buy volume in 6 hoursvolume_buy_12h(number): Buy volume in 12 hoursvolume_buy_24h(number): Buy volume in 24 hoursvolume_sell_1min(number): Sell volume in 1 minutevolume_sell_5min(number): Sell volume in 5 minutesvolume_sell_15min(number): Sell volume in 15 minutesvolume_sell_1h(number): Sell volume in 1 hourvolume_sell_4h(number): Sell volume in 4 hoursvolume_sell_6h(number): Sell volume in 6 hoursvolume_sell_12h(number): Sell volume in 12 hoursvolume_sell_24h(number): Sell volume in 24 hours
Trades Fields
trades_1min(number): Number of trades in 1 minutetrades_5min(number): Number of trades in 5 minutestrades_15min(number): Number of trades in 15 minutestrades_1h(number): Number of trades in 1 hourtrades_4h(number): Number of trades in 4 hourstrades_6h(number): Number of trades in 6 hourstrades_12h(number): Number of trades in 12 hourstrades_24h(number): Number of trades in 24 hours
Buys Fields
buys_1min(number): Number of buy transactions in 1 minutebuys_5min(number): Number of buy transactions in 5 minutesbuys_15min(number): Number of buy transactions in 15 minutesbuys_1h(number): Number of buy transactions in 1 hourbuys_4h(number): Number of buy transactions in 4 hoursbuys_6h(number): Number of buy transactions in 6 hoursbuys_12h(number): Number of buy transactions in 12 hoursbuys_24h(number): Number of buy transactions in 24 hours
Sells Fields
sells_1min(number): Number of sell transactions in 1 minutesells_5min(number): Number of sell transactions in 5 minutessells_15min(number): Number of sell transactions in 15 minutessells_1h(number): Number of sell transactions in 1 hoursells_4h(number): Number of sell transactions in 4 hourssells_6h(number): Number of sell transactions in 6 hourssells_12h(number): Number of sell transactions in 12 hourssells_24h(number): Number of sell transactions in 24 hours
Buyers Fields
buyers_1min(number): Number of unique buyers in 1 minutebuyers_5min(number): Number of unique buyers in 5 minutesbuyers_15min(number): Number of unique buyers in 15 minutesbuyers_1h(number): Number of unique buyers in 1 hourbuyers_4h(number): Number of unique buyers in 4 hoursbuyers_6h(number): Number of unique buyers in 6 hoursbuyers_12h(number): Number of unique buyers in 12 hoursbuyers_24h(number): Number of unique buyers in 24 hours
Sellers Fields
sellers_1min(number): Number of unique sellers in 1 minutesellers_5min(number): Number of unique sellers in 5 minutessellers_15min(number): Number of unique sellers in 15 minutessellers_1h(number): Number of unique sellers in 1 hoursellers_4h(number): Number of unique sellers in 4 hourssellers_6h(number): Number of unique sellers in 6 hourssellers_12h(number): Number of unique sellers in 12 hourssellers_24h(number): Number of unique sellers in 24 hours
Traders Fields
traders_1min(number): Number of unique traders in 1 minutetraders_5min(number): Number of unique traders in 5 minutestraders_15min(number): Number of unique traders in 15 minutestraders_1h(number): Number of unique traders in 1 hourtraders_4h(number): Number of unique traders in 4 hourstraders_6h(number): Number of unique traders in 6 hourstraders_12h(number): Number of unique traders in 12 hourstraders_24h(number): Number of unique traders in 24 hours
Fees Paid Fields
fees_paid_1min(number): Total fees paid in 1 minutefees_paid_5min(number): Total fees paid in 5 minutesfees_paid_15min(number): Total fees paid in 15 minutesfees_paid_1h(number): Total fees paid in 1 hourfees_paid_4h(number): Total fees paid in 4 hoursfees_paid_6h(number): Total fees paid in 6 hoursfees_paid_12h(number): Total fees paid in 12 hoursfees_paid_24h(number): Total fees paid in 24 hours
Organic Trading Data Fields (Excluding Bot Activity)
The organic metrics provide cleaner data by filtering out bot activity and MEV transactions.Organic Trades
organic_trades_1min(number): Number of organic trades in 1 minuteorganic_trades_5min(number): Number of organic trades in 5 minutesorganic_trades_15min(number): Number of organic trades in 15 minutesorganic_trades_1h(number): Number of organic trades in 1 hourorganic_trades_4h(number): Number of organic trades in 4 hoursorganic_trades_6h(number): Number of organic trades in 6 hoursorganic_trades_12h(number): Number of organic trades in 12 hoursorganic_trades_24h(number): Number of organic trades in 24 hours
Organic Volume
organic_volume_1min(number): Organic volume in 1 minuteorganic_volume_5min(number): Organic volume in 5 minutesorganic_volume_15min(number): Organic volume in 15 minutesorganic_volume_1h(number): Organic volume in 1 hourorganic_volume_4h(number): Organic volume in 4 hoursorganic_volume_6h(number): Organic volume in 6 hoursorganic_volume_12h(number): Organic volume in 12 hoursorganic_volume_24h(number): Organic volume in 24 hours
Organic Buy/Sell Volume
organic_volume_buy_1min(number): Organic buy volume in 1 minuteorganic_volume_buy_5min(number): Organic buy volume in 5 minutesorganic_volume_buy_15min(number): Organic buy volume in 15 minutesorganic_volume_buy_1h(number): Organic buy volume in 1 hourorganic_volume_buy_4h(number): Organic buy volume in 4 hoursorganic_volume_buy_6h(number): Organic buy volume in 6 hoursorganic_volume_buy_12h(number): Organic buy volume in 12 hoursorganic_volume_buy_24h(number): Organic buy volume in 24 hoursorganic_volume_sell_1min(number): Organic sell volume in 1 minuteorganic_volume_sell_5min(number): Organic sell volume in 5 minutesorganic_volume_sell_15min(number): Organic sell volume in 15 minutesorganic_volume_sell_1h(number): Organic sell volume in 1 hourorganic_volume_sell_4h(number): Organic sell volume in 4 hoursorganic_volume_sell_6h(number): Organic sell volume in 6 hoursorganic_volume_sell_12h(number): Organic sell volume in 12 hoursorganic_volume_sell_24h(number): Organic sell volume in 24 hours
Organic Buys/Sells
organic_buys_1min(number): Number of organic buy transactions in 1 minuteorganic_buys_5min(number): Number of organic buy transactions in 5 minutesorganic_buys_15min(number): Number of organic buy transactions in 15 minutesorganic_buys_1h(number): Number of organic buy transactions in 1 hourorganic_buys_4h(number): Number of organic buy transactions in 4 hoursorganic_buys_6h(number): Number of organic buy transactions in 6 hoursorganic_buys_12h(number): Number of organic buy transactions in 12 hoursorganic_buys_24h(number): Number of organic buy transactions in 24 hoursorganic_sells_1min(number): Number of organic sell transactions in 1 minuteorganic_sells_5min(number): Number of organic sell transactions in 5 minutesorganic_sells_15min(number): Number of organic sell transactions in 15 minutesorganic_sells_1h(number): Number of organic sell transactions in 1 hourorganic_sells_4h(number): Number of organic sell transactions in 4 hoursorganic_sells_6h(number): Number of organic sell transactions in 6 hoursorganic_sells_12h(number): Number of organic sell transactions in 12 hoursorganic_sells_24h(number): Number of organic sell transactions in 24 hours
Organic Participants
organic_buyers_1min(number): Number of unique organic buyers in 1 minuteorganic_buyers_5min(number): Number of unique organic buyers in 5 minutesorganic_buyers_15min(number): Number of unique organic buyers in 15 minutesorganic_buyers_1h(number): Number of unique organic buyers in 1 hourorganic_buyers_4h(number): Number of unique organic buyers in 4 hoursorganic_buyers_6h(number): Number of unique organic buyers in 6 hoursorganic_buyers_12h(number): Number of unique organic buyers in 12 hoursorganic_buyers_24h(number): Number of unique organic buyers in 24 hoursorganic_sellers_1min(number): Number of unique organic sellers in 1 minuteorganic_sellers_5min(number): Number of unique organic sellers in 5 minutesorganic_sellers_15min(number): Number of unique organic sellers in 15 minutesorganic_sellers_1h(number): Number of unique organic sellers in 1 hourorganic_sellers_4h(number): Number of unique organic sellers in 4 hoursorganic_sellers_6h(number): Number of unique organic sellers in 6 hoursorganic_sellers_12h(number): Number of unique organic sellers in 12 hoursorganic_sellers_24h(number): Number of unique organic sellers in 24 hoursorganic_traders_1min(number): Number of unique organic traders in 1 minuteorganic_traders_5min(number): Number of unique organic traders in 5 minutesorganic_traders_15min(number): Number of unique organic traders in 15 minutesorganic_traders_1h(number): Number of unique organic traders in 1 hourorganic_traders_4h(number): Number of unique organic traders in 4 hoursorganic_traders_6h(number): Number of unique organic traders in 6 hoursorganic_traders_12h(number): Number of unique organic traders in 12 hoursorganic_traders_24h(number): Number of unique organic traders in 24 hours
Holdings Analysis Fields
bonding_percentage(number): Percentage of tokens in bonding phasedev_holdings_percentage(number): Percentage held by developersbundlers_holdings_percentage(number): Percentage held by bundlersinsiders_holdings_percentage(number): Percentage held by insiderssnipers_holdings_percentage(number): Percentage held by snipersdeployer_migrations_count(number): Number of deployer migrationstwitter_reuses_count(number): Number of Twitter handle reusespro_traders_holdings_percentage(number): Percentage held by professional tradersfresh_traders_holdings_percentage(number): Percentage held by fresh traderssmart_traders_holdings_percentage(number): Percentage held by smart traderstop_10_holdings_percentage(number): Percentage held by top 10 holderstop_50_holdings_percentage(number): Percentage held by top 50 holderstop_100_holdings_percentage(number): Percentage held by top 100 holderstop_200_holdings_percentage(number): Percentage held by top 200 holders
Trader Categories Count Fields
insiders_count(number): Number of insider tradersbundlers_count(number): Number of bundler traderssnipers_count(number): Number of sniper tradersfresh_traders_count(number): Number of fresh traderspro_traders_count(number): Number of professional traderssmart_traders_count(number): Number of smart traders
Trader Buys Tracking Fields
fresh_traders_buys(number): Number of buys by fresh traderspro_traders_buys(number): Number of buys by professional traderssmart_traders_buys(number): Number of buys by smart traders
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/tokens by creation time relative to now (values in seconds)gte(number): Minimum age in seconds (e.g., 1800 for 30 minutes ago)lte(number): Maximum age in seconds (e.g., 3600 for 1 hour ago)- Note: Values are in seconds, not milliseconds. The system converts them to relative timestamps.
created_at(object): Filter pools/tokens by absolute creation dategte(Date | string): Minimum creation datelte(Date | string): Maximum creation date
latest_trade_date(object): Filter pools/tokens by last trade dategte(Date | string): Minimum last trade datelte(Date | string): Maximum last trade date
Other Token Fields
holders_count(number): Number of token holdersliquidity(number): Pool liquidityliquidity_max(number): Maximum liquidity reachedcreated_at(Date): Token creation datelatest_trade_date(Date): Last trade datebonded_at(Date): Bonding completion timestampmigrated_at(Date): Migration timestampsource(string): Source launchpad (e.g., “pumpfun”, “moonshot-evm”, “fourmeme”)factory(string): Factory addresspre_bonding_factory(string): Factory address before bondingpool_address(string): Associated pool addressdeployer(string): Address of the token deployerchainId(string): Blockchain identifiertwitter(string): Twitter/X social media linktelegram(string): Telegram social media linkwebsite(string): Website URLothers(string): Other social linkssecurity(Json): Security analysis datalogo(string): Token logo URLtoken_symbol(string): Token symboltoken_name(string): Token nametwitter_rename_count(number): Twitter rename counttwitter_rename_history(Json): Twitter rename historydexscreener_listed(boolean): Whether listed on DexScreenerdexscreener_header(string): DexScreener header statusdexscreener_ad_paid(boolean): DexScreener ad paid statusbonded(boolean): Whether token is bonded
Custom Filter Fields (Asset Mode)
These are special filters processed by the API that provide additional filtering capabilities.pattern(string): Search pattern for token symbol or name (case insensitive). Matches againsttoken_nameortoken_symbolmin_socials(number): Minimum number of social media links required (1, 2, or 3). Checks for presence oftwitter,telegram, andwebsitefieldsincludeKeywords(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)offset(number): Number of results to skip for pagination (use withlimit)limit(number): Maximum number of results to return (max 100)sortBy(string): Field to sort by (e.g., “volume_1h”, “market_cap”, “created_at”)sortOrder(“asc” | “desc”): Sort directionaddressToExclude(string | string[]): Token address(es) to exclude from results
Filter Operators
equals: Exact equalitygte: Greater than or equallte: Less than or equalgt: Strictly greater thanlt: Strictly less thannot: Not equal to (useful fornot: null)in: In the listcontains: String contains (case sensitive by default, use withmode: 'insensitive'for case-insensitive)
Asset Mode Filter Examples
These examples demonstrate filtering in Asset Mode (assetMode: true).
Price Filters
Market Cap Filters
Volume and Activity Filters
Volume Buy/Sell Filters
Trading Activity Filters
Organic Trading Filters
Holdings Analysis Filters
Trader Categories Filters
Token Metadata Filters
Date Filters
Source and Deployer Filters
Social Media Filters
Pattern Search Filters
Keyword Filters
Timeframe Offset Filters
Address Exclusion Filters
Bonded Filter
Thebonded 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 } }
- Converts to:
-
bonded: true: Filters for pools that have bonded (new pools of tokens that have bonded)- Converts to:
pools: { bonded: { equals: false }, bondingCurveAddress: { not: null } }
- Converts to:
Bonded Filter Examples
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 Mode Filters (assetMode: false)
These filters apply to pool-based queries. Use these when
assetMode: false or when assetMode is not specified. Pool-specific filters must be placed within the pools object.Available Filter Fields (Pool Mode)
Pool Mode supports most of the same token statistics fields as Asset Mode, but requires pool-specific filters to be nested under thepools object.
Token Statistics Fields
All the token statistics fields from Asset Mode are available in Pool Mode (price, volume, trades, buyers, sellers, etc.). Refer to the Asset Mode section above for the complete list.Pool-Specific Filters
Pool filters allow filtering on pool properties based on thePool schema relationship. These are specified directly under filters.pools.
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 namepools.bonded(boolean): Whether the pool is bondedpools.explicit(boolean): Whether the pool is explicitpools.token0_id(number): Token 0 IDpools.token1_id(number): Token 1 IDpools.base_id(number): Base token IDpools.price(number): Pool pricepools.createdAt(Date): Pool creation datepools.chainId(string): Pool blockchain
Pool Filter Examples
Pool Type Filters
Factory Filters with Name Resolution
Token ID Filters
Pool Creation Date Filters
Custom Filter Fields (Pool Mode)
These are special filters processed by the API for Pool Mode.pattern(string): Search pattern for base token symbol or name (case insensitive)min_socials(number): Minimum number of social media links required (1, 2, or 3)includeKeywords(string[]): Array of keywords that must be present in the base token name or symbol (case insensitive)excludeKeywords(string[]): Array of keywords that must NOT be present in the base token name or symbol (case insensitive)offset(number): Number of results to skip for pagination (use withlimit)limit(number): Maximum number of results to return (max 100)sortBy(string): Field to sort bysortOrder(“asc” | “desc”): Sort directionaddressToExclude(string | string[]): Address(es) to exclude from results (excludes pools containing these addresses as token0, token1, or pool address)baseTokenToExclude(string | string[]): Base token address(es) to exclude from results
Pool Mode Filter Examples
These examples demonstrate filtering in Pool Mode (assetMode: false or not specified).