Sign in

v1

latestOpenAPI 3.1.02026-07-243035381.4 MB
Marketplace

Get pair trades DNA from Cryptoslam

/v4/data/marketplace/cryptoslam/pair/trades/dna

4000 credits per API call

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.

Supported blockchains:

  • Ethereum - ethereum-mainnet
  • Base - base-mainnet
get/v4/data/marketplace/cryptoslam/pair/trades/dna

Query parameters

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

Chains supported by the tokens and wallets endpoints.

The blockchain to work with.

pairstring required
Example:0xf1fdc83c3a336bdbdc9fb06e318b08eaddc82ff4

The contract address (Uniswap V2/V3) or pool ID (Uniswap V4) of the liquidity pool to fetch trades for.

traderAddressstring
Example:0xB7B8F759E8Bd293b91632100f53a45859832f463

Filter trades where this address sent or received the specified token, regardless of whether they initiated the swap transaction.

makerAddressstring
Example:0x45e10a07a38764d84bbf0f0445dd24eedc3e7bd8

Filter trades where this address initiated the swap transaction.

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-27T17:16:31Z

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

startBlockinteger
Example:34761645

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:508

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": 5.65857866142481,
  "chain": "base",
  "cursor": {
    "start_block": 34761645,
    "start_log_index": 508
  },
  "trades": [
    {
      "transaction": {
        "utc": "2025-08-27T17:16:31Z",
        "block": 34762822,
        "hash": "0xf57796859582734ddaa55b214cd9a6613044ec6c831662a14f61b44f76864fac",
        "log_index": 170
      },
      "side": "sell",
      "usd": 397.743919,
      "quote_token": {
        "address": "0x4f9fd6be4a90f2620860d680c0d4d5fb53d1a825",
        "symbol": "AIXBT",
        "name": "aixbt by Virtuals",
        "amount": 3792.94561936705
      },
      "base_token": {
        "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "symbol": "USDC",
        "name": "USD Coin",
        "amount": 398.741271
      },
      "price": 0.10540407822228,
      "pair": {
        "address": "0xf1fdc83c3a336bdbdc9fb06e318b08eaddc82ff4",
        "name": "AIXBT/USDC",
        "labels": "Uniswap V3 Pool"
      },
      "trader": {
        "address": "0xB7B8F759E8Bd293b91632100f53a45859832f463",
        "quote_token_holding": {
          "balance": 191359.341236202,
          "staked_pct": 0.019235,
          "value_usd": 20312.1217
        },
        "intelligence": {
          "tier": "Avg++",
          "iq": 117.4
        },
        "reputation": {
          "tier": "A",
          "raw": 94.71
        },
        "mass": {
          "tier": "Dolphin",
          "raw": 117.42
        },
        "epoch": {
          "tier": "Core",
          "raw": 49.23
        },
        "maker_presence": {
          "tier": "Zero",
          "raw": 0
        },
        "flow": {
          "buy": {
            "tier": "Flood",
            "raw": 144.7
          },
          "sell": {
            "tier": "Tsunami",
            "raw": 224.85
          },
          "total": {
            "tier": "Tsunami",
            "raw": 209.3
          }
        },
        "entry": {
          "method": "DEX",
          "token_amount": 37958.904633452,
          "block": 31588672,
          "utc": "2025-06-15T05:51:31"
        }
      },
      "maker": {
        "address": "0x45e10a07a38764d84bbf0f0445dd24eedc3e7bd8"
      },
      "sender": {
        "address": "0xB7B8F759E8Bd293b91632100f53a45859832f463"
      },
      "recipient": {
        "address": "0xB7B8F759E8Bd293b91632100f53a45859832f463"
      }
    }
  ]
}