---
title: "Get wallet trades DNA from Cryptoslam"
method: GET
path: "/v4/data/marketplace/cryptoslam/wallet/trades/dna"
tags: ["Marketplace"]
---

# Get wallet trades DNA from Cryptoslam

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

## Request

- Base URL: `https://api.tatum.io`
- URL: `https://api.tatum.io/v4/data/marketplace/cryptoslam/wallet/trades/dna`
- Auth: API key in header `x-api-key`

/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 parameters

- `chain` 'ethereum-mainnet' | 'base-mainnet', required: Chains supported by the tokens and wallets endpoints.
- `walletAddress` string, required
- `walletRole` 'trader' | 'maker'
- `tokenAddress` string
- `pairedTokenAddress` string
- `pair` string
- `side` 'buy' | 'sell' | 'all'
- `dna` string
- `minUsd` number
- `maxUsd` number
- `minIq` number
- `maxIq` number
- `minIntelligence` 'idiot' | 'dumb' | 'below avg' | 'avg' | 'avg++' | 'gifted' | 'gifted++' | 'genius' | 'einstein'
- `maxIntelligence` 'idiot' | 'dumb' | 'below avg' | 'avg' | 'avg++' | 'gifted' | 'gifted++' | 'genius' | 'einstein'
- `minReputation` number
- `maxReputation` number
- `minReputationTier` 'a+' | 'a' | 'a−' | 'b+' | 'b' | 'b−' | 'c+' | 'c' | 'c−' | 'd' | 'f'
- `maxReputationTier` 'a+' | 'a' | 'a−' | 'b+' | 'b' | 'b−' | 'c+' | 'c' | 'c−' | 'd' | 'f'
- `minMass` number
- `maxMass` number
- `minMassTier` 'ghost' | 'dust' | 'plankton' | 'shrimp' | 'minnow' | 'fish' | 'dolphin' | 'orca' | 'whale' | 'moby'
- `maxMassTier` 'ghost' | 'dust' | 'plankton' | 'shrimp' | 'minnow' | 'fish' | 'dolphin' | 'orca' | 'whale' | 'moby'
- `minEpoch` number
- `maxEpoch` number
- `minEpochTier` 'newbie' | 'rookie' | 'core' | 'veteran' | 'early adopter' | 'genesis' | 'og' | 'ultra og'
- `maxEpochTier` 'newbie' | 'rookie' | 'core' | 'veteran' | 'early adopter' | 'genesis' | 'og' | 'ultra og'
- `minMakerPresence` number
- `maxMakerPresence` number
- `minMakerPresenceTier` 'hyperactive' | 'highly active' | 'active' | 'engaged' | 'occasional' | 'minimal' | 'micro' | 'zero'
- `maxMakerPresenceTier` 'hyperactive' | 'highly active' | 'active' | 'engaged' | 'occasional' | 'minimal' | 'micro' | 'zero'
- `minFlow` number
- `maxFlow` number
- `minFlowTier` 'dry' | 'drip' | 'trickle' | 'stream' | 'current' | 'flood' | 'torrent' | 'tsunami'
- `maxFlowTier` 'dry' | 'drip' | 'trickle' | 'stream' | 'current' | 'flood' | 'torrent' | 'tsunami'
- `minBuyFlow` number
- `maxBuyFlow` number
- `minBuyFlowTier` 'dry' | 'drip' | 'trickle' | 'stream' | 'current' | 'flood' | 'torrent' | 'tsunami'
- `maxBuyFlowTier` 'dry' | 'drip' | 'trickle' | 'stream' | 'current' | 'flood' | 'torrent' | 'tsunami'
- `minSellFlow` number
- `maxSellFlow` number
- `minSellFlowTier` 'dry' | 'drip' | 'trickle' | 'stream' | 'current' | 'flood' | 'torrent' | 'tsunami'
- `maxSellFlowTier` 'dry' | 'drip' | 'trickle' | 'stream' | 'current' | 'flood' | 'torrent' | 'tsunami'
- `num` integer
- `order` 'asc' | 'desc'
- `startTimestamp` string, date-time
- `startBlock` integer
- `startLogIndex` integer
- `estimateCost` boolean

## Response `200`

OK

- object
  - `slam` number: The SLAM token cost for this API call
  - `chain` string: The name of the blockchain network
  - `cursor` object
    - `start_block` integer: Block number for pagination
    - `start_log_index` integer: Log index for pagination
  - `trades` object[]
    - `transaction` object
      - `utc` string, date-time
      - `block` integer
      - `hash` string
      - `method` string
      - `log_index` integer
    - `side` 'buy' | 'sell'
    - `usd` number: Trade size in USD
    - `quote_token` object
      - `address` string
      - `symbol` string
      - `name` string
      - `amount` number
    - `base_token` object
      - `address` string
      - `symbol` string
      - `name` string
      - `amount` number
    - `price` number
    - `pair` object
      - `address` string
      - `name` string
      - `labels` string
    - `trader` object
      - `address` string
      - `quote_token_holding` object
        - `balance` number
        - `staked_pct` number
        - `value_usd` number
      - `intelligence` object
        - `tier` string
        - `iq` number
      - `reputation` object
        - `tier` string
        - `raw` number
      - `mass` object
        - `tier` string
        - `raw` number
      - `epoch` object
        - `tier` string
        - `raw` number
      - `maker_presence` object
        - `tier` string
        - `raw` number
      - `flow` object
        - `buy` object
          - `tier` string
          - `raw` number
        - `sell` object
          - `tier` string
          - `raw` number
        - `total` object
          - `tier` string
          - `raw` number
      - `entry` object
        - `method` string
        - `token_amount` number
        - `block` integer
        - `utc` string, date-time
        - `parent` string
    - `maker` object
      - `address` string
    - `sender` object
      - `address` string
    - `recipient` object
      - `address` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `403`: Forbidden. The request is authenticated, but it is not possible to perform the operation due to logical error or invalid permissions.
- `500`: Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.dev/tatum/apis/blockchain-data.md) - [All operations](https://skmtc.dev/tatum/apis/blockchain-data/llms.txt) - [OpenAPI document](https://skmtc.dev/tatum/apis/blockchain-data/revisions/1a87afa0f639?raw)