Get wallet trades DNA from Cryptoslam

get

https://api.tatum.io/v4/data/marketplace/cryptoslam/wallet/trades/dna

/v4/data/marketplace/cryptoslam/wallet/trades/dna

4000 credits per API call

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.

Supported blockchains:

Ethereum - ethereum-mainnet
Base - base-mainnet

Query Params

chain

string

enum

required

The blockchain to work with.

Allowed:

walletAddress

string

required

The wallet address to fetch trades for.

walletRole

string

enum

Defaults to trader

Filter 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.

Allowed:

tokenAddress

string

The ERC-20 token contract address to fetch trades for.

pairedTokenAddress

string

Filter trades where the specified token was swapped against this paired token address, regardless of pool.

pair

string

The 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.

side

string

enum

Defaults to all

Specifies trade side for the implied quote token address.

Allowed:

dna

string

Defaults to all

Pipe-delimited list of walletDNA metrics to return in the response. Use 'all' to display every metric. Valid options include: tokens, intelligence, reputation, flow, mass, epoch, makerPresence, entry, all.

minUsd

number

Minimum trade size in USD. Filters out trades with an estimated USD value below this threshold. Note: Adds additional SLAM cost to the query.

maxUsd

number

Maximum trade size in USD. Filters out trades with an estimated USD value above this threshold. Note: Adds additional SLAM cost to the query.

minIq

number

Minimum holder IQ (raw score). Filters out wallets with IQ scores below this threshold. Average IQ for all wallets trading a given token is 100.

maxIq

number

Maximum 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.

minIntelligence

string

enum

Minimum holder Intelligence tier. Filters out wallets ranked below this tier.

maxIntelligence

string

enum

Maximum holder Intelligence tier. Filters out wallets ranked above this tier.

minReputation

number

Minimum raw holder Reputation. Filters out wallets with Reputation scores below this threshold.

maxReputation

number

≤ 100

Maximum raw holder Reputation. Filters out wallets with Reputation scores above this threshold. Max: 100.

minReputationTier

string

enum

Minimum holder Reputation tier. Filters out wallets ranked below this tier.

maxReputationTier

string

enum

Maximum holder Reputation tier. Filters out wallets ranked above this tier.

minMass

number

Minimum raw holder Mass. Filters out wallets with Mass scores below this threshold.

maxMass

number

Maximum raw holder Mass. Filters out wallets with Mass scores above this threshold. Max: Scores above 250 are rare but possible.

minMassTier

string

enum

Minimum holder Mass tier. Filters out wallets ranked below this tier.

maxMassTier

string

enum

Maximum holder Mass tier. Filters out wallets ranked above this tier.

minEpoch

number

Minimum raw holder Epoch. Filters out wallets with Epoch scores below this threshold.

maxEpoch

number

≤ 200

Maximum raw holder Epoch. Filters out wallets with Epoch scores above this threshold. Max: 200.

minEpochTier

string

enum

Minimum holder Epoch tier. Filters out wallets ranked below this tier.

maxEpochTier

string

enum

Maximum holder Epoch tier. Filters out wallets ranked above this tier.

minMakerPresence

number

Minimum raw holder maker_presence. Filters out wallets with maker_presence scores below this threshold.

maxMakerPresence

number

Maximum raw holder maker_presence. Filters out wallets with maker_presence scores above this threshold. Max: Scores above 200 are rare but possible.

minMakerPresenceTier

string

enum

Minimum holder maker_presence tier. Filters out wallets ranked below this tier.

maxMakerPresenceTier

string

enum

Maximum holder maker_presence tier. Filters out wallets ranked above this tier.

minFlow

number

Minimum raw holder Flow. Filters out wallets with Flow scores below this threshold.

maxFlow

number

Maximum raw holder Flow. Filters out wallets with Flow scores above this threshold. Max: Scores above 250 are rare but possible.

minFlowTier

string

enum

Minimum holder Flow tier. Filters out wallets ranked below this tier.

maxFlowTier

string

enum

Maximum holder Flow tier. Filters out wallets ranked above this tier.

minBuyFlow

number

Minimum raw holder buy_flow. Filters out wallets with buy_flow scores below this threshold.

maxBuyFlow

number

Maximum raw holder buy_flow. Filters out wallets with buy_flow scores above this threshold. Max: Scores above 250 are rare but possible.

minBuyFlowTier

string

enum

Minimum holder buy_flow tier. Filters out wallets ranked below this tier.

maxBuyFlowTier

string

enum

Maximum holder buy_flow tier. Filters out wallets ranked above this tier.

minSellFlow

number

Minimum raw holder sell_flow. Filters out wallets with sell_flow scores below this threshold.

maxSellFlow

number

Maximum raw holder sell_flow. Filters out wallets with sell_flow scores above this threshold. Max: Scores above 250 are rare but possible.

minSellFlowTier

string

enum

Minimum holder sell_flow tier. Filters out wallets ranked below this tier.

maxSellFlowTier

string

enum

Maximum holder sell_flow tier. Filters out wallets ranked above this tier.

num

integer

1 to 1000

Defaults to 25

The maximum number of trade records to return (1-1000).

order

string

enum

Defaults to desc

Sort order for results: asc (oldest first) or desc (newest first).

Allowed:

startTimestamp

date-time

Start searching from this UTC timestamp (inclusive). If provided, overrides start_block as the starting point.

startBlock

integer

Block number to start the search from (inclusive). Defaults to the latest block in desc order, or the genesis block in asc order.

startLogIndex

integer

Log index within the starting block to resume pagination or refine the starting point.

estimateCost

boolean

Defaults to false

When true, returns only the SLAM token cost for this query without performing the actual query.

Responses

200OK

400Bad Request

401Unauthorized. Not valid or inactive subscription key present in the HTTP Header.

403Forbidden. The request is authenticated, but it is not possible to perform the operation due to logical error or invalid permissions.

500Internal server error. There was an error on the server during the processing of the request.