---
title: "Get transactions DNA"
method: GET
path: "/v4/data/transactions/dna"
tags: ["Token API"]
---

# Get transactions DNA

`GET /v4/data/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.

## Query parameters

- `chain` 'ethereum-mainnet' | 'base-mainnet', required
- `walletAddress` string, required
- `tokenAddress` string
- `address` string
- `blockNumber` number
- `order` 'asc' | 'desc'
- `direction` 'sent' | 'received' | 'all'
- `pageSize` number
- `startTimestamp` number
- `cursor` string

## Response `200`

OK

- ResponseArrayTransferDNA — Array response wrapper for trending tokens.
  - `data` TransferDNA[], required
    - `chain` string, required — Blockchain name.
    - `walletAddress` string, required — Wallet address.
    - `tokenAddress` string, required — Token contract address.
    - `direction` string, required — Transfer direction.
    - `amount` string, required — Transfer amount.
    - `blockNumber` number, required — Block number.
    - `timestamp` number, required — Timestamp.
    - `txHash` string, required — Transaction hash.
  - `pagination` Pagination — Optional pagination metadata (if applicable).
    - `pageNumber` integer — Current page number (if applicable).
    - `pageSize` integer — Page size used for this response.
    - `cursor` string — Opaque cursor for fetching the next page.

## 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.net/tatum/apis/blockchain-data.md) · [All operations](https://skmtc.net/tatum/apis/blockchain-data/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tatum/blockchain-data/revisions/8622ee4b8fae/schema)