Wallet Transfers

This endpoint is only available to Growth and Enterprise plans.

Endpoint Details

Use this stream to track token transfers by sender, receiver, contract, or other indexed event fields.

Chain family	Endpoint	Event
EVM	`wss://stream-evm-prod.mobula.io/`	`transfer`
Solana	`wss://stream-sol-prod.mobula.io/`	`transfer`
Stellar	`wss://stream-stellar-prod.mobula.io/`	`transfer`

Each endpoint serves a single chain family. Do not mix chainIds across families, for example Solana or Stellar chainIds on the EVM endpoint.

The EVM addresses used in filters must be lowercase.

Stellar address casing in filters:

Classic AMM pools — lowercase, in the lp:<hex> form. Example: lp:59fa1dc57433dcfbd2db7319d26cb3da1f28f2d8095a3ec36ad4ef9cadb0013e (XLM/AQUA)
All other addresses — uppercase: G... accounts, C... contracts, and CODE:ISSUER assets.

Subscription Payload

{
  "type": "stream",
  "authorization": "YOUR_API_KEY",
  "payload": {
    "name": "WalletTransfers",
    "chainIds": ["solana:solana"],
    "events": ["transfer"],
    "filters": {
      "or": [
        { "eq": ["transactionFrom", "2zqLokC98qfedXyXZHeL4sEdFcmmTFizvb1UQeRweWxp"] },
        { "eq": ["transactionTo", "suqh5sHtr8HyJ7q8scBimULPkPpA557prMG47xCHQfK"] }
      ]
    },
    "subscriptionId": "wallet-transfers",
    "subscriptionTracking": true
  }
}

Response Frame

Every message uses the standard Multi-Events frame:

{
  "data": {
    "type": "transfer",
    "transactionHash": "5m6Q...",
    "transactionFrom": "2zqLokC98qfedXyXZHeL4sEdFcmmTFizvb1UQeRweWxp",
    "transactionTo": "suqh5sHtr8HyJ7q8scBimULPkPpA557prMG47xCHQfK",
    "address": "So11111111111111111111111111111111111111112",
    "amount": 1.42,
    "rawAmount": "1420000000",
    "date": "2026-06-08T00:18:34.613Z"
  },
  "chainId": "solana:solana",
  "duplicateCount": 1,
  "subscriptionId": "wallet-transfers"
}

See the EVM Data Model and Solana Data Model for chain-specific fields.

Common Filters

Transfers to a Wallet

{
  "eq": ["transactionTo", "ASde6y8pBCU1aityWHRpqT7pEAcEonjCgFUMeh5egRes"]
}

Transfers From or To a Wallet

{
  "or": [
    { "eq": ["transactionFrom", "2zqLokC98qfedXyXZHeL4sEdFcmmTFizvb1UQeRweWxp"] },
    { "eq": ["transactionTo", "suqh5sHtr8HyJ7q8scBimULPkPpA557prMG47xCHQfK"] }
  ]
}

Contract or Token Address

{
  "eq": ["address", "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"]
}

Parameters

chainIds (required): Chain identifiers, for example ["evm:1"], ["solana:solana"], or ["stellar:stellar"].
events (required): Must include transfer.
filters (optional): Filter conditions. See filters.
subscriptionId (optional): Identifier copied into matching responses.
subscriptionTracking (optional, default: false): Include subscription details in response logs.
tag (optional): Usage tag shown in the dashboard breakdown.

Keepalive

{ "event": "ping" }

Unsubscribe

{
  "type": "unsubscribe",
  "authorization": "YOUR_API_KEY",
  "payload": {
    "subscriptionId": "wallet-transfers"
  }
}

Introduction

Market & Token Data

Trades & OHLCV

Pulse Streams

Filter Tokens

Multi-Events & Raw Data

Data Models

Holders & Positions

Perps Streams

Webhooks

Misc

Endpoint Details

Subscription Payload

Response Frame

Common Filters

Transfers to a Wallet

Transfers From or To a Wallet

Contract or Token Address

Parameters

Keepalive

Unsubscribe

​Endpoint Details

​Subscription Payload

​Response Frame

​Common Filters

​Transfers to a Wallet

​Transfers From or To a Wallet

​Contract or Token Address

​Parameters

​Keepalive

​Unsubscribe

Endpoint Details

Subscription Payload

Response Frame

Common Filters

Transfers to a Wallet

Transfers From or To a Wallet

Contract or Token Address

Parameters

Keepalive

Unsubscribe