Documentation

SUBSCRIBE_TRANSFER

Overview

SUBSCRIBE_TRANSFER is a WebSocket subscription message used to receive real-time token transfer updates on Solana based on flexible filtering criteria such as wallet addresses, token addresses, transfer direction, and amount/value thresholds.

Subscription Message

{
  "type": "SUBSCRIBE_TRANSFER",
  "data": {
    "filters": [
      {
        "wallet_addresses": ["string"],
        "flow": "string (optional)",
        "token_addresses": ["string"],
        "ui_amount_min": "number (optional)",
        "ui_amount_max": "number (optional)",
        "value_min": "number (optional)",
        "value_max": "number (optional)"
      }
    ]
  }
}

Example Subscription Message

{
  "type": "SUBSCRIBE_TRANSFER",
  "data": {
    "filters": [
      {
        "wallet_addresses": [
          "5Q544fKrFoe6tsEbLhJ2fJfSLavYWhfXQ5QfVf8h2y2x"
        ],
        "flow": "in",
        "token_addresses": [
          "So11111111111111111111111111111111111111112"
        ],
        "ui_amount_min": 1,
        "ui_amount_max": 1000,
        "value_min": 10,
        "value_max": 100000
      }
    ]
  }
}

Parameters

filters

  • Type: array
  • Required
  • Description: A list of filter objects. Each filter defines a set of criteria for transfers to match. Filters are evaluated with OR logic — a transfer matching any single filter will be returned.

Constraints:

  • Maximum 10 filters per subscription
  • Sending a new SUBSCRIBE_TRANSFER message will overwrite the previous subscription and replace all existing filters

filters[].wallet_addresses

  • Type: array of strings
  • Required
  • Description: List of wallet addresses to monitor. A transfer is matched if either from_address or to_address is in this list (combined with flow to narrow direction).

Constraints:

  • Maximum 20 addresses per filter

filters[].flow

  • Type: string
  • Optional
  • Description: Filter transfers by direction relative to the wallet addresses.

Supported values:

  • in — only include transfers into the wallet (wallet is to_address)
  • out — only include transfers out of the wallet (wallet is from_address)

If omitted, both inbound and outbound transfers are returned.

filters[].token_addresses

  • Type: array of strings
  • Optional
  • Description: List of token mint addresses to filter. Only transfers involving one of the specified tokens will be returned.

Constraints:

  • Maximum 20 addresses per filter

filters[].ui_amount_min

  • Type: number
  • Optional
  • Description: Minimum token transfer amount in human-readable units (i.e., after applying token decimals). Transfers with ui_amount below this value are excluded.

filters[].ui_amount_max

  • Type: number
  • Optional
  • Description: Maximum token transfer amount in human-readable units. Transfers with ui_amount above this value are excluded.

filters[].value_min

  • Type: number
  • Optional
  • Description: Minimum USD value of the transfer. Transfers with value below this threshold are excluded.

filters[].value_max

  • Type: number
  • Optional
  • Description: Maximum USD value of the transfer. Transfers with value above this threshold are excluded.

WebSocket Event

Event Type

TRANSFER_DATA

Event Payload Example

{
  "type": "TRANSFER_DATA",
  "data": {
    "block_number": 419596325,
    "unix_time": 1778725622,
    "token_address": "So11111111111111111111111111111111111111112",
    "from_address": "JA4g4DL31DTbJw6iHGTwCKjG794dbh638BAdGUuZ5ZKi",
    "to_address": "44FqodakqgKqQJU6ZAjBMwiBuLwNyMVtRTmzgbNdpfPN",
    "from_token_account": "FEo3AwWAVAhAKcwVKwFjeu8byPebBXyu1XnBR7deyYGs",
    "to_token_account": "2k96MHzsmLEc8ewX4P1D4bkEfVuAVVFaNyXxBuaivsoZ",
    "amount": 9365893168,
    "ui_amount": 9.365893168,
    "price": 91.1494938542852,
    "value": 853.6964217565077,
    "token_decimals": 9,
    "tx_hash": "ZTHRts1kgiXqHykpy43FFrS9BV41jQt6fjvyhMKxsVWNuie4geReGX3LdaogwnBrNPWWthFmD6H9oC25Zi8EhBH",
    "action": "transfer",
    "ins_index": 14,
    "inner_index": 1,
    "network": "solana"
  }
}

Event Payload Fields

block_number

  • Type: number
  • Description: The Solana slot number in which this transfer was confirmed.

unix_time

  • Type: number
  • Description: Unix timestamp (seconds) of the block containing this transfer.

token_address

  • Type: string
  • Description: Mint address of the token being transferred.

from_address

  • Type: string
  • Description: Wallet address of the sender.

to_address

  • Type: string
  • Description: Wallet address of the recipient.

from_token_account

  • Type: string
  • Description: Associated token account (ATA) of the sender for this token.

to_token_account

  • Type: string
  • Description: Associated token account (ATA) of the recipient for this token.

amount

  • Type: number
  • Description: Raw transfer amount in the token's smallest unit (i.e., before applying decimals).

ui_amount

  • Type: number
  • Description: Human-readable transfer amount after applying token_decimals.

price

  • Type: number
  • Description: Token price in USD at the time of the transfer.

value

  • Type: number
  • Description: USD value of the transfer (ui_amount × price).

token_decimals

  • Type: number
  • Description: Number of decimal places for the token.

tx_hash

  • Type: string
  • Description: Transaction signature on Solana.

action

  • Type: string
  • Description: Type of transfer action. Possible values: transfer (value 1) or burn (value 2).

ins_index

  • Type: number
  • Description: Index of the instruction within the transaction that produced this transfer.

inner_index

  • Type: number
  • Description: Index of the inner instruction (if applicable) within ins_index.

network

  • Type: string
  • Description: Blockchain network. Currently always "solana".

Notes

  • All timestamps are in Unix seconds
  • ui_amount equals amount / 10^token_decimals
  • value equals ui_amount × price
  • action is encoded as an integer internally: 1 = transfer, 2 = burn
  • Filters use OR logic — a transfer matching any one filter will be emitted
  • Maximum 10 filters per subscription; maximum 20 addresses per filter
  • Only Solana is supported at this time
  • Sending a new SUBSCRIBE_TRANSFER message overwrites the previous subscription entirely

Updated 1 day ago