Wallet Activity Stream - GoldRush API Documentation

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. The wallet_addresses input is limited to a maximum of 1000 addresses per subscription on HyperCore, and a maximum of 100 addresses per subscription on EVM chains and Solana.

Credit Cost

1 per minute

Supported Chains

BASE_MAINNET
BSC_MAINNET
ETH_MAINNET
HYPERCORE_MAINNET
HYPEREVM_MAINNET
MEGAETH_MAINNET
MONAD_MAINNET
POLYGON_MAINNET
ROBINHOOD_MAINNET

Estimate your monthly cost for this API using the Pricing Calculator.

Supported Actions

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

EVM Chains & Solana

ApproveTransaction - Decoded details for a token spending approval
BridgeTransaction - Decoded details for a cross-chain bridge transfer
DepositTransaction - Decoded details for a token deposit or liquidity addition
SwapTransaction - Decoded details for a token swap on a decentralized exchange
TransferTransaction - Decoded details for a token transfer between addresses
WithdrawTransaction - Decoded details for a token withdrawal or liquidity removal

Hypercore

Hypercore Fill Transaction

HypercoreFillTransaction - Decoded details for a Hypercore perpetuals trade fill

Hypercore Misc Events

HypercoreDelegationEvent - Decoded details for a Hypercore staking delegation or undelegation event
HypercoreDepositEvent - Decoded details for a Hypercore cross-chain deposit from an external chain
HypercoreFundingEvent - Decoded details for a Hypercore funding rate payment between long and short holders
HypercoreLedgerEvent - Decoded details for a Hypercore ledger update (withdraw, deposit, transfer, liquidation, etc.)
HypercoreWithdrawalEvent - Decoded details for a finalized Hypercore cross-chain withdrawal

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: ["0x8e80c4b533dd977cf716b5c24fd9223129272804"]
    chain_name: HYPERCORE_MAINNET
  ) {
    decoded_details {
      ... on ErrorDetails {
        message
        typeString
      }
      ... on HypercoreDelegationEvent {
        type
        typeString
        hash
        time
        is_undelegate
        amount
        validator
      }
      ... on HypercoreDepositEvent {
        type
        typeString
        hash
        time
        amount
      }
      ... on HypercoreFillTransaction {
        type
        typeString
        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
        typeString
        hash
        time
        szi
        funding_amount
        coin
        funding_rate
      }
      ... on HypercoreLedgerEvent {
        type
        typeString
        delta {
          ... on LedgerAccountActivationGas {
            amount
            token
          }
          ... on LedgerAccountClassTransfer {
            amount
            token
          }
          ... on LedgerBorrowLend {
            amount
            interest_amount
            operation
            token
          }
          ... on LedgerCStakingTransfer {
            amount
            is_deposit
            token
          }
          ... on LedgerDeployGasAuction {
            amount
            token
          }
          ... on LedgerDeposit {
            usdc
          }
          ... on LedgerInternalTransfer {
            fee
            destination
            usdc
            user
          }
          ... on LedgerLiquidation {
            liquidated_ntl_pos
            account_value
            liquidated_positions {
              szi
              coin
            }
            leverage_type
          }
          ... on LedgerPerpDexClassTransfer {
            amount
            dex
            to_perp
            token
          }
          ... on LedgerRewardsClaim {
            amount
          }
          ... on LedgerSend {
            amount
            usdc_value
            destination_dex
            native_token_fee
            fee
            destination
            fee_token
            nonce
            user
            source_dex
            token
          }
          ... on LedgerSpotGenesis {
            amount
            token
          }
          ... on LedgerSpotTransfer {
            amount
            usdc_value
            native_token_fee
            fee
            destination
            fee_token
            nonce
            user
            token
          }
          ... on LedgerSubAccountTransfer {
            destination
            usdc
            user
          }
          ... on LedgerVaultCreate {
            fee
            usdc
            vault
          }
          ... on LedgerVaultDeposit {
            usdc
            user
            vault
          }
          ... on LedgerVaultDistribution {
            usdc
            vault
          }
          ... on LedgerVaultLeaderCommission {
            usdc
            vault
          }
          ... on LedgerVaultWithdraw {
            requested_usd
            commission
            basis
            closing_cost
            user
            vault
          }
          ... on LedgerWithdraw {
            fee
            usdc
            nonce
          }
        }
        hash
        ledger_type
        time
      }
      ... on HypercoreWithdrawalEvent {
        type
        typeString
        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
  }
}

subscription {
  walletTxs(
    wallet_addresses: [
      "0x198ef79f1f515f02dfe9e3115ed9fc07183f02fc"
      "0x4200000000000000000000000000000000000006"
    ]
    chain_name: BASE_MAINNET
  ) {
    decoded_details {
      ... on ApproveTransaction {
        type
        typeString
        amount
        quote_usd
        quote_rate_usd
        spender
        contract_metadata {
          contract_name
          contract_address
          contract_decimals
          contract_ticker_symbol
        }
      }
      ... on BridgeTransaction {
        type
        typeString
        amount
        quote_usd
        quote_rate_usd
        contract_metadata {
          contract_name
          contract_address
          contract_decimals
          contract_ticker_symbol
        }
        from
        to
      }
      ... on DepositTransaction {
        type
        typeString
        amount
        quote_usd
        quote_rate_usd
        contract_metadata {
          contract_name
          contract_address
          contract_decimals
          contract_ticker_symbol
        }
        from
        to
      }
      ... on ErrorDetails {
        message
        typeString
      }
      ... on SwapTransaction {
        type
        typeString
        amount_out
        amount_in
        token_out {
          contract_name
          contract_address
          contract_decimals
          contract_ticker_symbol
        }
        token_in {
          contract_name
          contract_address
          contract_decimals
          contract_ticker_symbol
        }
      }
      ... on TransferTransaction {
        type
        typeString
        amount
        quote_usd
        quote_rate_usd
        contract_metadata {
          contract_name
          contract_address
          contract_decimals
          contract_ticker_symbol
        }
        from
        to
      }
      ... on WithdrawTransaction {
        type
        typeString
        amount
        quote_usd
        quote_rate_usd
        contract_metadata {
          contract_name
          contract_address
          contract_decimals
          contract_ticker_symbol
        }
        from
        to
      }
    }
    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": "0x8e80c4b533dd977cf716b5c24fd9223129272804",
        "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": "0x8e80c4b533dd977cf716b5c24fd9223129272804",
        "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": "0x8e80c4b533dd977cf716b5c24fd9223129272804",
        "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": "0x8e80c4b533dd977cf716b5c24fd9223129272804",
        "logs": [],
        "value": 820,
        "chain_name": "hypercore-mainnet",
        "successful": true
      }
    ]
  }
}

{
  "data": {
    "walletTxs": [
      {
        "tx_hash": "0x23a4f9710c23678a8c6ae25d7e3aa75a82866231e9bd541114046c5a710a8355",
        "from_address": "0xd2216ed62a5c84f285a051839e808902fe8fc90b",
        "to_address": "0x198ef79f1f515f02dfe9e3115ed9fc07183f02fc",
        "value": 0,
        "chain_name": "base-mainnet",
        "block_signed_at": "2025-05-29T19:27:25Z",
        "block_height": 30878749,
        "block_hash": "0x2435aec7c20678ee82ae251ab1066e15ed3dac7ff0ea086c44ee8476a721abde",
        "miner_address": "0x4200000000000000000000000000000000000011",
        "gas_used": 195861,
        "tx_offset": 118,
        "successful": true,
        "decoded_type": "SWAP",
        "decoded_details": {
          "token_in": {
            "contract_address": "0x4200000000000000000000000000000000000006",
            "contract_decimals": 18,
            "contract_ticker_symbol": "WETH"
          },
          "token_out": {
            "contract_address": "0x14b2f229097df3c92b43ea871860e3fae08d7f06",
            "contract_decimals": 18,
            "contract_ticker_symbol": "EXAMPLE"
          },
          "amount_in": "258844786659364206700114",
          "amount_out": "66094025142553271"
        },
        "logs": [
          {
            "emitter": "0x4200000000000000000000000000000000000006",
            "topics": [
              "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
              "0x000000000000000000000000286f3add5dd41ba6e208f9f9a68533107fd0d0fa",
              "0x000000000000000000000000198ef79f1f515f02dfe9e3115ed9fc07183f02fc"
            ]
          },
          {
            "emitter": "0x14b2f229097df3c92b43ea871860e3fae08d7f06",
            "topics": [
              "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
              "0x000000000000000000000000d2216ed62a5c84f285a051839e808902fe8fc90b",
              "0x000000000000000000000000286f3add5dd41ba6e208f9f9a68533107fd0d0fa"
            ]
          },
          {
            "emitter": "0x286f3add5dd41ba6e208f9f9a68533107fd0d0fa",
            "topics": [
              "0xc42079f94a6350d7e6235f29174924f928cc2ac818eb64fed8004e115fbcca67",
              "0x000000000000000000000000198ef79f1f515f02dfe9e3115ed9fc07183f02fc",
              "0x000000000000000000000000198ef79f1f515f02dfe9e3115ed9fc07183f02fc"
            ]
          },
          {
            "emitter": "0x4200000000000000000000000000000000000006",
            "topics": [
              "0x7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b65",
              "0x000000000000000000000000198ef79f1f515f02dfe9e3115ed9fc07183f02fc"
            ]
          }
        ]
      }
    ]
  }
}

Field Descriptions

decoded_details

interface

The decoded event data (varies by event type)Type: DecodedDetails

Show ApproveTransaction

type

enum

Enum value identifying the transaction typeType: TransactionType

amount

string

Amount of tokens approved for spending

quote_usd

float

Total USD value of the approved amount

quote_rate_usd

float

USD price per token at time of approval

spender

string

Address of the approved spender

contract_metadata

object

Metadata for the approved token contractType: TokenContractMetadata

Show properties

contract_name

string

Name of the token contract

contract_address

string

Address of the token contract

contract_decimals

int

Number of decimal places for the token

contract_ticker_symbol

string

Ticker symbol of the token

Show BridgeTransaction

type

enum

Enum value identifying the transaction typeType: TransactionType

amount

string

Amount of tokens bridged

quote_usd

float

Total USD value of the bridged amount

quote_rate_usd

float

USD price per token at time of bridge

contract_metadata

object

Metadata for the bridged token contractType: TokenContractMetadata

Show properties

contract_name

string

Name of the token contract

contract_address

string

Address of the token contract

contract_decimals

int

Number of decimal places for the token

contract_ticker_symbol

string

Ticker symbol of the token

from

string

Sender wallet address

string

Recipient wallet address

Show DepositTransaction

type

enum

Enum value identifying the transaction typeType: TransactionType

amount

string

Amount of tokens deposited

quote_usd

float

Total USD value of the deposited amount

quote_rate_usd

float

USD price per token at time of deposit

contract_metadata

object

Metadata for the deposited token contractType: TokenContractMetadata

Show properties

contract_name

string

Name of the token contract

contract_address

string

Address of the token contract

contract_decimals

int

Number of decimal places for the token

contract_ticker_symbol

string

Ticker symbol of the token

from

string

Sender wallet address

string

Recipient or pool address

Show ErrorDetails

message

string

Error or status message describing the issue

Show HypercoreDelegationEvent

type

enum

Enum value identifying the transaction typeType: TransactionType

hash

string

Transaction/event hash from the Hypercore L1

time

string

ISO-8601 timestamp of the delegation event

is_undelegate

boolean

Whether this is an undelegation (true) or delegation (false)

amount

string

Delegation amount

validator

string

Validator address that received or lost the delegation

Show HypercoreDepositEvent

type

enum

Enum value identifying the transaction typeType: TransactionType

hash

string

Transaction/event hash from the Hypercore L1

time

string

ISO-8601 timestamp of the deposit event

amount

string

Deposit amount in USDC

Show HypercoreFillTransaction

type

enum

Enum value identifying the transaction typeType: TransactionType

liquidation

object

Liquidation details, present only when this fill resulted from a liquidationType: HypercoreLiquidation

Show properties

market_price

string

Mark price at the time of liquidation

method

string

Liquidation method: Market or Backstop

liquidated_user

string

Address of the user whose position was liquidated

twap_id

string

TWAP order ID when this fill was part of a TWAP execution

builder_fee

string

Fee paid to the builder, if a builder was involved

side

string

Fill side: BUY, SELL, or UNSPECIFIED

cloid

string

Client-supplied order ID for programmatic order tracking

closed_pnl

string

Realized PnL from the closed portion of the position

fee

string

Fee charged for this fill

fee_token

string

Token in which the fee was denominated

oid

string

Order ID that originated this fill

dir

string

Direction indicator for the position change

start_position

string

Position size before this fill executed

tid

string

Unique trade ID assigned by the exchange

size

string

Filled quantity

price

string

Execution price per unit

builder

string

Address of the builder that constructed this order

time

string

ISO-8601 timestamp of the fill

crossed

boolean

Whether the order crossed the spread (true = taker, false = maker)

hash

string

On-chain transaction hash

coin

string

Market/coin symbol (e.g. ETH, BTC)

Show HypercoreFundingEvent

type

enum

Enum value identifying the transaction typeType: TransactionType

hash

string

Transaction/event hash from the Hypercore L1

time

string

ISO-8601 timestamp of the funding event

szi

string

Position size indicator at the time of funding

funding_amount

string

Funding payment amount in USDC

coin

string

Market/coin symbol (e.g. ETH, BTC)

funding_rate

string

Funding rate applied for this settlement

Show HypercoreLedgerEvent

type

string

Ledger subtype discriminator (e.g. withdraw, deposit, spot_transfer, send)

delta

union

Subtype-specific ledger delta payloadType: LedgerDelta

Show LedgerAccountActivationGas

amount

string

Gas fee amount

token

string

Token used for gas payment

Show LedgerAccountClassTransfer

amount

string

Transfer amount

token

string

Token identifier

Show LedgerBorrowLend

amount

string

Borrow or lend amount

interest_amount

string

Accrued interest amount

operation

string

Operation type: borrow or lend

token

string

Token identifier

Show LedgerCStakingTransfer

amount

string

Transfer amount

is_deposit

boolean

Whether this is a deposit (true) or withdrawal (false)

token

string

Token identifier

Show LedgerDeployGasAuction

amount

string

Auction amount

token

string

Token identifier

Show LedgerDeposit

usdc

string

Deposit amount in USDC

Show LedgerInternalTransfer

fee

string

Transfer fee

destination

string

Destination user address

usdc

string

Transfer amount in USDC

user

string

Source user address

Show LedgerLiquidation

liquidated_ntl_pos

string

Liquidated notional position value

account_value

string

Account value at time of liquidation

liquidated_positions

object[]

List of positions that were liquidatedType: LedgerLiquidatedPosition

leverage_type

string

Leverage type (e.g. cross, isolated)

Show LedgerPerpDexClassTransfer

amount

string

Transfer amount

dex

string

DEX identifier

to_perp

boolean

Whether transferring to perp (true) or to spot (false)

token

string

Token identifier

Show LedgerRewardsClaim

amount

string

Claimed rewards amount

Show LedgerSend

amount

string

Send amount

usdc_value

string

USDC equivalent value

destination_dex

string

Destination DEX identifier

native_token_fee

string

Fee in native token

fee

string

Send fee

destination

string

Recipient address

fee_token

string

Token used for fee payment

nonce

string

Send nonce

user

string

Sender address

source_dex

string

Source DEX identifier

token

string

Token identifier

Show LedgerSpotGenesis

amount

string

Genesis distribution amount

token

string

Token identifier

Show LedgerSpotTransfer

amount

string

Transfer amount

usdc_value

string

USDC equivalent value

native_token_fee

string

Fee in native token

fee

string

Transfer fee

destination

string

Destination user address

fee_token

string

Token used for fee payment

nonce

string

Transfer nonce

user

string

Source user address

token

string

Token identifier

Show LedgerSubAccountTransfer

destination

string

Destination sub-account address

usdc

string

Transfer amount in USDC

user

string

Source user address

Show LedgerVaultCreate

fee

string

Vault creation fee

usdc

string

Initial deposit amount in USDC

vault

string

Vault address

Show LedgerVaultDeposit

usdc

string

Deposit amount in USDC

user

string

Depositor address

vault

string

Vault address

Show LedgerVaultDistribution

usdc

string

Distribution amount in USDC

vault

string

Vault address

Show LedgerVaultLeaderCommission

usdc

string

Commission amount in USDC

vault

string

Vault address

Show LedgerVaultWithdraw

requested_usd

string

Requested withdrawal amount in USD

commission

string

Commission charged

basis

string

Cost basis of the withdrawn share

closing_cost

string

Cost to close positions for withdrawal

user

string

Withdrawer address

vault

string

Vault address

Show LedgerWithdraw

fee

string

Withdrawal fee

usdc

string

Withdrawal amount in USDC

nonce

string

Withdrawal nonce

hash

string

Transaction/event hash from the Hypercore L1

ledger_type

string

Ledger subtype discriminator (e.g. withdraw, deposit, spot_transfer, send)

time

string

ISO-8601 timestamp of the ledger event

Show HypercoreWithdrawalEvent

type

enum

Enum value identifying the transaction typeType: TransactionType

hash

string

Transaction/event hash from the Hypercore L1

time

string

ISO-8601 timestamp of the withdrawal event

amount

string

Withdrawal amount in USDC

Show SwapTransaction

type

enum

Enum value identifying the transaction typeType: TransactionType

amount_out

string

Amount of tokens received

amount_in

string

Amount of tokens sold

token_out

object

Metadata for the token boughtType: TokenContractMetadata

Show properties

contract_name

string

Name of the token contract

contract_address

string

Address of the token contract

contract_decimals

int

Number of decimal places for the token

contract_ticker_symbol

string

Ticker symbol of the token

token_in

object

Metadata for the token soldType: TokenContractMetadata

Show properties

contract_name

string

Name of the token contract

contract_address

string

Address of the token contract

contract_decimals

int

Number of decimal places for the token

contract_ticker_symbol

string

Ticker symbol of the token

Show TransferTransaction

type

enum

Enum value identifying the transaction typeType: TransactionType

amount

string

Amount of tokens transferred

quote_usd

float

Total USD value of the transferred amount

quote_rate_usd

float

USD price per token at time of transfer

contract_metadata

object

Metadata for the transferred token contractType: TokenContractMetadata

Show properties

contract_name

string

Name of the token contract

contract_address

string

Address of the token contract

contract_decimals

int

Number of decimal places for the token

contract_ticker_symbol

string

Ticker symbol of the token

from

string

Sender wallet address

string

Recipient wallet address

Show WithdrawTransaction

type

enum

Enum value identifying the transaction typeType: TransactionType

amount

string

Amount of tokens withdrawn

quote_usd

float

Total USD value of the withdrawn amount

quote_rate_usd

float

USD price per token at time of withdrawal

contract_metadata

object

Metadata for the withdrawn token contractType: TokenContractMetadata

Show properties

contract_name

string

Name of the token contract

contract_address

string

Address of the token contract

contract_decimals

int

Number of decimal places for the token

contract_ticker_symbol

string

Ticker symbol of the token

from

string

Source pool or contract address

string

Recipient wallet address

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

Show properties

data

string

ABI-encoded log data

emitter_address

string

Address of the contract that emitted the log

log_offset

int

Position of the log within the transaction

topics

array<string>

Indexed event parameters (topic[0] is the event signature hash)

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.

Credit Cost

Supported Chains

​Supported Actions

​EVM Chains & Solana

​Hypercore

​Hypercore Fill Transaction

​Hypercore Misc Events

​Parameters

​Subscription

​Response Format

​Field Descriptions

​Decoded Events

Supported Actions

EVM Chains & Solana

Hypercore

Hypercore Fill Transaction

Hypercore Misc Events

Parameters

Subscription

Response Format

Field Descriptions

Decoded Events