> ## Documentation Index
> Fetch the complete documentation index at: https://data.birdeye.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallet Transactions

# 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**

```json theme={null}
{
    "type": "SUBSCRIBE_WALLET_TXS",
    "data": {
        "address": "0xae2Fc483527B8EF99EB5D9B44875F005ba1FaE13",
        "tags": ["smart_trader", "kol"]
    }
}
```

The optional `tags` filter accepts a non-empty array containing only `smart_trader` and `kol`. Tag values are case-sensitive. When both `address` and `tags` are provided, both filters are applied. Address-only subscriptions remain supported.

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**

```json theme={null}
{
  "type": "UNSUBSCRIBE_WALLET_TXS"
}
```

### Output Example

```json theme={null}
{
    "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. |
| `tags` | string\[] | Optional non-empty, case-sensitive wallet tag filter. Supported values: `smart_trader`, `kol`. |

**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](https://github.com/TheNang2710/bds-public/blob/main/ws-wallet.js)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.