Skip to main content
Streams every transfer between two wallets that matches the subscription’s filters, in real time. Each transfer is tested once, as it happens, and {} matches every transfer on every chain. Subscribe on an open stream connection. See WebSocket streams for connections, frames and reconnection, and Filtering streams for how keys, lists and ranges combine.

​
Filters

​
Addresses

tokens, wallets, senders and recipients each cover every chain in their address family that chains includes.
  • wallets matches a transfer whose sender or recipient is in the list. senders and recipients each match one side.
  • Omit a list to match every address. An empty list is rejected.
  • These four lists have no limit of their own; only the address limit applies. chains, exclude.wallets and exclude.tokens take at most 100 values each.
  • A transfer that matches two addresses of one subscription, such as its sender and its recipient, is sent once.

​
Native transfers

A native transfer moves the chain’s gas asset and has no token, so it does not match tokens or token. native: true combined with tokens or token is rejected.

​
Token state

token tests the latest state of the transferred token, as on spot.trades. A token has a state only after it changes while a subscription with a token key is open, and the state expires after 15 minutes without a change.

​
Values

A transfer has no USD or native value, so the filter has no value keys. valueUsd and valueNative are rejected like any unknown key. This channel does not accept throttleMs and does not send exit frames.

​
Message format

Each update’s data is one transfer.
​
string
required
Chain slug.
​
string | null
required
Token address; null for the chain’s native asset.
​
string
required
Wallet that sent the transfer.
​
string
required
Wallet that received the transfer.
​
string
required
Amount moved, in token units, as a decimal string.
​
string | null
required
Sender’s balance of the asset after the transaction; null when unknown.
​
string | null
required
Recipient’s balance of the asset after the transaction; null when unknown.
​
string
required
On-chain transaction hash.
​
integer | null
required
Position of this transfer within the transaction; null for a native transfer on an EVM chain.
​
integer
required
Execution time, in milliseconds.
No REST endpoint returns transfers, so the stream has no snapshot to merge with.

​
Errors