Skip to content

wallet_transfers

Everything moving in or out of a wallet.

Plan

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

Subscribe

Requires a wallet address.

json
{
  "op": "subscribe",
  "stream": "wallet_transfers",
  "params": {
    "wallet": "7xK…3F2a",
    "direction": "in",
    "minUsdAmount": "50"
  },
  "id": 1
}

Filters

ParamTypeDescription
walletstringRequired. Wallet to follow.
directionstringall (default), in, or out.
mintsstring[]Restrict to these token mints.
minUsdAmountstringMinimum notional in USD where priced.
detailbasic / fullPayload level; basic by default.
includeRawbooleanComplete transaction transfer ledger; requires full and Scale.

Event

json
{
  "op": "event",
  "sub": "wt_8d44",
  "stream": "wallet_transfers",
  "cursor": "330112255:9:0",
  "data": {
    "slot": 330112255,
    "signature": "4Mp…1nGh",
    "blockTime": 1769270436,
    "direction": "in",
    "counterparty": "9Bd…6mQz",
    "mint": "So111…1112",
    "amountRaw": "2500000000",
    "amount": "2.5",
    "valueUsd": "364.50"
  }
}

direction and counterparty are always calculated relative to the subscribed wallet.

Basic fields

FieldTypeNotes
directionin | outRelative to the subscribed wallet
counterpartystringWallet on the other side
mintstringToken mint
amountRawstringInteger in smallest units
amountstringDecimal-adjusted amount
valueUsdstring | nullPopulated for SOL and stablecoins

Full fields

FieldTypeNotes
kindstringTransfer, mint, or burn instruction kind
counterpartyTypestring | nullCounterparty endpoint type when identified

With includeRaw: true, rawTransfers[] has the same shape documented for token_transfers.

Realtime Solana data API