---
title: "Get token trades"
method: GET
path: "/api/2/token/trades"
tags: ["V2 - Trades"]
---

# Get token trades

`GET /api/2/token/trades`

Retrieve trades for a specific token or pool with pagination, filtering by swap types, addresses, dates, and amounts.

## Query parameters

- `chainId` string — Blockchain chain ID (e.g., "evm:56", "solana:solana")
- `address` string — Token or pool contract address
- `offset` number, nullable — Offset for pagination (default: 0)
- `limit` number, nullable — Number of trades per page (default: 10)
- `sortOrder` 'asc' | 'desc', required — Sort order: asc or desc (default: desc)
- `mode` 'pair' | 'pool' | 'asset', required — Query mode: "pair" (pool address), "asset" (token address). Auto-detects if omitted.
- `label` 'sniper' | 'insider' | 'bundler' | 'proTrader' | 'smartTrader' | 'freshTrader' | 'dev' | 'liquidityPool' | 'locker' — Filter by wallet label (e.g., sniper, insider, bundler)
- `swapTypes` union — Comma-separated swap types to filter (e.g., "REGULAR,MEV")
  - string
  - string[]
- `type` 'buy' | 'sell' — Filter by trade direction: "buy" or "sell"
- `transactionSenderAddresses` union — Comma-separated wallet addresses to filter (max 25)
  - string
  - string[]
- `maxAmountUSD` number, nullable — Maximum trade amount in USD
- `minAmountUSD` number, nullable — Minimum trade amount in USD
- `fromDate` union — Start date filter (timestamp or ISO string)
  - integer, nullable
  - string, nullable
  - unknown
- `toDate` union — End date filter (timestamp or ISO string)
  - integer, nullable
  - string, nullable
  - unknown

## Response `200`

Token trades response

- object
  - `data` object[], required
    - `id` string, required
    - `operation` 'regular' | 'mev' | 'mev_sandwiched' | 'deposit' | 'withdrawal' | 'bond', required
    - `type` 'buy' | 'sell' | 'deposit' | 'withdrawal', required
    - `baseTokenAmount` number, required
    - `baseTokenAmountRaw` string, required
    - `baseTokenAmountUSD` number, required
    - `quoteTokenAmount` number, required
    - `quoteTokenAmountRaw` string, required
    - `quoteTokenAmountUSD` number, required
    - `preBalanceBaseToken` string, nullable
    - `preBalanceQuoteToken` string, nullable
    - `postBalanceBaseToken` string, nullable
    - `postBalanceQuoteToken` string, nullable
    - `date` number, required
    - `swapSenderAddress` string, required
    - `transactionSenderAddress` string, required
    - `swapRecipient` string, nullable
    - `blockchain` string, required
    - `transactionHash` string, required
    - `marketAddress` string, required
    - `marketAddresses` string[]
    - `baseTokenPriceUSD` number, required
    - `quoteTokenPriceUSD` number, required
    - `baseTokenMarketCapUSD` number, nullable
    - `quoteTokenMarketCapUSD` number, nullable
    - `labels` string[], nullable
    - `walletMetadata` object, nullable
      - `entityName` string, nullable, required
      - `entityLogo` string, nullable, required
      - `entityLabels` string[], required
      - `entityType` string, nullable, required
      - `entityDescription` string, nullable, required
      - `entityTwitter` string, nullable, required
      - `entityWebsite` string, nullable, required
      - `entityGithub` string, nullable, required
      - `entityDiscord` string, nullable, required
      - `entityTelegram` string, nullable, required
      - `extra` object
    - `baseToken` object, nullable
      - `address` string, required
      - `name` string, nullable, required
      - `symbol` string, nullable, required
      - `logo` string, nullable, required
      - `decimals` number, required
    - `quoteToken` object, nullable
      - `address` string, required
      - `name` string, nullable, required
      - `symbol` string, nullable, required
      - `logo` string, nullable, required
      - `decimals` number, required
    - `platform` object, nullable
      - `id` string, required
      - `name` string, required
      - `logo` string, nullable, required
    - `totalFeesUSD` number, nullable
    - `gasFeesUSD` number, nullable
    - `platformFeesUSD` number, nullable
    - `mevFeesUSD` number, nullable

## Other responses

- `402` — Payment Required

---

[API](https://skmtc.net/mobula/apis/mobula-api.md) · [All operations](https://skmtc.net/mobula/apis/mobula-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mobula/mobula-api/versions/32f95d9e8ff2/schema)