token_trades

Every swap that settles in a token's pools, whichever venue or aggregator it came through.

Subscribe

Requires a mint address.

{
  "op": "subscribe",
  "stream": "token_trades",
  "params": {
    "mint": "So11111111111111111111111111111111111111112",
    "tradeTypes": ["BUY", "SELL"],
    "minUsdAmount": "10"
  },
  "id": 1
}

Filters

Param	Type	Description
mint	string	Required. Token mint to watch.
tradeTypes	string[]	BUY, SELL, SWAP, or all.
minTokenAmount	string	Minimum token amount (human units).
minUsdAmount	string	Minimum notional in USD.
detail	basic / full	Payload level; basic by default.

tradeType is relative to the subscribed token: receiving it is BUY, sending it is SELL.

Event

{
  "op": "event",
  "sub": "tt_9f3a",
  "stream": "token_trades",
  "cursor": "330112233:17:0",
  "data": {
    "slot": 330112233,
    "signature": "5xTq…8mNv",
    "blockTime": 1769270400,
    "protocol": "pumpfun_amm",
    "tradeType": "BUY",
    "user": "7xK…3F2a",
    "input": {
      "mint": "So111…1112",
      "amountRaw": "4200000000",
      "amount": "4.2"
    },
    "output": {
      "mint": "8Wq…kR2p",
      "amountRaw": "13500000000000",
      "amount": "13500000"
    },
    "valueUsd": "612.40"
  }
}

user is the trader, not the fee payer in sponsored transactions. valueUsd is available when one leg is SOL or a stablecoin; otherwise it is null.

USD filtering

Trades with valueUsd: null pass the minUsdAmount filter.

Basic fields

Field	Type	Notes
tradeType	BUY | SELL | SWAP	Relative to the subscribed mint
user	string	Trader wallet
input	Amount	Asset sent by the trader
output	Amount	Asset received by the trader
valueUsd	string | null	USD value when SOL/stablecoin pricing is available

Full fields

Field	Type	Notes
pool	string | null	Pool account
aggregator	string | null	Aggregator when the trade is part of a route
reserves	Amount[] | null	Pool reserves when confirmed by the transaction
fees	Fee[]	Platform and other decoded fees
computeUnits	number	Transaction-level compute use
priorityFee	{ amountRaw, decimals }	Transaction priority fee
transfers	Transfer[]	Standalone movements such as tips, fees, and mints