Subscribing to Real-Time token new listing (SUBSCRIBE_WALLET_TXS)

The SUBSCRIBE_WALLET_TXS event allows you to receive real-time updates for transactions involving a specific wallet address. This subscription is useful for tracking all token transactions related to a provided address.

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

Header

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"
    }
}

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 }`

Key Notes:

Only transactions with the specified owner address will be filtered and 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