Sign in

v1

latestOpenAPI 3.1.02026-07-243035381.4 MB
Token API

Get transactions DNA

/v4/data/transactions/dna

5000 credits per API call

This endpoint retrieves trade data across the entire blockchain 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

> 📘 Note for Free Users > > As a free user, your data is cached on a 1-day refresh cycle, and wallet queries run through tatumio.eth. This setup helps lower costs so you can easily try out the API. For real-time data, faster syncs, and the full capability of our platform, we recommend upgrading to a paid plan.

get/v4/data/transactions/dna

Query parameters

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

The blockchain to work with.

walletAddressstring required
Example:0xdef1c0ded9bec7f1a1670819833240f027b25eff

The wallet address to fetch transactions for.

tokenAddressstring
Example:0xdef1c0ded9bec7f1a1670819833240f027b25eff

Optional filter transactions for this ERC-20 token contract address.

addressstring
Example:0xdef1c0ded9bec7f1a1670819833240f027b25eff

Optional filter to only include transactions involving this address.

blockNumbernumber
Example:16499510
order'asc' | 'desc'
Example:desc

Sort order, asc (oldest first) or desc (newest first).

direction'sent' | 'received' | 'all'
Example:sent

Transaction direction relative to the address.

pageSizenumber
Example:10

Max number of transaction records to return (max 100)

startTimestampnumber

Start from this UTC timestamp in format YYYY-MM-DDTHH:mm:ssZ (overrides blockNumber)

cursorstring
Example:eyJwYWdlIjoyfQ==

Optional cursor for pagination, obtained from the response

Response

OK

Example response

{
  "data": [
    {
      "chain": "ethereum-mainnet",
      "walletAddress": "0x80d8bac9a6901698b3749fe336bbd1385c1f98f2",
      "tokenAddress": "0x1234567890abcdef1234567890abcdef12345678",
      "direction": "incoming",
      "amount": "100.0",
      "blockNumber": 16499510,
      "timestamp": 1678715303000,
      "txHash": "0x549447710026cef714da21fb29cbfae1f689bd3246f2fa0a5081149c4aeb3bb3"
    }
  ],
  "pagination": {
    "pageSize": 50,
    "cursor": "eyJwYWdlIjoyfQ=="
  }
}