---
title: "Get Smart Money DEX Trades Data"
method: POST
path: "/api/v1/smart-money/dex-trades"
tags: ["Smart Money"]
---

# Get Smart Money DEX Trades Data

`POST /api/v1/smart-money/dex-trades`

Access real-time DEX trading activity from smart traders and funds over the last 24 hours. This endpoint provides granular transaction-level data showing exactly what sophisticated traders are buying and selling on decentralized exchanges.

## Request body

- SmartMoneyDexTradesRequest
  - `chains` SmartMoneyChain[], required — Chains to include in the analysis (only smart money supported chains). Use 'all' to include all available chains.
  - `filters` SmartMoneyDexTradesFilters — Filters for smart money DEX trades endpoint. These filters control which DEX trades, tokens, and traders are included in the trades analysis.
    - `include_smart_money_labels` SmartMoneyFilterType[] — Smart money category filters
    - `exclude_smart_money_labels` SmartMoneyFilterType[] — Smart money category filters
    - `chain` union — Blockchain network filter
      - string
      - string[]
    - `transaction_hash` union — Transaction hash filter
      - string
      - string[]
    - `trader_address` union — Trader address filter
      - string
      - string[]
    - `trader_address_label` union — Trader name or label filter
      - string
      - string[]
    - `token_bought_address` union — Token address filter for bought tokens
      - string
      - string[]
    - `token_sold_address` union — Token address filter for sold tokens
      - string
      - string[]
    - `token_bought_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)
    - `token_sold_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)
    - `token_bought_symbol` union — Symbol filter for bought tokens
      - string
      - string[]
    - `token_sold_symbol` union — Symbol filter for sold tokens
      - string
      - string[]
    - `token_bought_age_days` 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)
    - `token_sold_age_days` 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)
    - `token_bought_market_cap` 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)
    - `token_sold_market_cap` 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)
    - `token_bought_fdv` 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)
    - `token_sold_fdv` 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)
    - `trade_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)
  - `pagination` PaginationRequest — Pagination parameters for API requests.
    - `page` integer — Page number (1-based)
    - `per_page` integer — Number of records per page (max 1000)
  - `order_by` SortOrderSmartMoneyDexTradesSortField[] — Custom sort order to override the endpoint's default ordering. Examples: - [{"field": "trade_value_in_usd", "direction": "DESC"}] - Sort by trade value descending - [{"field": "block_timestamp", "direction": "ASC"}] - Sort by timestamp ascending - [{"field": "token_bought_amount", "direction": "DESC"}, {"field": "block_timestamp", "direction": "ASC"}] - Sort by bought amount descending, then timestamp ascending
    - `field` 'chain' | 'block_timestamp' | 'transaction_hash' | 'trader_address' | 'trader_address_label' | 'token_bought_address' | 'token_sold_address' | 'token_bought_amount' | 'token_sold_amount' | 'token_bought_symbol' | 'token_sold_symbol' | 'token_bought_age_days' | 'token_sold_age_days' | 'token_bought_market_cap' | 'token_sold_market_cap' | 'token_bought_fdv' | 'token_sold_fdv' | 'trade_value_usd', required — Enum for sortable fields in smart money dex trades.
    - `direction` 'ASC' | 'DESC', required — Enum for sort directions.

## Response `200`

Smart money DEX trades data

- SmartMoneyDexTradesResponse — Response model for smart money dex trades endpoint. Contains the filtered smart money dex trades data with metadata.
  - `data` SmartMoneyDexTrade[], required — List of smart money dex trade records
    - `chain` string, required — Blockchain chain
    - `block_timestamp` string, required — Block timestamp of the trade
    - `transaction_hash` string, required — Transaction hash
    - `trader_address` string, required — Hexadecimal representation of the trader's address, i.e. the signer of the transaction
    - `trader_address_label` string, required — Name of the trader, based on nansen_label
    - `token_bought_address` string, required — Hexadecimal representation of the bought token's address
    - `token_sold_address` string, required — Hexadecimal representation of the sold token's address
    - `token_bought_amount` number — Amount of token bought in decimal amount
    - `token_sold_amount` number — Amount of token sold in decimal amount
    - `token_bought_symbol` string, required — Symbol of the bought token
    - `token_sold_symbol` string, required — Symbol of the sold token
    - `token_bought_age_days` integer, required — Age of bought token's address in days
    - `token_sold_age_days` integer, required — Age of sold token's address in days
    - `token_bought_market_cap` number — Circulating market cap of bought token in USD. Returns NULL when circulating supply data is unavailable.
    - `token_sold_market_cap` number — Circulating market cap of sold token in USD. Returns NULL when circulating supply data is unavailable.
    - `token_bought_fdv` number — Fully Diluted Valuation of bought token in USD (total_supply x price). May be very large for tokens with no circulating supply data.
    - `token_sold_fdv` number — Fully Diluted Valuation of sold token in USD (total_supply x price). May be very large for tokens with no circulating supply data.
    - `trade_value_usd` number — Either token_bought_in_usd or token_sold_in_usd, if token_bought_in_usd is 0
  - `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)