Skip to main content
The Wallet Activity stream provides real-time updates on wallet transactions, token transfers, and interactions with smart contracts . This documentation follows our standard Streaming API structure.

Credit Cost

TBD

Supported Chains

  • BASE_MAINNET
  • BSC_MAINNET
  • ETH_MAINNET
  • HYPERCORE_MAINNET
  • HYPEREVM_MAINNET
  • MEGAETH_MAINNET
  • MONAD_MAINNET
  • POLYGON_MAINNET
This stream is currently in Beta. It is stable for testing and evaluation but may undergo changes in schema or behavior as we continue to improve it. No API credits are currently charged.We welcome your feedback so please reach out to us directly to report issues or request features.

​
Supported Actions

All transactions are returned as raw data, but the following transaction types are decoded:

​
EVM Chains & Solana

​
Hypercore

​
Hypercore Fill Transaction

​
Hypercore Misc Events

​
Parameters

​
wallet_addresses
array<string>
required
Addresses to track
​
chain_name
enum
required
Blockchain network to filter eventsType: ChainName

​
Subscription

You can subscribe to the walletTxs endpoint to receive events. 
subscription {
  walletTxs(
    wallet_addresses: ["0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00"]
    chain_name: HYPERCORE_MAINNET
  ) {
    decoded_details {
      ... on ErrorDetails {
        message
      }
      ... on HypercoreDelegationEvent {
        type
        hash
        time
        is_undelegate
        amount
        validator
      }
      ... on HypercoreDepositEvent {
        type
        hash
        time
        amount
      }
      ... on HypercoreFillTransaction {
        type
        liquidation {
          market_price
          method
          liquidated_user
        }
        twap_id
        builder_fee
        side
        cloid
        closed_pnl
        fee
        fee_token
        oid
        dir
        start_position
        tid
        size
        price
        builder
        time
        crossed
        hash
        coin
      }
      ... on HypercoreFundingEvent {
        type
        hash
        time
        szi
        funding_amount
        coin
        funding_rate
      }
      ... on HypercoreLedgerEvent {
        type
        delta {
          ... on LedgerSubAccountTransfer {
            destination
            usdc
            user
          }
          ... on LedgerWithdraw {
            fee
            usdc
            nonce
          }
          ... on LedgerLiquidation {
            liquidated_ntl_pos
            account_value
            liquidated_positions {
              szi
              coin
            }
            leverage_type
          }
          ... on LedgerSpotTransfer {
            amount
            usdc_value
            native_token_fee
            fee
            destination
            fee_token
            nonce
            user
            token
          }
          ... on LedgerVaultLeaderCommission {
            usdc
            vault
          }
          ... on LedgerSend {
            amount
            usdc_value
            destination_dex
            native_token_fee
            fee
            destination
            fee_token
            nonce
            user
            source_dex
            token
          }
          ... on LedgerVaultDeposit {
            usdc
            user
            vault
          }
          ... on LedgerInternalTransfer {
            fee
            destination
            usdc
            user
          }
          ... on LedgerAccountClassTransfer {
            amount
            token
          }
          ... on LedgerAccountActivationGas {
            amount
            token
          }
          ... on LedgerVaultCreate {
            fee
            usdc
            vault
          }
          ... on LedgerBorrowLend {
            amount
            interest_amount
            operation
            token
          }
          ... on LedgerRewardsClaim {
            amount
          }
          ... on LedgerDeposit {
            usdc
          }
          ... on LedgerPerpDexClassTransfer {
            amount
            dex
            to_perp
            token
          }
          ... on LedgerCStakingTransfer {
            amount
            is_deposit
            token
          }
          ... on LedgerSpotGenesis {
            amount
            token
          }
          ... on LedgerDeployGasAuction {
            amount
            token
          }
          ... on LedgerVaultDistribution {
            usdc
            vault
          }
          ... on LedgerVaultWithdraw {
            requested_usd
            commission
            basis
            closing_cost
            user
            vault
          }
        }
        hash
        ledger_type
        time
      }
      ... on HypercoreWithdrawalEvent {
        type
        hash
        time
        amount
      }
    }
    gas_used
    block_hash
    to_address
    tx_hash
    block_height
    decoded_type
    miner_address
    tx_offset
    block_signed_at
    from_address
    logs {
      data
      emitter_address
      log_offset
      topics
    }
    value
    chain_name
    successful
  }
}

​
Response Format

Here’s an example of the response data structure: 
{
  "data": {
    "walletTxs": [
      {
        "decoded_details": {
          "type": "FILL",
          "typeString": "FILL",
          "liquidation": null,
          "twap_id": null,
          "builder_fee": null,
          "side": "BUY",
          "cloid": "0x00000000000000000000019d8d47e098",
          "closed_pnl": "0.0",
          "fee": "0.152339",
          "fee_token": "USDC",
          "oid": "381460857711",
          "dir": "Open Long",
          "start_position": "254.82",
          "tid": "851999089020363",
          "size": "17.66",
          "price": "84.571",
          "builder": null,
          "time": "2026-04-14T18:37:25.662Z",
          "crossed": true,
          "hash": "0x32813029e2aee9d633fa043925538b02029b000f7da208a8d649db7ca1a2c3c0",
          "coin": "SOL"
        },
        "gas_used": 0,
        "block_hash": "hypercore_block",
        "to_address": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00",
        "tx_hash": "0x32813029e2aee9d633fa043925538b02029b000f7da208a8d649db7ca1a2c3c0",
        "block_height": 0,
        "decoded_type": "FILL",
        "miner_address": "hypercore_miner",
        "tx_offset": 0,
        "block_signed_at": "2026-04-14T18:37:25.662Z",
        "from_address": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00",
        "logs": [],
        "value": 1493,
        "chain_name": "hypercore-mainnet",
        "successful": true
      },
      {
        "decoded_details": {
          "type": "FILL",
          "typeString": "FILL",
          "liquidation": null,
          "twap_id": null,
          "builder_fee": null,
          "side": "BUY",
          "cloid": "0x00000000000000020000019d8d480dd9",
          "closed_pnl": "0.0",
          "fee": "0.083655",
          "fee_token": "USDC",
          "oid": "381461134036",
          "dir": "Open Long",
          "start_position": "272.48",
          "tid": "299654811699485",
          "size": "9.7",
          "price": "84.552",
          "builder": null,
          "time": "2026-04-14T18:37:25.662Z",
          "crossed": true,
          "hash": "0x32813029e2aee9d633fa043925538b02029b000f7da208a8d649db7ca1a2c3c0",
          "coin": "SOL"
        },
        "gas_used": 0,
        "block_hash": "hypercore_block",
        "to_address": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00",
        "tx_hash": "0x32813029e2aee9d633fa043925538b02029b000f7da208a8d649db7ca1a2c3c0",
        "block_height": 0,
        "decoded_type": "FILL",
        "miner_address": "hypercore_miner",
        "tx_offset": 0,
        "block_signed_at": "2026-04-14T18:37:25.662Z",
        "from_address": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00",
        "logs": [],
        "value": 820,
        "chain_name": "hypercore-mainnet",
        "successful": true
      }
    ]
  }
}

​
Field Descriptions

​
decoded_details
interface
The decoded event data (varies by event type)Type: DecodedDetails
​
gas_used
string
The amount of gas used by the transaction
​
block_hash
string
The hash of the block containing the transaction
​
to_address
string
The recipient’s address
​
tx_hash
string
The transaction hash
​
block_height
int
The block number where the transaction was included
​
decoded_type
string
The type of decoded event (e.g., SWAP)
​
miner_address
string
The address of the block miner
​
tx_offset
int
The position of the transaction in the block
​
block_signed_at
string
Timestamp when the block containing this transaction was signed (ISO-8601)
​
from_address
string
The sender’s address
​
logs
object[]
Array of event logs emitted during the transactionType: TransactionLog
​
value
string
The transaction value in native currency
​
chain_name
string
The blockchain network where the transaction occurred
​
successful
boolean
Whether the transaction was successful

​
Decoded Events

Note from the Subscription query above, this stream decodes events which you can fetch with fragment spreads. See the full schema of available decoded events.