token_transfers

Movements of one token between wallets.

Plan

Starter and above. Free receives not_on_plan with feature: "stream". See pricing for plan coverage.

Subscribe

Requires a mint address.

{
  "op": "subscribe",
  "stream": "token_transfers",
  "params": {
    "mint": "8Wq…kR2p",
    "minTokenAmount": "1000"
  },
  "id": 1
}

Filters

Param	Type	Description
mint	string	Required. Token mint to watch.
minTokenAmount	string | number	Minimum amount (human units).
detail	basic / full	Payload level; basic by default.
includeRaw	boolean	Complete transaction transfer ledger; requires full and Scale.

This stream reports direct token movements: transfers, mints, and burns. Swap legs are reported by token_trades.

Event

{
  "op": "event",
  "sub": "tx_1",
  "stream": "token_transfers",
  "cursor": "000330112240:000003:0000",
  "data": {
    "slot": 330112240,
    "signature": "7Ln…4jRt",
    "blockTime": 1769270412,
    "from": "7xK…3F2a",
    "to": "9Bd…6mQz",
    "mint": "8Wq…kR2p",
    "amountRaw": "5000000000000",
    "amount": "5000000",
    "decimals": 6
  }
}

Basic fields

Field	Type	Notes
from	string | null	Source owner wallet; null for a mint, which has no source
to	string | null	Destination owner wallet; null for a burn, which has no destination
mint	string	Token mint
amountRaw	string	Integer in smallest units
decimals	number	Token scale
amount	string	Decimal-adjusted amount

Full fields

Field	Type	Notes
kind	string	transfer, mint, or burn
fromType	string | null	Source endpoint type when identified
toType	string | null	Destination endpoint type when identified

Raw transfer fields

With includeRaw: true, rawTransfers[] contains the transaction's complete transfer ledger:

{
  "kind": "transferChecked",
  "from": "...",
  "to": "...",
  "mint": "...",
  "amountRaw": "...",
  "amount": "...",
  "fromRole": "signer",
  "toRole": "fee",
  "memo": "...",
  "class": "transfer",
  "isFee": true
}

Role and memo fields are present when the transaction supplies them.