Trades
Returns trades for a specified liquidity pool, with optional filtering by side, trader, maker, block range, or timestamp range.
query Parameters
blockchainThe blockchain network to query.
pairThe contract address (Uniswap V2/V3) or pool ID (Uniswap V4) of the liquidity pool to fetch trades for.
trader_addressFilter trades where this address sent or received the specified token, regardless of whether they initiated the swap transaction.
maker_addressFilter trades where this address initiated the swap transaction.
sideSpecifies trade side for the implied quote token address. Wrapped native tokens and stablecoins are implied to be the base token in the trade, making the other token the quote. Otherwise the token with the lowest fully-diluted value (FDV) is assumed to be the quote token.
min_usdMinimum trade size in USD. Filters out trades with an estimated USD value below this threshold. Calculated using on-chain price data at the time of the trade. Note: Adds additional SLAM cost to the query. A maximum of 10,000 trades that would otherwise match this query will be scanned.
max_usdMaximum trade size in USD. Filters out trades with an estimated USD value above this threshold. Calculated using on-chain price data at the time of the trade. Note: Adds additional SLAM cost to the query. A maximum of 10,000 trades that would otherwise match this query will be scanned.
numThe maximum number of records to return.
orderSort order: asc (oldest first) or desc (newest first).
start_timestampStart searching from this UTC timestamp (inclusive). If provided, overrides start_block as the starting point.
start_blockBlock number to start the search from (inclusive). Defaults to the latest block in desc order, or the genesis block in asc order.
start_log_indexLog index within the starting block to resume pagination or refine the starting point.
estimate_costWhen true returns the SLAM token cost for this query. It does not return any data or incur any actual charges.
Headers
AuthorizationBearer token for authentication
Trades › Responses
OK
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object | |
| type = object |
slamThe SLAM token cost for this API call.
chainThe name of the blockchain network (e.g., base).
List of token trade records matching the query.
Trades (DNA)
This endpoint retrieves trade data for a specified liquidity pool enriched with WalletDNA metrics. Developers can filter trades by size, side, or wallet behavior (IQ, Reputation, Flow, Mass, Epoch, Maker Presence). Responses include detailed trade, token, and wallet profiles, enabling advanced segmentation, smart-money tracking, and high-signal on-chain analytics in real time.
query Parameters
blockchainThe blockchain network to query.
pairThe contract address (Uniswap V2/V3) or pool ID (Uniswap V4) of the liquidity pool to fetch trades for.
trader_addressFilter trades where this address sent or received the specified token, regardless of whether they initiated the swap transaction.
maker_addressFilter trades where this address initiated the swap transaction.
sideSpecifies trade side for the implied quote token address. Wrapped native tokens and stablecoins are implied to be the base token in the trade, making the other token the quote. Otherwise the token with the lowest fully-diluted value (FDV) is assumed to be the quote token.
dnaPipe-delimited list of walletDNA metrics to return in the response. Use 'all' to display every metric. Default: all. Valid options include: tokens, intelligence, reputation, flow, mass, epoch, makerPresence, entry, all. Example: intelligence|flow|mass|tokens
min_usdMinimum trade size in USD. Filters out trades with an estimated USD value below this threshold. Calculated using on-chain price data at the time of the trade. Note: Adds additional SLAM cost to the query. A maximum of 10,000 trades that would otherwise match this query will be scanned.
max_usdMaximum trade size in USD. Filters out trades with an estimated USD value above this threshold. Calculated using on-chain price data at the time of the trade. Note: Adds additional SLAM cost to the query. A maximum of 10,000 trades that would otherwise match this query will be scanned.
min_iqMinimum holder IQ (raw score). Filters out wallets with IQ scores below this threshold. Average IQ for all wallets trading a given token is 100.
max_iqMaximum holder IQ (raw score). Filters out wallets with IQ scores above this threshold. Average IQ for all wallets trading a given token is 100. Max: Although possible, it is uncommon for wallets to have IQ scores above 200
min_intelligenceMinimum holder Intelligence tier. Filters out wallets ranked below this tier.
max_intelligenceMaximum holder Intelligence tier. Filters out wallets ranked above this tier.
min_reputationMinimum raw holder Reputation. Filters out wallets with Reputation scores below this threshold.
max_reputationMaximum raw holder Reputation. Filters out wallets with Reputation scores above this threshold. Max: 100
min_reputation_tierMinimum holder Reputation tier. Filters out wallets ranked below this tier.
max_reputation_tierMaximum holder Reputation tier. Filters out wallets ranked above this tier.
min_massMinimum raw holder Mass. Filters out wallets with Mass scores below this threshold.
max_massMaximum raw holder Mass. Filters out wallets with Mass scores above this threshold. Max: Scores above 250 are rare but possible.
min_mass_tierMinimum holder Mass tier. Filters out wallets ranked below this tier.
max_mass_tierMaximum holder Mass tier. Filters out wallets ranked above this tier.
min_epochMinimum raw holder Epoch. Filters out wallets with Epoch scores below this threshold.
max_epochMaximum raw holder Epoch. Filters out wallets with Epoch scores above this threshold. Max: 200
min_epoch_tierMinimum holder Epoch tier. Filters out wallets ranked below this tier.
max_epoch_tierMaximum holder Epoch tier. Filters out wallets ranked above this tier.
min_maker_presenceMinimum raw holder maker_presence. Filters out wallets with maker_presence scores below this threshold.
max_maker_presenceMaximum raw holder maker_presence. Filters out wallets with maker_presence scores above this threshold. Max: Scores above 200 are rare but possible.
min_maker_presence_tierMinimum holder maker_presence tier. Filters out wallets ranked below this tier.
max_maker_presence_tierMaximum holder maker_presence tier. Filters out wallets ranked above this tier.
min_flowMinimum raw holder Flow. Filters out wallets with Flow scores below this threshold.
max_flowMaximum raw holder Flow. Filters out wallets with Flow scores above this threshold. Max: Scores above 250 are rare but possible.
min_flow_tierMinimum holder Flow tier. Filters out wallets ranked below this tier.
max_flow_tierMaximum holder Flow tier. Filters out wallets ranked above this tier.
min_buy_flowMinimum raw holder min_buy_flow. Filters out wallets with buy_flow scores below this threshold.
max_buy_flowMaximum raw holder buy_flow. Filters out wallets with buy_flow scores above this threshold. Max: Scores above 250 are rare but possible.
min_buy_flow_tierMinimum holder buy_flow tier. Filters out wallets ranked below this tier.
max_buy_flow_tierMaximum holder buy_flow tier. Filters out wallets ranked above this tier.
min_sell_flowMinimum raw holder sell_flow. Filters out wallets with sell_flow scores below this threshold.
max_sell_flowMaximum raw holder sell_flow. Filters out wallets with sell_flow scores above this threshold. Max: Scores above 250 are rare but possible.
min_sell_flow_tierMinimum holder sell_flow tier. Filters out wallets ranked below this tier.
max_sell_flow_tierMaximum holder sell_flow tier. Filters out wallets ranked above this tier.
numThe maximum number of trade records to return. Maximum: 1000.
orderSort order for results: asc (oldest first) or desc (newest first).
start_timestampStart searching from this UTC timestamp (inclusive). If provided, overrides start_block as the starting point.
start_blockBlock number to start the search from (inclusive). Defaults to the latest block in desc order, or the genesis block in asc order.
start_log_indexLog index within the starting block to resume pagination or refine the starting point.
estimate_costWhen true returns the SLAM token cost for this query. It does not return any data or incur any actual charges.
Headers
AuthorizationBearer token for authentication
Trades (DNA) › Responses
OK
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object | |
| type = object |
slamThe SLAM token cost for this API call.
chainThe name of the blockchain network (e.g., base).
List of token trade records matching the query.

