DEX Trades

Query recent DEX trades by token, pool, or wallet.

GET /dex/v1/{network}/trades

Returns recent DEX trades filtered by token address, pool address, or signer wallet. Exactly one filter is required per request.

When filtering by token, the API resolves all known liquidity pools for that token and returns trades across all of them. When filtering by pool, trades for that specific pair are returned. When filtering by signer, all trades executed by that wallet are returned.

Parameters

ParameterInTypeRequiredDescription
networkpathstringYesNetwork ID.
tokenquerystringOne of threeToken address. Returns trades across all pools that include this token.
poolquerystringOne of threePool / pair address. Returns trades on this specific liquidity pool.
signerquerystringOne of threeWallet address. Returns all trades executed by this wallet.
sortquerystringNoSort direction by timestamp: desc (default, newest first) or asc (oldest first).
limitqueryintegerNoNumber of trades per page (1-200, default 50).
cursorquerystringNoOpaque pagination cursor from a previous response's next_cursor.

Exactly one of token, pool, or signer must be provided. Sending zero or more than one returns 400 Bad Request.

Example Request

By Token

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.insightx.network/dex/v1/sol/trades?token=pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"

By Pool

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.insightx.network/dex/v1/sol/trades?pool=BofA2ViUSudPBTUms2KRuG6AHNeMawjNfwqTJDgx5BKW"

By Signer (Wallet)

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.insightx.network/dex/v1/sol/trades?signer=5Yqw3pMxstwjHDmPAQaWcKpVvehemtERaSGePRshDXtX"

Response

{
  "trades": [
    {
      "block_time": "2026-03-01T12:30:45.123456+00:00",
      "block": 310500012,
      "tx_signature": "5K8kL9...",
      "dex": "raydium",
      "dex_version": "v4",
      "signer": "5Yqw3pMxstwjHDmPAQaWcKpVvehemtERaSGePRshDXtX",
      "receiver": "5Yqw3pMxstwjHDmPAQaWcKpVvehemtERaSGePRshDXtX",
      "pool_address": "BofA2ViUSudPBTUms2KRuG6AHNeMawjNfwqTJDgx5BKW",
      "token_in": {
        "address": "So11111111111111111111111111111111111111112",
        "amount": 2.99252994,
        "amount_usd": 262.36
      },
      "token_out": {
        "address": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
        "amount": 5096335.626971,
        "amount_usd": 261.70
      },
      "fee_usd": 0.66
    }
  ],
  "next_cursor": "eyJ0IjoiMjAyNi0wMy0wMVQxMjozMDo0NS4xMjM0NTYrMDA6MDAiLCJpIjoxOTg0Mzc2MjF9"
}

Fields

Top Level

FieldTypeDescription
tradesarrayList of trade objects for the current page
next_cursorstring or nullOpaque cursor for fetching the next page. null when there are no more results.

Trade Object

FieldTypeDescription
block_timestringISO 8601 timestamp of when the trade occurred on-chain
blockintegerBlock (slot) number when the trade occurred
tx_signaturestringTransaction signature
dexstringDEX name (e.g. "raydium", "pumpfun", "cetus")
dex_versionstringDEX version (e.g. "v4", "clmm", "whirlpool", "damm_v2")
signerstringWallet address that signed the transaction
receiverstring or nullWallet address that received the output tokens (may differ from signer in routed swaps)
pool_addressstring or nullLiquidity pool address where the trade executed
token_inobjectInput token details (see below)
token_outobjectOutput token details (see below)
fee_usdnumber or nullTrade fee in USD

Token In / Token Out Object

FieldTypeDescription
addressstringToken contract address
amountnumberAmount in human-readable units (post-decimal)
amount_usdnumber or nullAmount in USD at the time of trade

Pagination

This endpoint uses cursor-based pagination for consistent results even as new trades arrive in real time.

  1. Make your first request without a cursor parameter.
  2. If the response includes a non-null next_cursor, pass it as the cursor query parameter in your next request.
  3. Repeat until next_cursor is null.
# Page 1
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.insightx.network/dex/v1/sol/trades?token=TOKEN&limit=50"

# Page 2 (using cursor from page 1)
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.insightx.network/dex/v1/sol/trades?token=TOKEN&limit=50&cursor=eyJ0IjoiMjAyNi0wMy0wMVQxMjozMDo0NS4xMjM0NTYrMDA6MDAiLCJpIjoxOTg0Mzc2MjF9"

Use Cases

  • Trade history -- fetch the full trading history for a token, pool, or wallet.
  • Real-time feed -- poll with sort=desc and a short interval to display a live trade ticker.
  • Wallet analysis -- examine a specific wallet's trading activity across all DEXes.
  • Pool monitoring -- track all trades on a specific liquidity pool.
  • Token volume breakdown -- aggregate trades across all pools for a token to analyze volume distribution by DEX.

Network Support

NetworkStatus
Solana (sol)Supported
Sui (sui)Supported
All other networksNot supported (returns 422)