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

# Wallet Activity Stream

The Wallet Activity stream provides real-time updates on wallet <strong>transactions, token transfers, and interactions with smart contracts </strong>. This documentation follows our standard Streaming API structure. The `wallet_addresses` input is limited to a <strong>maximum of 1000 addresses</strong> per subscription on HyperCore, and a <strong>maximum of 100 addresses</strong> per subscription on EVM chains and Solana.

<CardGroup cols={2}>
  <Card title="Credit Cost"> 1 per minute </Card>

  <Card title="Supported Chains">
    * `BASE_MAINNET`
    * `BSC_MAINNET`
    * `ETH_MAINNET`
    * `HYPERCORE_MAINNET`
    * `HYPEREVM_MAINNET`
    * `MEGAETH_MAINNET`
    * `MONAD_MAINNET`
    * `POLYGON_MAINNET`
    * `ROBINHOOD_MAINNET`
  </Card>
</CardGroup>

<Tip>
  Estimate your monthly cost for this API using the [Pricing Calculator](/pricing-calculator?endpoint=%2Fapi-reference%2Fstreaming-api%2Fsubscriptions%2Fwallet-activity-stream).
</Tip>

## Supported Actions

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

### EVM Chains & Solana

* [`ApproveTransaction`](/api-reference/streaming-api/types/approve-transaction) - Decoded details for a token spending approval
* [`BridgeTransaction`](/api-reference/streaming-api/types/bridge-transaction) - Decoded details for a cross-chain bridge transfer
* [`DepositTransaction`](/api-reference/streaming-api/types/deposit-transaction) - Decoded details for a token deposit or liquidity addition
* [`SwapTransaction`](/api-reference/streaming-api/types/swap-transaction) - Decoded details for a token swap on a decentralized exchange
* [`TransferTransaction`](/api-reference/streaming-api/types/transfer-transaction) - Decoded details for a token transfer between addresses
* [`WithdrawTransaction`](/api-reference/streaming-api/types/withdraw-transaction) - Decoded details for a token withdrawal or liquidity removal

### Hypercore

#### Hypercore Fill Transaction

* [`HypercoreFillTransaction`](/api-reference/streaming-api/types/hypercore-fill-transaction) - Decoded details for a Hypercore perpetuals trade fill

#### Hypercore Misc Events

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

## Parameters

<ParamField body="wallet_addresses" type="array<string>" required>
  Addresses to track
</ParamField>

<ParamField body="chain_name" type="enum" required>
  Blockchain network to filter events

  Type: [`ChainName`](/api-reference/streaming-api/types/chain-name)
</ParamField>

## Subscription

You can subscribe to the `walletTxs` endpoint to receive events.

<CodeGroup>
  ```graphql Hypercore theme={null}
  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
    }
  }
  ```

  ```graphql EVM Chains & Solana theme={null}
  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
    }
  }
  ```
</CodeGroup>

## Response Format

Here's an example of the response data structure:

<CodeGroup>
  ```json Hypercore theme={null}
  {
    "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
        }
      ]
    }
  }
  ```

  ```json EVM Chains & Solana theme={null}
  {
    "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"
              ]
            }
          ]
        }
      ]
    }
  }
  ```
</CodeGroup>

### Field Descriptions

<ResponseField name="decoded_details" type="interface">
  The decoded event data (varies by event type)

  Type: [`DecodedDetails`](/api-reference/streaming-api/types/decoded-details)

  <Expandable title="ApproveTransaction">
    <ResponseField name="type" type="enum">
      Enum value identifying the transaction type

      Type: [`TransactionType`](/api-reference/streaming-api/types/transaction-type)
    </ResponseField>

    <ResponseField name="amount" type="string">
      Amount of tokens approved for spending
    </ResponseField>

    <ResponseField name="quote_usd" type="float">
      Total USD value of the approved amount
    </ResponseField>

    <ResponseField name="quote_rate_usd" type="float">
      USD price per token at time of approval
    </ResponseField>

    <ResponseField name="spender" type="string">
      Address of the approved spender
    </ResponseField>

    <ResponseField name="contract_metadata" type="object">
      Metadata for the approved token contract

      Type: [`TokenContractMetadata`](/api-reference/streaming-api/types/token-contract-metadata)

      <Expandable title="properties">
        <ResponseField name="contract_name" type="string">
          Name of the token contract
        </ResponseField>

        <ResponseField name="contract_address" type="string">
          Address of the token contract
        </ResponseField>

        <ResponseField name="contract_decimals" type="int">
          Number of decimal places for the token
        </ResponseField>

        <ResponseField name="contract_ticker_symbol" type="string">
          Ticker symbol of the token
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>

  <Expandable title="BridgeTransaction">
    <ResponseField name="type" type="enum">
      Enum value identifying the transaction type

      Type: [`TransactionType`](/api-reference/streaming-api/types/transaction-type)
    </ResponseField>

    <ResponseField name="amount" type="string">
      Amount of tokens bridged
    </ResponseField>

    <ResponseField name="quote_usd" type="float">
      Total USD value of the bridged amount
    </ResponseField>

    <ResponseField name="quote_rate_usd" type="float">
      USD price per token at time of bridge
    </ResponseField>

    <ResponseField name="contract_metadata" type="object">
      Metadata for the bridged token contract

      Type: [`TokenContractMetadata`](/api-reference/streaming-api/types/token-contract-metadata)

      <Expandable title="properties">
        <ResponseField name="contract_name" type="string">
          Name of the token contract
        </ResponseField>

        <ResponseField name="contract_address" type="string">
          Address of the token contract
        </ResponseField>

        <ResponseField name="contract_decimals" type="int">
          Number of decimal places for the token
        </ResponseField>

        <ResponseField name="contract_ticker_symbol" type="string">
          Ticker symbol of the token
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="from" type="string">
      Sender wallet address
    </ResponseField>

    <ResponseField name="to" type="string">
      Recipient wallet address
    </ResponseField>
  </Expandable>

  <Expandable title="DepositTransaction">
    <ResponseField name="type" type="enum">
      Enum value identifying the transaction type

      Type: [`TransactionType`](/api-reference/streaming-api/types/transaction-type)
    </ResponseField>

    <ResponseField name="amount" type="string">
      Amount of tokens deposited
    </ResponseField>

    <ResponseField name="quote_usd" type="float">
      Total USD value of the deposited amount
    </ResponseField>

    <ResponseField name="quote_rate_usd" type="float">
      USD price per token at time of deposit
    </ResponseField>

    <ResponseField name="contract_metadata" type="object">
      Metadata for the deposited token contract

      Type: [`TokenContractMetadata`](/api-reference/streaming-api/types/token-contract-metadata)

      <Expandable title="properties">
        <ResponseField name="contract_name" type="string">
          Name of the token contract
        </ResponseField>

        <ResponseField name="contract_address" type="string">
          Address of the token contract
        </ResponseField>

        <ResponseField name="contract_decimals" type="int">
          Number of decimal places for the token
        </ResponseField>

        <ResponseField name="contract_ticker_symbol" type="string">
          Ticker symbol of the token
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="from" type="string">
      Sender wallet address
    </ResponseField>

    <ResponseField name="to" type="string">
      Recipient or pool address
    </ResponseField>
  </Expandable>

  <Expandable title="ErrorDetails">
    <ResponseField name="message" type="string">
      Error or status message describing the issue
    </ResponseField>
  </Expandable>

  <Expandable title="HypercoreDelegationEvent">
    <ResponseField name="type" type="enum">
      Enum value identifying the transaction type

      Type: [`TransactionType`](/api-reference/streaming-api/types/transaction-type)
    </ResponseField>

    <ResponseField name="hash" type="string">
      Transaction/event hash from the Hypercore L1
    </ResponseField>

    <ResponseField name="time" type="string">
      ISO-8601 timestamp of the delegation event
    </ResponseField>

    <ResponseField name="is_undelegate" type="boolean">
      Whether this is an undelegation (true) or delegation (false)
    </ResponseField>

    <ResponseField name="amount" type="string">
      Delegation amount
    </ResponseField>

    <ResponseField name="validator" type="string">
      Validator address that received or lost the delegation
    </ResponseField>
  </Expandable>

  <Expandable title="HypercoreDepositEvent">
    <ResponseField name="type" type="enum">
      Enum value identifying the transaction type

      Type: [`TransactionType`](/api-reference/streaming-api/types/transaction-type)
    </ResponseField>

    <ResponseField name="hash" type="string">
      Transaction/event hash from the Hypercore L1
    </ResponseField>

    <ResponseField name="time" type="string">
      ISO-8601 timestamp of the deposit event
    </ResponseField>

    <ResponseField name="amount" type="string">
      Deposit amount in USDC
    </ResponseField>
  </Expandable>

  <Expandable title="HypercoreFillTransaction">
    <ResponseField name="type" type="enum">
      Enum value identifying the transaction type

      Type: [`TransactionType`](/api-reference/streaming-api/types/transaction-type)
    </ResponseField>

    <ResponseField name="liquidation" type="object">
      Liquidation details, present only when this fill resulted from a liquidation

      Type: [`HypercoreLiquidation`](/api-reference/streaming-api/types/hypercore-liquidation)

      <Expandable title="properties">
        <ResponseField name="market_price" type="string">
          Mark price at the time of liquidation
        </ResponseField>

        <ResponseField name="method" type="string">
          Liquidation method: Market or Backstop
        </ResponseField>

        <ResponseField name="liquidated_user" type="string">
          Address of the user whose position was liquidated
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="twap_id" type="string">
      TWAP order ID when this fill was part of a TWAP execution
    </ResponseField>

    <ResponseField name="builder_fee" type="string">
      Fee paid to the builder, if a builder was involved
    </ResponseField>

    <ResponseField name="side" type="string">
      Fill side: BUY, SELL, or UNSPECIFIED
    </ResponseField>

    <ResponseField name="cloid" type="string">
      Client-supplied order ID for programmatic order tracking
    </ResponseField>

    <ResponseField name="closed_pnl" type="string">
      Realized PnL from the closed portion of the position
    </ResponseField>

    <ResponseField name="fee" type="string">
      Fee charged for this fill
    </ResponseField>

    <ResponseField name="fee_token" type="string">
      Token in which the fee was denominated
    </ResponseField>

    <ResponseField name="oid" type="string">
      Order ID that originated this fill
    </ResponseField>

    <ResponseField name="dir" type="string">
      Direction indicator for the position change
    </ResponseField>

    <ResponseField name="start_position" type="string">
      Position size before this fill executed
    </ResponseField>

    <ResponseField name="tid" type="string">
      Unique trade ID assigned by the exchange
    </ResponseField>

    <ResponseField name="size" type="string">
      Filled quantity
    </ResponseField>

    <ResponseField name="price" type="string">
      Execution price per unit
    </ResponseField>

    <ResponseField name="builder" type="string">
      Address of the builder that constructed this order
    </ResponseField>

    <ResponseField name="time" type="string">
      ISO-8601 timestamp of the fill
    </ResponseField>

    <ResponseField name="crossed" type="boolean">
      Whether the order crossed the spread (true = taker, false = maker)
    </ResponseField>

    <ResponseField name="hash" type="string">
      On-chain transaction hash
    </ResponseField>

    <ResponseField name="coin" type="string">
      Market/coin symbol (e.g. ETH, BTC)
    </ResponseField>
  </Expandable>

  <Expandable title="HypercoreFundingEvent">
    <ResponseField name="type" type="enum">
      Enum value identifying the transaction type

      Type: [`TransactionType`](/api-reference/streaming-api/types/transaction-type)
    </ResponseField>

    <ResponseField name="hash" type="string">
      Transaction/event hash from the Hypercore L1
    </ResponseField>

    <ResponseField name="time" type="string">
      ISO-8601 timestamp of the funding event
    </ResponseField>

    <ResponseField name="szi" type="string">
      Position size indicator at the time of funding
    </ResponseField>

    <ResponseField name="funding_amount" type="string">
      Funding payment amount in USDC
    </ResponseField>

    <ResponseField name="coin" type="string">
      Market/coin symbol (e.g. ETH, BTC)
    </ResponseField>

    <ResponseField name="funding_rate" type="string">
      Funding rate applied for this settlement
    </ResponseField>
  </Expandable>

  <Expandable title="HypercoreLedgerEvent">
    <ResponseField name="type" type="string">
      Ledger subtype discriminator (e.g. withdraw, deposit, spot\_transfer, send)
    </ResponseField>

    <ResponseField name="delta" type="union">
      Subtype-specific ledger delta payload

      Type: [`LedgerDelta`](/api-reference/streaming-api/types/ledger-delta)

      <Expandable title="LedgerAccountActivationGas">
        <ResponseField name="amount" type="string">
          Gas fee amount
        </ResponseField>

        <ResponseField name="token" type="string">
          Token used for gas payment
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerAccountClassTransfer">
        <ResponseField name="amount" type="string">
          Transfer amount
        </ResponseField>

        <ResponseField name="token" type="string">
          Token identifier
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerBorrowLend">
        <ResponseField name="amount" type="string">
          Borrow or lend amount
        </ResponseField>

        <ResponseField name="interest_amount" type="string">
          Accrued interest amount
        </ResponseField>

        <ResponseField name="operation" type="string">
          Operation type: borrow or lend
        </ResponseField>

        <ResponseField name="token" type="string">
          Token identifier
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerCStakingTransfer">
        <ResponseField name="amount" type="string">
          Transfer amount
        </ResponseField>

        <ResponseField name="is_deposit" type="boolean">
          Whether this is a deposit (true) or withdrawal (false)
        </ResponseField>

        <ResponseField name="token" type="string">
          Token identifier
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerDeployGasAuction">
        <ResponseField name="amount" type="string">
          Auction amount
        </ResponseField>

        <ResponseField name="token" type="string">
          Token identifier
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerDeposit">
        <ResponseField name="usdc" type="string">
          Deposit amount in USDC
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerInternalTransfer">
        <ResponseField name="fee" type="string">
          Transfer fee
        </ResponseField>

        <ResponseField name="destination" type="string">
          Destination user address
        </ResponseField>

        <ResponseField name="usdc" type="string">
          Transfer amount in USDC
        </ResponseField>

        <ResponseField name="user" type="string">
          Source user address
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerLiquidation">
        <ResponseField name="liquidated_ntl_pos" type="string">
          Liquidated notional position value
        </ResponseField>

        <ResponseField name="account_value" type="string">
          Account value at time of liquidation
        </ResponseField>

        <ResponseField name="liquidated_positions" type="object[]">
          List of positions that were liquidated

          Type: [`LedgerLiquidatedPosition`](/api-reference/streaming-api/types/ledger-liquidated-position)
        </ResponseField>

        <ResponseField name="leverage_type" type="string">
          Leverage type (e.g. cross, isolated)
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerPerpDexClassTransfer">
        <ResponseField name="amount" type="string">
          Transfer amount
        </ResponseField>

        <ResponseField name="dex" type="string">
          DEX identifier
        </ResponseField>

        <ResponseField name="to_perp" type="boolean">
          Whether transferring to perp (true) or to spot (false)
        </ResponseField>

        <ResponseField name="token" type="string">
          Token identifier
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerRewardsClaim">
        <ResponseField name="amount" type="string">
          Claimed rewards amount
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerSend">
        <ResponseField name="amount" type="string">
          Send amount
        </ResponseField>

        <ResponseField name="usdc_value" type="string">
          USDC equivalent value
        </ResponseField>

        <ResponseField name="destination_dex" type="string">
          Destination DEX identifier
        </ResponseField>

        <ResponseField name="native_token_fee" type="string">
          Fee in native token
        </ResponseField>

        <ResponseField name="fee" type="string">
          Send fee
        </ResponseField>

        <ResponseField name="destination" type="string">
          Recipient address
        </ResponseField>

        <ResponseField name="fee_token" type="string">
          Token used for fee payment
        </ResponseField>

        <ResponseField name="nonce" type="string">
          Send nonce
        </ResponseField>

        <ResponseField name="user" type="string">
          Sender address
        </ResponseField>

        <ResponseField name="source_dex" type="string">
          Source DEX identifier
        </ResponseField>

        <ResponseField name="token" type="string">
          Token identifier
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerSpotGenesis">
        <ResponseField name="amount" type="string">
          Genesis distribution amount
        </ResponseField>

        <ResponseField name="token" type="string">
          Token identifier
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerSpotTransfer">
        <ResponseField name="amount" type="string">
          Transfer amount
        </ResponseField>

        <ResponseField name="usdc_value" type="string">
          USDC equivalent value
        </ResponseField>

        <ResponseField name="native_token_fee" type="string">
          Fee in native token
        </ResponseField>

        <ResponseField name="fee" type="string">
          Transfer fee
        </ResponseField>

        <ResponseField name="destination" type="string">
          Destination user address
        </ResponseField>

        <ResponseField name="fee_token" type="string">
          Token used for fee payment
        </ResponseField>

        <ResponseField name="nonce" type="string">
          Transfer nonce
        </ResponseField>

        <ResponseField name="user" type="string">
          Source user address
        </ResponseField>

        <ResponseField name="token" type="string">
          Token identifier
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerSubAccountTransfer">
        <ResponseField name="destination" type="string">
          Destination sub-account address
        </ResponseField>

        <ResponseField name="usdc" type="string">
          Transfer amount in USDC
        </ResponseField>

        <ResponseField name="user" type="string">
          Source user address
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerVaultCreate">
        <ResponseField name="fee" type="string">
          Vault creation fee
        </ResponseField>

        <ResponseField name="usdc" type="string">
          Initial deposit amount in USDC
        </ResponseField>

        <ResponseField name="vault" type="string">
          Vault address
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerVaultDeposit">
        <ResponseField name="usdc" type="string">
          Deposit amount in USDC
        </ResponseField>

        <ResponseField name="user" type="string">
          Depositor address
        </ResponseField>

        <ResponseField name="vault" type="string">
          Vault address
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerVaultDistribution">
        <ResponseField name="usdc" type="string">
          Distribution amount in USDC
        </ResponseField>

        <ResponseField name="vault" type="string">
          Vault address
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerVaultLeaderCommission">
        <ResponseField name="usdc" type="string">
          Commission amount in USDC
        </ResponseField>

        <ResponseField name="vault" type="string">
          Vault address
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerVaultWithdraw">
        <ResponseField name="requested_usd" type="string">
          Requested withdrawal amount in USD
        </ResponseField>

        <ResponseField name="commission" type="string">
          Commission charged
        </ResponseField>

        <ResponseField name="basis" type="string">
          Cost basis of the withdrawn share
        </ResponseField>

        <ResponseField name="closing_cost" type="string">
          Cost to close positions for withdrawal
        </ResponseField>

        <ResponseField name="user" type="string">
          Withdrawer address
        </ResponseField>

        <ResponseField name="vault" type="string">
          Vault address
        </ResponseField>
      </Expandable>

      <Expandable title="LedgerWithdraw">
        <ResponseField name="fee" type="string">
          Withdrawal fee
        </ResponseField>

        <ResponseField name="usdc" type="string">
          Withdrawal amount in USDC
        </ResponseField>

        <ResponseField name="nonce" type="string">
          Withdrawal nonce
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="hash" type="string">
      Transaction/event hash from the Hypercore L1
    </ResponseField>

    <ResponseField name="ledger_type" type="string">
      Ledger subtype discriminator (e.g. withdraw, deposit, spot\_transfer, send)
    </ResponseField>

    <ResponseField name="time" type="string">
      ISO-8601 timestamp of the ledger event
    </ResponseField>
  </Expandable>

  <Expandable title="HypercoreWithdrawalEvent">
    <ResponseField name="type" type="enum">
      Enum value identifying the transaction type

      Type: [`TransactionType`](/api-reference/streaming-api/types/transaction-type)
    </ResponseField>

    <ResponseField name="hash" type="string">
      Transaction/event hash from the Hypercore L1
    </ResponseField>

    <ResponseField name="time" type="string">
      ISO-8601 timestamp of the withdrawal event
    </ResponseField>

    <ResponseField name="amount" type="string">
      Withdrawal amount in USDC
    </ResponseField>
  </Expandable>

  <Expandable title="SwapTransaction">
    <ResponseField name="type" type="enum">
      Enum value identifying the transaction type

      Type: [`TransactionType`](/api-reference/streaming-api/types/transaction-type)
    </ResponseField>

    <ResponseField name="amount_out" type="string">
      Amount of tokens received
    </ResponseField>

    <ResponseField name="amount_in" type="string">
      Amount of tokens sold
    </ResponseField>

    <ResponseField name="token_out" type="object">
      Metadata for the token bought

      Type: [`TokenContractMetadata`](/api-reference/streaming-api/types/token-contract-metadata)

      <Expandable title="properties">
        <ResponseField name="contract_name" type="string">
          Name of the token contract
        </ResponseField>

        <ResponseField name="contract_address" type="string">
          Address of the token contract
        </ResponseField>

        <ResponseField name="contract_decimals" type="int">
          Number of decimal places for the token
        </ResponseField>

        <ResponseField name="contract_ticker_symbol" type="string">
          Ticker symbol of the token
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="token_in" type="object">
      Metadata for the token sold

      Type: [`TokenContractMetadata`](/api-reference/streaming-api/types/token-contract-metadata)

      <Expandable title="properties">
        <ResponseField name="contract_name" type="string">
          Name of the token contract
        </ResponseField>

        <ResponseField name="contract_address" type="string">
          Address of the token contract
        </ResponseField>

        <ResponseField name="contract_decimals" type="int">
          Number of decimal places for the token
        </ResponseField>

        <ResponseField name="contract_ticker_symbol" type="string">
          Ticker symbol of the token
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>

  <Expandable title="TransferTransaction">
    <ResponseField name="type" type="enum">
      Enum value identifying the transaction type

      Type: [`TransactionType`](/api-reference/streaming-api/types/transaction-type)
    </ResponseField>

    <ResponseField name="amount" type="string">
      Amount of tokens transferred
    </ResponseField>

    <ResponseField name="quote_usd" type="float">
      Total USD value of the transferred amount
    </ResponseField>

    <ResponseField name="quote_rate_usd" type="float">
      USD price per token at time of transfer
    </ResponseField>

    <ResponseField name="contract_metadata" type="object">
      Metadata for the transferred token contract

      Type: [`TokenContractMetadata`](/api-reference/streaming-api/types/token-contract-metadata)

      <Expandable title="properties">
        <ResponseField name="contract_name" type="string">
          Name of the token contract
        </ResponseField>

        <ResponseField name="contract_address" type="string">
          Address of the token contract
        </ResponseField>

        <ResponseField name="contract_decimals" type="int">
          Number of decimal places for the token
        </ResponseField>

        <ResponseField name="contract_ticker_symbol" type="string">
          Ticker symbol of the token
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="from" type="string">
      Sender wallet address
    </ResponseField>

    <ResponseField name="to" type="string">
      Recipient wallet address
    </ResponseField>
  </Expandable>

  <Expandable title="WithdrawTransaction">
    <ResponseField name="type" type="enum">
      Enum value identifying the transaction type

      Type: [`TransactionType`](/api-reference/streaming-api/types/transaction-type)
    </ResponseField>

    <ResponseField name="amount" type="string">
      Amount of tokens withdrawn
    </ResponseField>

    <ResponseField name="quote_usd" type="float">
      Total USD value of the withdrawn amount
    </ResponseField>

    <ResponseField name="quote_rate_usd" type="float">
      USD price per token at time of withdrawal
    </ResponseField>

    <ResponseField name="contract_metadata" type="object">
      Metadata for the withdrawn token contract

      Type: [`TokenContractMetadata`](/api-reference/streaming-api/types/token-contract-metadata)

      <Expandable title="properties">
        <ResponseField name="contract_name" type="string">
          Name of the token contract
        </ResponseField>

        <ResponseField name="contract_address" type="string">
          Address of the token contract
        </ResponseField>

        <ResponseField name="contract_decimals" type="int">
          Number of decimal places for the token
        </ResponseField>

        <ResponseField name="contract_ticker_symbol" type="string">
          Ticker symbol of the token
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="from" type="string">
      Source pool or contract address
    </ResponseField>

    <ResponseField name="to" type="string">
      Recipient wallet address
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="gas_used" type="string">
  The amount of gas used by the transaction
</ResponseField>

<ResponseField name="block_hash" type="string">
  The hash of the block containing the transaction
</ResponseField>

<ResponseField name="to_address" type="string">
  The recipient's address
</ResponseField>

<ResponseField name="tx_hash" type="string">
  The transaction hash
</ResponseField>

<ResponseField name="block_height" type="int">
  The block number where the transaction was included
</ResponseField>

<ResponseField name="decoded_type" type="string">
  The type of decoded event (e.g., SWAP)
</ResponseField>

<ResponseField name="miner_address" type="string">
  The address of the block miner
</ResponseField>

<ResponseField name="tx_offset" type="int">
  The position of the transaction in the block
</ResponseField>

<ResponseField name="block_signed_at" type="string">
  Timestamp when the block containing this transaction was signed (ISO-8601)
</ResponseField>

<ResponseField name="from_address" type="string">
  The sender's address
</ResponseField>

<ResponseField name="logs" type="object[]">
  Array of event logs emitted during the transaction

  Type: [`TransactionLog`](/api-reference/streaming-api/types/transaction-log)

  <Expandable title="properties">
    <ResponseField name="data" type="string">
      ABI-encoded log data
    </ResponseField>

    <ResponseField name="emitter_address" type="string">
      Address of the contract that emitted the log
    </ResponseField>

    <ResponseField name="log_offset" type="int">
      Position of the log within the transaction
    </ResponseField>

    <ResponseField name="topics" type="array<string>">
      Indexed event parameters (topic\[0] is the event signature hash)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="value" type="string">
  The transaction value in native currency
</ResponseField>

<ResponseField name="chain_name" type="string">
  The blockchain network where the transaction occurred
</ResponseField>

<ResponseField name="successful" type="boolean">
  Whether the transaction was successful
</ResponseField>

## Decoded Events

Note from the [Subscription](#subscription) query above, this stream decodes events which you can fetch with fragment spreads. See the full schema of available [decoded events](/goldrush-streaming-api/decoded-events).