Sign in

v1

latestOpenAPI 3.1.02026-07-243035381.4 MB
Marketplace

Get wallet trades DNA from Cryptoslam

/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
get/v4/data/marketplace/cryptoslam/wallet/trades/dna

Query parameters

chain'ethereum-mainnet' | 'base-mainnet' required

Chains supported by the tokens and wallets endpoints.

The blockchain to work with.

walletAddressstring required
Example:0x45D964A0E60e45a5144Dc2d2273503B01f83D388

The wallet address to fetch trades for.

walletRole'trader' | 'maker'
Example: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.

tokenAddressstring
Example:0x731814e491571a2e9ee3c5b1f7f3b962ee8f4870

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

pairedTokenAddressstring
Example:0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b

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

pairstring
Example:0xa1dddb82501e8fe2d92ad0e8ba331313f501de72

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'buy' | 'sell' | 'all'
Example:sell

Specifies trade side for the implied quote token address.

dnastring
Example:intelligence|flow|mass|tokens

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.

minUsdnumber
Example:100

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

maxUsdnumber
Example:10000

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

minIqnumber
Example:120

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.

maxIqnumber
Example:180

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'idiot' | 'dumb' | 'below avg' | 'avg' | 'avg++' | 'gifted' | 'gifted++' | 'genius' | 'einstein'
Example:gifted

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

maxIntelligence'idiot' | 'dumb' | 'below avg' | 'avg' | 'avg++' | 'gifted' | 'gifted++' | 'genius' | 'einstein'
Example:genius

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

minReputationnumber
Example:80

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

maxReputationnumber
Example:95

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

minReputationTier'a+' | 'a' | 'a−' | 'b+' | 'b' | 'b−' | 'c+' | 'c' | 'c−' | 'd' | 'f'
Example:b+

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

maxReputationTier'a+' | 'a' | 'a−' | 'b+' | 'b' | 'b−' | 'c+' | 'c' | 'c−' | 'd' | 'f'
Example:a+

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

minMassnumber
Example:50

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

maxMassnumber
Example:200

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

minMassTier'ghost' | 'dust' | 'plankton' | 'shrimp' | 'minnow' | 'fish' | 'dolphin' | 'orca' | 'whale' | 'moby'
Example:fish

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

maxMassTier'ghost' | 'dust' | 'plankton' | 'shrimp' | 'minnow' | 'fish' | 'dolphin' | 'orca' | 'whale' | 'moby'
Example:whale

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

minEpochnumber
Example:30

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

maxEpochnumber
Example:150

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

minEpochTier'newbie' | 'rookie' | 'core' | 'veteran' | 'early adopter' | 'genesis' | 'og' | 'ultra og'
Example:core

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

maxEpochTier'newbie' | 'rookie' | 'core' | 'veteran' | 'early adopter' | 'genesis' | 'og' | 'ultra og'
Example:ultra og

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

minMakerPresencenumber
Example:50

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

maxMakerPresencenumber
Example:180

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

minMakerPresenceTier'hyperactive' | 'highly active' | 'active' | 'engaged' | 'occasional' | 'minimal' | 'micro' | 'zero'
Example:active

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

maxMakerPresenceTier'hyperactive' | 'highly active' | 'active' | 'engaged' | 'occasional' | 'minimal' | 'micro' | 'zero'
Example:hyperactive

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

minFlownumber
Example:50

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

maxFlownumber
Example:200

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

minFlowTier'dry' | 'drip' | 'trickle' | 'stream' | 'current' | 'flood' | 'torrent' | 'tsunami'
Example:current

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

maxFlowTier'dry' | 'drip' | 'trickle' | 'stream' | 'current' | 'flood' | 'torrent' | 'tsunami'
Example:tsunami

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

minBuyFlownumber
Example:50

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

maxBuyFlownumber
Example:200

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

minBuyFlowTier'dry' | 'drip' | 'trickle' | 'stream' | 'current' | 'flood' | 'torrent' | 'tsunami'
Example:current

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

maxBuyFlowTier'dry' | 'drip' | 'trickle' | 'stream' | 'current' | 'flood' | 'torrent' | 'tsunami'
Example:tsunami

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

minSellFlownumber
Example:50

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

maxSellFlownumber
Example:200

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

minSellFlowTier'dry' | 'drip' | 'trickle' | 'stream' | 'current' | 'flood' | 'torrent' | 'tsunami'
Example:current

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

maxSellFlowTier'dry' | 'drip' | 'trickle' | 'stream' | 'current' | 'flood' | 'torrent' | 'tsunami'
Example:tsunami

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

numinteger
Example:25

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

order'asc' | 'desc'
Example:desc

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

startTimestampstring date-time
Example:2025-08-18T06:46:35Z

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

startBlockinteger
Example:34355124

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

startLogIndexinteger
Example:582

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

estimateCostboolean

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

Response

OK

slamnumber

The SLAM token cost for this API call

chainstring

The name of the blockchain network

Example response

{
  "slam": 0.065,
  "chain": "base",
  "cursor": {
    "start_block": 31384774,
    "start_log_index": 45
  },
  "trades": [
    {
      "transaction": {
        "utc": "2025-08-18T06:46:35Z",
        "block": 34355124,
        "hash": "0x09c715d8f2c16134119d9cc53a600a09b49d1fa20dcc6cc1a8c02b4a86439d51",
        "method": "swap simple mode",
        "log_index": 582
      },
      "side": "sell",
      "usd": 10726.204254,
      "quote_token": {
        "address": "0x731814e491571a2e9ee3c5b1f7f3b962ee8f4870",
        "symbol": "VADER",
        "name": "VaderAI by Virtuals",
        "amount": 618854.223280559
      },
      "base_token": {
        "address": "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
        "symbol": "VIRTUAL",
        "name": "Virtual Protocol",
        "amount": 8899.78611752252
      },
      "price": 0.0141539462344898,
      "pair": {
        "address": "0xa1dddb82501e8fe2d92ad0e8ba331313f501de72",
        "name": "VIRTUAL/VADER",
        "labels": "Uniswap V2 Pool"
      },
      "trader": {
        "address": "0x45D964A0E60e45a5144Dc2d2273503B01f83D388",
        "quote_token_holding": {
          "balance": 223561.945721182,
          "staked_pct": 0.245384,
          "value_usd": 25065.5682
        },
        "intelligence": {
          "tier": "Genius",
          "iq": 156.87
        },
        "reputation": {
          "tier": "A+",
          "raw": 98.69
        },
        "mass": {
          "tier": "Dolphin",
          "raw": 105.89
        },
        "epoch": {
          "tier": "Ultra OG",
          "raw": 180.92
        },
        "maker_presence": {
          "tier": "Hyperactive",
          "raw": 200
        },
        "flow": {
          "buy": {
            "tier": "Torrent",
            "raw": 185.58
          },
          "sell": {
            "tier": "Torrent",
            "raw": 160.25
          },
          "total": {
            "tier": "Torrent",
            "raw": 186.24
          }
        },
        "entry": {
          "method": "AirDrop",
          "token_amount": 200000,
          "block": 32376272,
          "utc": "2025-07-03T11:24:51",
          "parent": "0xeB4F1685aadcF4075d03602C5F24Fb4bF781305D"
        }
      },
      "maker": {
        "address": "0x45d964a0e60e45a5144dc2d2273503b01f83d388"
      },
      "sender": {
        "address": "0x6E4141d33021b52C91c28608403db4A0FFB50Ec6"
      },
      "recipient": {
        "address": "0x6E4141d33021b52C91c28608403db4A0FFB50Ec6"
      }
    }
  ]
}