Appearance
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
| Param | Type | Description |
|---|---|---|
mint | string | Required. Token mint to watch. |
minTokenAmount | string | 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
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
| Field | Type | Notes |
|---|---|---|
from | string | Source owner wallet |
to | string | Destination owner wallet |
mint | string | Token mint |
amountRaw | string | Integer in smallest units |
amount | string | Decimal-adjusted amount |
Full fields
| Field | Type | Notes |
|---|---|---|
kind | string | transfer, transferChecked, 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:
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.