Reputation
Returns reputation scores for one or more wallets using on-chain behavioral analysis across their token portfolio.
query Parameters
blockchainstring · enum · requiredThe blockchain network to query.
Enum values:ethereumbaseDefault: baseaddressesstring · requiredPipe-delimited list of wallet addresses. Max: 75
at_block_numberinteger · int32Block number at which to calculate reputation
at_timestampstring · date-timeUTC timestamp for calculating reputation (ignored if block number is present)
estimate_costbooleanIf true, only the SLAM token cost is returned
Headers
Authorizationstring · requiredBearer token for authentication
Responses
OK
slamnumber · doubleSLAM token cost for this API call
chainstringBlockchain network name (e.g., 'base')
blockinteger · int32Block number for the reputation snapshot
utcstringUTC timestamp of the snapshot in ISO 8601 format
walletsobject[]List of wallet reputation records
Reputation (Full)
Returns composite reputation scores along with per-token scores for all tokens held in each wallet.
query Parameters
blockchainstring · enum · requiredThe blockchain network to query.
Enum values:ethereumbaseDefault: baseaddressesstring · requiredPipe-delimited list of wallet addresses. Max: 75
at_block_numberinteger · int32Block number to calculate reputation at
at_timestampstring · date-timeUTC timestamp to calculate reputation at (ignored if block number is present)
estimate_costbooleanIf true, only the SLAM token cost is returned
Default: false
Headers
Authorizationstring · requiredBearer token for authentication
Responses
slamnumber · doubleSLAM token cost for this API call
chainstringBlockchain network name
blockinteger · int32Block number used for reputation snapshot
utcstringUTC ISO 8601 timestamp of snapshot
walletsobject[]List of wallets and their full reputation profiles
slamnumber · double
Reputation (Holder)
Returns reputation scores for a wallet across one or more specific tokens.
query Parameters
blockchainstring · enum · requiredThe blockchain network to query.
Enum values:ethereumbaseDefault: basewallet_addressstring · requiredAddress of the wallet to query
token_addressesstring · requiredPipe-delimited list of token addresses to query
token_symbolsstringPipe-delimited list of token symbols to query
at_block_numberinteger · int32Block number to calculate reputation at
at_timestampstring · date-timeUTC timestamp to calculate reputation at (ignored if block number is present)
estimate_costbooleanIf true, only the SLAM token cost is returned
Default: false
Headers
Authorizationstring · requiredBearer token for authentication
Responses
slamnumber · doubleSLAM token cost for this API call
chainstringBlockchain network name
blockinteger · int32Block number for the reputation snapshot
utcstringUTC timestamp in ISO 8601 format
holdersobject[]List of token-specific reputation records for the wallet
slamnumber · double
Trades
Returns trades for a specified wallet address as the trader (default) or maker, with optional filtering by token, paired token, pair, side, block range, or timestamp range.
query Parameters
blockchainstring · enum · requiredThe blockchain network to query.
Enum values:ethereumbaseDefault: basewallet_addressstring · requiredThe wallet address to fetch trades for.
wallet_rolestring · enumFilter trades where the specified wallet_address acted in the given role. Trader (default) where the wallet sent or received the token, regardless of initiating the swap transaction, or maker where the wallet initiated the swap transaction.
Enum values:tradermakerDefault: tradertoken_addressstringThe ERC-20 token contract address to fetch trades for.
paired_token_addressstringFilter trades where the specified token was swapped against this paired token address, regardless of pool.
pairstringThe contract address (Uniswap V2/V3) or pool ID (Uniswap V4) of the liquidity pool to fetch trades for. When present, overrides token_address and paired_token_address.
sidestring · enumSpecifies trade side for the given token_address.
Enum values:buysellallDefault: allmin_usdnumber · doubleMinimum 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_usdnumber · doubleMaximum 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.
numinteger · int32The maximum number of records to return.
Default: 25orderstringSort order: asc (oldest first) or desc (newest first).
Default: descstart_timestampstring · date-timeStart searching from this UTC timestamp (inclusive). If provided, overrides start_block as the starting point.
start_blockinteger · int32Block number to start the search from (inclusive). Defaults to the latest block in desc order, or the genesis block in asc order.
start_log_indexinteger · int32Log index within the starting block to resume pagination or refine the starting point.
estimate_costbooleanWhen true returns the SLAM token cost for this query. It does not return any data or incur any actual charges.
Headers
Authorizationstring · requiredBearer token for authentication
Responses
slamnumber · doubleThe SLAM token cost for this API call.
chainstringThe name of the blockchain network (e.g., base).
cursorobjecttradesobject[]List of token trade records matching the query.
slamnumber · double
Trades (DNA)
The Wallet Trades DNA endpoint returns all trades for a specific wallet, enriched with HolderDNA metrics calculated at the time of each swap. Supports DNA-based filters, allowing segmentation across different tokens. This lets you track how wallet intelligence, reputation, and other behavioral signals evolve per token throughout trading history.
query Parameters
blockchainstring · enum · requiredThe blockchain network to query.
Enum values:ethereumbaseDefault: basewallet_addressstring · requiredThe wallet address to fetch trades for.
wallet_rolestring · enum · requiredFilter trades where the specified wallet_address acted in the given role. Valid values: trader (default) where the wallet sent or received the token, regardless of initiating the swap transaction, or maker where the wallet initiated the swap transaction.
Enum values:tradermakerDefault: tradertoken_addressstringThe ERC-20 token contract address to fetch trades for.
paired_token_addressstringFilter trades where the specified token was swapped against this paired token address, regardless of pool.
pairstringThe contract address (Uniswap V2/V3) or pool ID (Uniswap V4) of the liquidity pool to fetch trades for. When present, overrides token_address and paired_token_address.
sidestring · enumSpecifies 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.
Enum values:buysellallDefault: alldnastringPipe-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
Default: allmin_usdnumber · doubleMinimum 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_usdnumber · doubleMaximum 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_iqnumber · doubleMinimum 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_iqnumber · doubleMaximum 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_intelligencestring · enumMinimum holder Intelligence tier. Filters out wallets ranked below this tier.
Enum values:idiotdumbbelow avgavgavg++giftedgifted++geniusmax_intelligencestring · enumMaximum holder Intelligence tier. Filters out wallets ranked above this tier.
Enum values:idiotdumbbelow avgavgavg++giftedgifted++geniusmin_reputationnumber · doubleMinimum raw holder Reputation. Filters out wallets with Reputation scores below this threshold.
max_reputationnumber · doubleMaximum raw holder Reputation. Filters out wallets with Reputation scores above this threshold. Max: 100
min_reputation_tierstring · enumMinimum holder Reputation tier. Filters out wallets ranked below this tier.
Enum values:a+aa−b+bb−c+cmax_reputation_tierstring · enumMaximum holder Reputation tier. Filters out wallets ranked above this tier.
Enum values:a+aa−b+bb−c+cmin_massnumber · doubleMinimum raw holder Mass. Filters out wallets with Mass scores below this threshold.
max_massnumber · doubleMaximum raw holder Mass. Filters out wallets with Mass scores above this threshold. Max: Scores above 250 are rare but possible.
min_mass_tierstring · enumMinimum holder Mass tier. Filters out wallets ranked below this tier.
Enum values:ghostdustplanktonshrimpminnowfishdolphinorcamax_mass_tierstring · enumMaximum holder Mass tier. Filters out wallets ranked above this tier.
Enum values:ghostdustplanktonshrimpminnowfishdolphinorcamin_epochnumber · doubleMinimum raw holder Epoch. Filters out wallets with Epoch scores below this threshold.
max_epochnumber · doubleMaximum raw holder Epoch. Filters out wallets with Epoch scores above this threshold. Max: 200
min_epoch_tierstring · enumMinimum holder Epoch tier. Filters out wallets ranked below this tier.
Enum values:newbierookiecoreveteranearly adoptergenesisogultra ogmax_epoch_tierstring · enumMaximum holder Epoch tier. Filters out wallets ranked above this tier.
Enum values:newbierookiecoreveteranearly adoptergenesisogultra ogmin_maker_presencenumber · doubleMinimum raw holder maker_presence. Filters out wallets with maker_presence scores below this threshold.
max_maker_presencenumber · doubleMaximum 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_tierstring · enumMinimum holder maker_presence tier. Filters out wallets ranked below this tier.
Enum values:hyperactivehighly activeactiveengagedoccasionalminimalmicrozeromax_maker_presence_tierstring · enumMaximum holder maker_presence tier. Filters out wallets ranked above this tier.
Enum values:hyperactivehighly activeactiveengagedoccasionalminimalmicrozeromin_flownumber · doubleMinimum raw holder Flow. Filters out wallets with Flow scores below this threshold.
max_flownumber · doubleMaximum raw holder Flow. Filters out wallets with Flow scores above this threshold. Max: Scores above 250 are rare but possible.
min_flow_tierstring · enumMinimum holder Flow tier. Filters out wallets ranked below this tier.
Enum values:drydriptricklestreamcurrentfloodtorrenttsunamimax_flow_tierstring · enumMaximum holder Flow tier. Filters out wallets ranked above this tier.
Enum values:drydriptricklestreamcurrentfloodtorrenttsunamimin_buy_flownumber · doubleMinimum raw holder min_buy_flow. Filters out wallets with buy_flow scores below this threshold.
max_buy_flownumber · doubleMaximum 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_tierstring · enumMinimum holder buy_flow tier. Filters out wallets ranked below this tier.
Enum values:drydriptricklestreamcurrentfloodtorrenttsunamimax_buy_flow_tierstring · enumMaximum holder buy_flow tier. Filters out wallets ranked above this tier.
Enum values:drydriptricklestreamcurrentfloodtorrenttsunamimin_sell_flownumber · doubleMinimum raw holder sell_flow. Filters out wallets with sell_flow scores below this threshold.
max_sell_flownumber · doubleMaximum 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_tierstring · enumMinimum holder sell_flow tier. Filters out wallets ranked below this tier.
Enum values:drydriptricklestreamcurrentfloodtorrenttsunamimax_sell_flow_tierstring · enumMaximum holder sell_flow tier. Filters out wallets ranked above this tier.
Enum values:drydriptricklestreamcurrentfloodtorrenttsunaminuminteger · int32The maximum number of trade records to return. Maximum: 1000.
Default: 25orderstring · enumSort order for results: asc (oldest first) or desc (newest first).
Enum values:ascdescDefault: descstart_timestampstring · date-timeStart searching from this UTC timestamp (inclusive). If provided, overrides start_block as the starting point.
start_blockinteger · int32Block number to start the search from (inclusive). Defaults to the latest block in desc order, or the genesis block in asc order.
start_log_indexinteger · int32Log index within the starting block to resume pagination or refine the starting point.
estimate_costbooleanWhen true returns the SLAM token cost for this query. It does not return any data or incur any actual charges.
Default: false
Headers
Authorizationstring · requiredBearer token for authentication
Responses
slamnumber · doubleThe SLAM token cost for this API call.
chainstringThe name of the blockchain network (e.g., base).
cursorobjecttradesobject[]List of token trade records matching the query.
slamnumber · double
Transfers
Returns token transfers for a specified wallet address, with optional filtering by token address, participant address, direction, block range, or timestamp range. You may filter by either tokenAddress or address, but not both.
query Parameters
blockchainstring · enum · requiredThe blockchain to query
Enum values:ethereumbaseDefault: basewallet_addressstringThe wallet address to fetch transfers for. (Required)
addressstringFilter transfers where this address is either the sender or the receiver.
token_addressstringThe ERC-20 token contract address to fetch transfers for.
directionstring · enumTransfer direction relative to the address.
Enum values:sentreceivedallDefault: allnuminteger · int32The maximum number of transfer records to return (1-1000).
Default: 25orderstring · enumSort order for results: 'asc' (oldest first) or 'desc' (newest first).
Enum values:ascdescDefault: descstart_timestampstring · date-timeStart searching from this UTC timestamp (inclusive). Overrides start_block when provided.
start_blockinteger · int32Block number to start the search from (inclusive).
start_log_indexinteger · int32Log index within the starting block to resume pagination or refine the starting point.
estimate_costbooleanWhen true, returns only the SLAM token cost for this query.
Default: false
Headers
Authorizationstring · requiredBearer token for authentication
Responses
slamnumber · doubleThe SLAM token cost for this API call.
chainstringThe blockchain network name (e.g., 'base').
cursorobjecttransfersobject[]List of token transfer records matching the query.
slamnumber · double
Transfers (DNA)
Returns token transfer records for a given wallet address, enriched with WalletDNA analytics—including sender and receiver wallet tiers ("size"), labels, current balances (token & USD), and each address's share of supply. Each record includes FDV and live token pricing. Supports filtering by participant address, direction, block range, or timestamp. Longer response times should be expected due to the richness of the data.
query Parameters
blockchainstring · enum · requiredThe blockchain network to query.
Enum values:ethereumbaseDefault: basewallet_addressstring · requiredThe wallet address to fetch transfers for.
addressstringOptional filter to only include transfers involving this address
token_addressstringOptional filter transfers for this ERC-20 token contract address.
directionstring · enumTransfer direction relative to the address.
Enum values:sentreceivedallDefault: allnuminteger · int32Max number of transfer records to return (max 100)
Default: 25orderstring · enumSort order: asc (oldest first) or desc (newest first).
Enum values:ascdescDefault: descstart_timestampstring · date-timeStart from this UTC timestamp (overrides start_block)
start_blockinteger · int32Block number to start from (inclusive)
start_log_indexinteger · int32Log index within the block to resume pagination
estimate_costbooleanWhen true, returns only the SLAM cost without performing the query
Default: false
Headers
Authorizationstring · requiredBearer token for authentication
Responses
slamnumber · doubleSLAM token cost for this API call
chainstringBlockchain network name (e.g., 'base')
cursorobjecttransfersobject[]List of enriched token transfers with WalletDNA
slamnumber · double

