wallet_transfers
Everything moving in or out of a wallet.
Plan
Starter and above. Free receives not_on_plan with feature: "stream". See pricing for plan coverage.
Subscribe
Requires a wallet address.
json
{
"op": "subscribe",
"stream": "wallet_transfers",
"params": {
"wallet": "7xK…3F2a",
"direction": "in",
"minUsdAmount": "50"
},
"id": 1
}Filters
| Param | Type | Description |
|---|---|---|
wallet | string | Required. Wallet to follow. |
direction | string | all (default), in, or out. |
mints | string[] | Restrict to these token mints. |
minUsdAmount | string | number | Minimum notional in USD where priced. |
detail | basic / full | Payload level; basic by default. |
includeRaw | boolean | Complete transaction transfer ledger; requires full and Scale. |
Event
json
{
"op": "event",
"sub": "wx_1",
"stream": "wallet_transfers",
"cursor": "000330112255:000009:0000",
"data": {
"slot": 330112255,
"signature": "4Mp…1nGh",
"blockTime": 1769270436,
"direction": "in",
"counterparty": "9Bd…6mQz",
"mint": "So111…1112",
"amountRaw": "2500000000",
"amount": "2.5",
"decimals": 9,
"valueUsd": "364.50"
}
}direction and counterparty are always calculated relative to the subscribed wallet.
Basic fields
| Field | Type | Notes |
|---|---|---|
direction | in | out | Relative to the subscribed wallet |
counterparty | string | null | Wallet on the other side; null for a mint or burn, which has none |
mint | string | Token mint |
amountRaw | string | Integer in smallest units |
decimals | number | Token scale |
amount | string | Decimal-adjusted amount |
valueUsd | string | null | Populated for SOL and stablecoins |
Full fields
| Field | Type | Notes |
|---|---|---|
kind | string | Transfer, mint, or burn instruction kind |
counterpartyType | string | null | Counterparty endpoint type when identified |
With includeRaw: true, rawTransfers[] has the same shape documented for token_transfers.