Subscribing to Real-Time token new listing (SUBSCRIBE_WALLET_TXS)

The SUBSCRIBE_WALLET_TXS event allows you to receive real-time updates for transactions filtered by wallet address, wallet tags, or both. The instructions for each type of objects are described below.

WebSocket URL:

wss://public-api.birdeye.so/socket/solana?x-api-key=YOUR-API-KEY

Key	Value
`Origin`	ws://public-api.birdeye.so
`Sec-WebSocket-Origin`	ws://public-api.birdeye.so
`Sec-WebSocket-Protocol`	echo-protocol

Message

Subscription

{
    "type": "SUBSCRIBE_WALLET_TXS",
    "data": {
        "address": "0xae2Fc483527B8EF99EB5D9B44875F005ba1FaE13",
        "tags": ["smart_trader", "kol"]
    }
}

The subscription must include at least one of address or tags. Use address to receive transactions for a specific wallet. If only tags is provided, the stream returns transactions from all wallets matching those tags. When both are provided, both filters are applied. The optional tags filter accepts a non-empty array containing only smart_trader and kol. Tag values are case-sensitive. If tags is provided with an unsupported value, an empty array, or a non-array value, the subscription is rejected with:

SUBSCRIBE_WALLET_TXS: data.tags must be a non-empty array. Only supported wallet tags: smart_trader, kol (case-sensitive).

For EVM addresses (Ethereum, BSC, etc.), the address can be provided in any format (checksum, lowercase, uppercase). For Solana, a valid address is required (e.g., 9SeRj4LjgENeKQujfxRNkGbXYPM3X2vr9C37Jg9AARfg). Unsubscription

{
  "type": "UNSUBSCRIBE_WALLET_TXS"
}

Output Example

{
    "type": "WALLET_TXS_DATA",
    "data": {
        "type": "mint_add_liquidity",
        "blockUnixTime": 1733821667,
        "blockHumanTime": "2024-12-10T09:07:47",
        "owner": "0xae2Fc483527B8EF99EB5D9B44875F005ba1FaE13",
        "source": "0x0A0b2c28470bF68A6144DF04b08360559fb4aAf1",
        "txHash": "0xd80eaabb9c185313c8258ac54eea8bd75eadfb904dec85f887b7f47c58bdb59e",
        "volumeUSD": 2635.811230294149,
        "network": "ethereum",
        "base": {
            "symbol": "WETH",
            "decimals": 18,
            "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
            "uiAmount": 0.09992862476596062
        },
        "quote": {
            "symbol": "TRVL",
            "decimals": 18,
            "address": "0xd47bDF574B4F76210ed503e0EFe81B58Aa061F3d",
            "uiAmount": 39214.96224535667
        }
    }
}

Response Parameters:

Key	Data Type	Details	Example
`type`	string	Type of transaction (e.g., mint_add_liquidity, swap, etc.)	“mint_add_liquidity”
`blockUnixTime`	integer	Unix timestamp for when the transaction was processed	1733821667
`blockHumanTime`	string	Human-readable timestamp for when the transaction was processed	”2024-12-10T09:07:47”
`owner`	string	The wallet address associated with the transaction	”0xae2Fc483527B8EF99EB5D9B44875F005ba1FaE13”
`source`	string	The source address initiating the transaction	”0x0A0b2c28470bF68A6144DF04b08360559fb4aAf1”
`txHash`	string	The transaction hash	”0xd80eaabb9c185313c8258ac54eea8bd75eadfb904dec85f887b7f47c58bdb59e”
`volumeUSD`	number	The total transaction volume in USD	2635.811230294149
`network`	string	The network where the transaction occurred (e.g., ethereum, bsc)	“ethereum”
`base`	object	The base token involved in the transaction, with symbol, address, and amount	`{ "symbol": "WETH", "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "uiAmount": 0.09992862476596062 }`
`quote`	object	The quote token involved in the transaction, with symbol, address, and amount	`{ "symbol": "TRVL", "address": "0xd47bDF574B4F76210ed503e0EFe81B58Aa061F3d", "uiAmount": 39214.96224535667 }`

Subscription Parameters:

Key	Data Type	Details
`address`	string	Optional wallet address filter. Required when `tags` is not provided.
`tags`	string[]	Optional non-empty, case-sensitive wallet tag filter. Supported values: `smart_trader`, `kol`. Required when `address` is not provided.

Key Notes:

Only transactions matching the provided address and/or tags filters will be returned in the response.
Supported blockchains: EVM compatible chains, Solana, etc.
For EVM addresses (Ethereum, BSC, etc.), the address can be in any case (lowercase, uppercase, checksum format).
For Solana, the address must be provided in the correct format.

Sample code https://github.com/TheNang2710/bds-public/blob/main/ws-wallet.js

WebSockets

Wallet Transactions

Subscribing to Real-Time token new listing (SUBSCRIBE_WALLET_TXS)

WebSocket URL:

Header

Message

Output Example

​Subscribing to Real-Time token new listing (SUBSCRIBE_WALLET_TXS)

​WebSocket URL:

​Header

​Message

​Output Example

Subscribing to Real-Time token new listing (SUBSCRIBE_WALLET_TXS)

WebSocket URL:

Header

Message

Output Example