Skip to content

token_transfers

Movements of one token between wallets.

Plan

Starter and above. Free receives not_on_plan with feature: "stream".

Subscribe

Requires a mint address.

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

Filters

ParamTypeDescription
mintstringRequired. Token mint to watch.
minTokenAmountstringMinimum amount (human units).
detailbasic / fullPayload level; basic by default.
includeRawbooleanComplete 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

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

Basic fields

FieldTypeNotes
fromstringSource owner wallet
tostringDestination owner wallet
mintstringToken mint
amountRawstringInteger in smallest units
amountstringDecimal-adjusted amount

Full fields

FieldTypeNotes
kindstringtransfer, transferChecked, mint, or burn
fromTypestring | nullSource endpoint type when identified
toTypestring | nullDestination endpoint type when identified

Raw transfer fields

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

json
{
  "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.

Realtime Solana data API