GoldRush decodes raw HyperCore transactions into structured, typed events.
These are unique to Hyperliquid's architecture and go far beyond what
standard EVM decoded events provide.
All decoded events share a common interface via{" "}
HypercoreMiscEventsTransaction
{" "}
with hash and time fields.
;
export const StreamingApiSupport = () => <>
Here are some examples of pair and token addresses that can be used by the OHLCV streams for HyperCore. Note that for OHLCV Pairs, you can prefix the specific HIP-3 market deployer (e.g. flx:) before the asset symbol to get that specific market price.
For this GOLD-USDC market, you can use either of the following strings as the pair address:
xyz:GOLD-USDC
xyz:GOLDUSD
Stream
Example Addresses
OHLCV Pairs Stream
xyz:GOLD-USDC, flx:OIL-USDH, BTC-USDC, HYPE
OHLCV Tokens Stream
GOLD, OIL, BTC, HYPE
;
export const Overview = () => <>
HyperCore is a non-EVM chain purpose-built for high-frequency derivatives
trading. GoldRush is the HyperCore data provider for trading bots, market
makers, and quantitative desks - streaming HyperCore's native trading data
in real time, including data not available via the public Hyperliquid API,
such as liquidation details, vault actions, and complete ledger event
history, with no rate limits.
Data coverage: HyperCore data starts at block{" "}
{HYPERCORE_START_BLOCK} ({HYPERCORE_START_TIMESTAMP}). This is distinct from{" "}
HyperEVM, whose coverage goes back to
genesis.
What makes this unique
Exclusive data - Liquidation cascades, vault
deposits/withdrawals, and detailed ledger events that bypass
Hyperliquid's public API limitations
Zero rate limits - Dedicated infrastructure with no
request throttling
Dedicated Tokyo nodes - Private backbone for
low-latency, high-throughput data ingestion directly from Hyperliquid's
infrastructure
Non-EVM native - First-class support for Hyperliquid's
custom chain architecture, not an EVM compatibility layer
Deep historical coverage - Data available from block{" "}
{HYPERCORE_START_BLOCK} ({HYPERCORE_START_TIMESTAMP}) onward
Supported APIs
Aggregated entry point for everything Hyperliquid on GoldRush - the
drop-in /info API, real-time streams, warehouse delivery,
and HyperEVM coverage under one API key.
Coming soon. REST API access to historical HyperCore data:
balances, transaction histories, and decoded events.
Stream Hyperliquid fills, liquidations, funding rates, vault actions,
and OHLCV pricing data in real-time using GraphQL over WebSockets.{" "}
Use cases: Trading bots, market makers, perps dashboards, liquidation
monitoring, and AI Agents.
Stream blockchain data directly to your own infrastructure. Push decoded
blocks, transactions, event logs, and protocol-specific data into your
database, warehouse, queue, or webhook with ABI decoding and SQL
transforms built in.
Use cases: Data warehousing, analytics dashboards, ETL pipelines, and
backend indexing.
;
## 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
| Property | Value |
| -------------------- | ------------------------------------------------------------ |
| **Chain Name** | `HYPERCORE_MAINNET` |
| **Chain ID** | `na` |
| **Network Type** | Frontier Chain |
| **Support Level** | frontier |
| **Block Explorer** | [Hyperliquid Explorer](https://app.hyperliquid.xyz/explorer) |
| **Official Website** | [HyperCore Website](https://hyperfoundation.org/) |
| **Native Gas Token** | HYPE |
## API Usage
To use this blockchain network in GoldRush API calls, use:
#### Chain Name
* `HYPERCORE_MAINNET` (mainnet)
#### Example Streaming Subscription
```graphql GraphQL Subscription theme={null}
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
}
}
```
```typescript TypeScript SDK theme={null}
import { GoldRushClient } from "@covalenthq/client-sdk";
const client = new GoldRushClient("");
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](/goldrush-streaming-api/quickstart) for full setup details.
## Streaming API Support
This chain supports **5** GoldRush Streaming APIs:
* [OHLCV Pairs Stream](/api-reference/streaming-api/subscriptions/ohlcv-pairs-stream/)
* [OHLCV Tokens Stream](/api-reference/streaming-api/subscriptions/ohlcv-tokens-stream/)
* [Wallet Activity Stream](/api-reference/streaming-api/subscriptions/wallet-activity-stream/)
* [OHLCV Pairs Query](/api-reference/streaming-api/queries/ohlcv-pairs-query/)
* [OHLCV Tokens Query](/api-reference/streaming-api/queries/ohlcv-tokens-query/)
## Decoded Event Types
## Pipeline API Support
This chain supports **4** GoldRush Pipeline API data objects that can be streamed to your infrastructure:
* [Fills](/goldrush-pipeline-api/supported-chains#hypercore)
* [Trades](/goldrush-pipeline-api/supported-chains#hypercore)
* [Orders](/goldrush-pipeline-api/supported-chains#hypercore)
* [Misc Events](/goldrush-pipeline-api/supported-chains#hypercore)
## Additional Resources
