Skip to main content

Overview

HyperCore powers fully onchain perpetual futures and spot order books with 200,000 orders/second throughput. The backbone of Hyperliquid’s high-performance trading infrastructure.
GoldRush offers the most comprehensive HyperCore Data API suite for developers, analysts, and enterprises. Whether you’re building a DeFi dashboard, a wallet, a trading bot, an AI agent or a compliance platform, our HyperCore Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need.

Mainnet

PropertyValue
Chain NameHYPERCORE_MAINNET
Chain IDna
Network TypeFrontier Chain
Support Levelfrontier
Block ExplorerHyperliquid Explorer
Official WebsiteHyperCore Website
Native Gas TokenHYPE

API Usage

To use this blockchain network in GoldRush API calls, use:

Chain Name

  • HYPERCORE_MAINNET (mainnet)

Example Streaming Subscription

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
  }
}
import { GoldRushClient } from "@covalenthq/client-sdk";

const client = new GoldRushClient("<GOLDRUSH_API_KEY>");

const SUBSCRIPTION_QUERY = `
  subscription {
    walletTxs(
      wallet_addresses: ["0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00"]
      chain_name: HYPERCORE_MAINNET
    ) {
      decoded_details {
        ... on ErrorDetails {
          message
        }
        ... on HypercoreDelegationEvent {
          hash
          time
          is_undelegate
          amount
          validator
        }
        ... on HypercoreDepositEvent {
          hash
          time
          amount
        }
        ... on HypercoreFillTransaction {
          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 {
          hash
          time
          szi
          funding_amount
          coin
          funding_rate
        }
        ... on HypercoreLedgerEvent {
          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 {
          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
    }
  }
`;

const unsubscribe = client.StreamingService.rawQuery(
  SUBSCRIPTION_QUERY,
  {},
  {
    next: (data) => console.log(JSON.stringify(data, null, 2)),
    error: (error) => console.error("Error:", error),
    complete: () => console.log("Stream completed"),
  }
);
Connect via WebSocket at wss://streaming.goldrushdata.com/graphql with your API key in the connection parameters. See the Streaming API Quickstart for full setup details.

Streaming API Support

This chain supports 5 GoldRush Streaming APIs:

Decoded Event Types

Pipeline API Support

This chain supports 4 GoldRush Pipeline API data objects that can be streamed to your infrastructure:

Additional Resources