---
title: "Get \"Token God Mode\" (TGM) DEX trades data"
method: POST
path: "/api/v1/tgm/dex-trades"
tags: ["Token God Mode"]
---

# Get "Token God Mode" (TGM) DEX trades data

`POST /api/v1/tgm/dex-trades`

Access individual DEX trading transactions for a specific token. Shows detailed trade-by-trade data including trader labels, amounts, and prices.

## Request body

- TGMDexTradesRequest — Request model for TGM dex-trades endpoint. This endpoint provides all DEX trades for a specific token with optional filtering for smart money wallets only.
  - `chain` 'arbitrum' | 'avalanche' | 'base' | 'bnb' | 'ethereum' | 'hyperevm' | 'hyperliquid' | 'injective' | 'iotaevm' | 'linea' | 'mantle' | 'mantra' | 'monad' | 'near' | 'optimism' | 'plasma' | 'polygon' | 'robinhood' | 'sei' | 'solana' | 'sonic' | 'starknet' | 'sui' | 'ton' | 'tron', required — Chains supported in TGM (Token God Mode) endpoints.
  - `token_address` string, required — Token address
  - `only_smart_money` boolean — Returns only the DEX Trades made by Smart Money wallets
  - `date` DateRange, required — Date range model matching the API schema.
    - `from` string — Start date in ISO 8601 format (e.g., 2025-01-01T00:00:00Z or 2025-01-01)
    - `to` string — End date in ISO 8601 format (e.g., 2025-01-31T23:59:59Z or 2025-01-31)
  - `pagination` PaginationRequest — Pagination parameters for API requests.
    - `page` integer — Page number (1-based)
    - `per_page` integer — Number of records per page (max 1000)
  - `filters` TGMDexTradesFilters — Filters for TGM DEX trades endpoint. These filters control which DEX trades are included in the analysis.
    - `include_smart_money_labels` LabelType[] — Include smart money labels for counterparties
    - `exclude_smart_money_labels` LabelType[] — Exclude smart money labels for counterparties
    - `block_timestamp` DateRangeFilter — Filter for date ranges with optional from/to bounds. - Date range
      - `from` union — Start date (inclusive), ISO 8601 format (e.g., 2025-01-01T00:00:00Z or 2025-01-01)
        - string, date-time
        - string
      - `to` union — End date (inclusive), ISO 8601 format (e.g., 2025-01-31T23:59:59Z or 2025-01-31)
        - string, date-time
        - string
    - `transaction_hash` union — Transaction hash filter
      - string
      - string[]
    - `trader_address` union — Trader address filter
      - string
      - string[]
    - `trader_address_label` union — Trader name filter
      - string
      - string[]
    - `token_address` union — Token address filter
      - string
      - string[]
    - `action` 'BUY' | 'SELL' — TGM who bought/sold type.
    - `token_name` string — Token name filter
    - `token_amount` NumericRangeFilter — Filter for numeric values (floats) with optional min/max bounds. Use for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75
      - `min` number — Minimum value (inclusive)
      - `max` number — Maximum value (inclusive)
    - `traded_token_address` union — Traded token address filter
      - string
      - string[]
    - `traded_token_name` string — Traded token name filter
    - `traded_token_amount` NumericRangeFilter — Filter for numeric values (floats) with optional min/max bounds. Use for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75
      - `min` number — Minimum value (inclusive)
      - `max` number — Maximum value (inclusive)
    - `estimated_swap_price_usd` NumericRangeFilter — Filter for numeric values (floats) with optional min/max bounds. Use for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75
      - `min` number — Minimum value (inclusive)
      - `max` number — Maximum value (inclusive)
    - `estimated_value_usd` NumericRangeFilter — Filter for numeric values (floats) with optional min/max bounds. Use for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75
      - `min` number — Minimum value (inclusive)
      - `max` number — Maximum value (inclusive)
  - `order_by` SortOrderTGMDexTradesSortField[] — Custom sort order to override the endpoint's default ordering. Examples: - [{"field": "block_timestamp", "direction": "DESC"}] - Sort by timestamp descending - [{"field": "estimated_value_usd", "direction": "ASC"}] - Sort by estimated value ascending - [{"field": "token_amount", "direction": "DESC"}] - Sort by token amount descending
    - `field` 'block_timestamp' | 'transaction_hash' | 'trader_address' | 'trader_address_label' | 'token_address' | 'action' | 'token_name' | 'token_amount' | 'traded_token_address' | 'traded_token_name' | 'traded_token_amount' | 'estimated_swap_price_usd' | 'estimated_value_usd', required — Enum for sortable fields in TGM DEX trades.
    - `direction` 'ASC' | 'DESC', required — Enum for sort directions.

## Response `200`

TGM DEX trades data

- TGMDexTradesResponse — Response model for TGM dex-trades endpoint. Contains a list of DEX trade records with pagination and metadata.
  - `data` TGMDexTrade[], required — List of TGM DEX trade records
    - `block_timestamp` string, required — Block timestamp of the trade
    - `transaction_hash` string, required — Transaction hash
    - `trader_address` string, required — Trader's address
    - `trader_address_label` string — Name of the trader, based on nansen_label
    - `action` 'BUY' | 'SELL', required — TGM who bought/sold type.
    - `token_address` string, required — Address of token
    - `token_name` string, required — The name of the token
    - `token_amount` number, required — The amount of the specified token traded
    - `traded_token_address` string, required — Address of token
    - `traded_token_name` string, required — The name of the token traded for the specified token
    - `traded_token_amount` number, required — The amount of the token traded for the specified token
    - `estimated_swap_price_usd` number, required — Estimated swap price in USD, derived from the counterpart token's USD value. Falls back to the daily median token price if the counterpart price is unavailable.
    - `estimated_value_usd` number, required — The estimated value of the trade in USD
  - `pagination` PaginationInfo, required — Pagination information for API responses.
    - `page` integer — Current page number
    - `per_page` integer — Number of records per page
    - `is_last_page` boolean — Whether this is the last page

## Other responses

- `400` — Bad Request - Invalid request parameters or malformed request
- `401` — Authentication error - No API key found in request
- `402` — Payment Required - This endpoint supports pay-per-request via x402 and MPP. x402 responses advertise payment options in `Payment-Required`; MPP responses advertise a fresh `WWW-Authenticate: Payment ...` challenge. Successful MPP responses may include `Payment-Receipt`.
- `403` — Forbidden - User does not have required subscription tier or has exceeded credit limit
- `404` — Not Found - The requested resource was not found
- `422` — Validation error - Invalid request parameters
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.net/nansen/apis/nansen-api.md) · [All operations](https://skmtc.net/nansen/apis/nansen-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nansen/nansen-api/revisions/02a4d2e7d827/schema)