概述
This page provides a complete schema reference for all tables available in SQL Explorer. Each table includes column names, data types, sort keys, and partition strategies.
Hyperliquid (HyperCore)
SQL Explorer provides comprehensive coverage of Hyperliquid HyperCore with billions of rows of indexed data across multiple tables.
Cluster ID: hyperliquid-core-mainnet
Use this cluster ID when making API requests to query Hyperliquid data via the REST API.
How to Use This Reference
- Sort Keys (⚡): Columns marked as sort keys are indexed for fast queries. Include these in WHERE clauses for best performance.
- Partition Strategy: Tables are partitioned by time (usually
toYYYYMM(block_time)). Filter on time ranges to scan fewer partitions. - Column Types: Data types are shown exactly as stored (e.g.,
UInt64,Decimal(38, 18),DateTime64(6, 'UTC')).
▶ Complete Schema for All Tables (Click to expand)
Detailed schema for all Hyperliquid tables including column names, data types, sort keys (⚡), and partition strategies.
hyperliquid_agents
Sort Keys: ⚡ block_number, agent | Partition: toYYYYMM(snapshot_time)
| Column | 类型 | Sort Key |
|---|---|---|
| agent | FixedString(42) | 是 |
| 区块号 | UInt64 | 是 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| 名称 | String | 不 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
| 用户 | FixedString(42) | 不 |
| valid_until | String | 不 |
hyperliquid_asset_transfers
Sort Keys: ⚡ block_number, tx_hash, user | Partition: toYYYYMM(block_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 金额 | Nullable(Decimal(38, 18)) | 不 |
| 区块号 | UInt64 | 是 |
| block_time | DateTime64(6, 'UTC') | 不 |
| destination | Nullable(FixedString(42)) | 不 |
| 费用 | Nullable(Decimal(38, 18)) | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| 非重复值 | Nullable(UInt64) | 不 |
| 时间 | DateTime64(6, 'UTC') | 不 |
| token | Nullable(String) | 不 |
| transfer_type | LowCardinality(String) | 不 |
| tx_hash | FixedString(66) | 是 |
| usdc_amount | Nullable(Decimal(38, 18)) | 不 |
| 用户 | FixedString(42) | 是 |
hyperliquid_blocks
Sort Keys: ⚡ block_number | Partition: toYYYYMM(block_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 是 |
| block_time | DateTime64(6, 'UTC') | 不 |
| book_diffs_count | UInt32 | 不 |
| fills_count | UInt32 | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| misc_events_count | UInt32 | 不 |
| orders_count | UInt32 | 不 |
| twap_statuses_count | UInt32 | 不 |
| writer_actions_count | UInt32 | 不 |
hyperliquid_bridge
Sort Keys: ⚡ block_number, bridge_type, user, nonce, eth_block_number, tx_hash | Partition: toYYYYMM(snapshot_time)
| Column | 类型 | Sort Key |
|---|---|---|
| amount_wei | UInt64 | 不 |
| 区块号 | UInt64 | 是 |
| bridge_type | LowCardinality(String) | 是 |
| eth_block_number | UInt64 | 是 |
| event_time | String | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| 非重复值 | UInt64 | 是 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
| tx_hash | String | 是 |
| 用户 | FixedString(42) | 是 |
hyperliquid_builder_fills
Sort Keys: ⚡ builder_address, timestamp, tid | Partition: toYYYYMM(block_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 不 |
| block_time | DateTime64(6, 'UTC') | 不 |
| builder_address | Nullable(FixedString(42)) | 是 |
| builder_fee | Nullable(Decimal(38, 18)) | 不 |
| cloid | Nullable(String) | 不 |
| closed_pnl | Decimal(38, 18) | 不 |
| 硬币 | LowCardinality(String) | 不 |
| created_at | DateTime64(6, 'UTC') | 不 |
| crossed | UInt8 | 不 |
| dir | LowCardinality(String) | 不 |
| 费用 | Decimal(38, 18) | 不 |
| 哈希 | FixedString(66) | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| is_liquidation | UInt8 | 不 |
| liquidated_user | Nullable(FixedString(42)) | 不 |
| liquidation_mark_price | Nullable(Decimal(38, 18)) | 不 |
| liquidation_method | Nullable(String) | 不 |
| oid | UInt64 | 不 |
| 价格 | Decimal(38, 18) | 不 |
| side | Enum8('B' = 1, 'A' = 2) | 不 |
| 大小 | Decimal(38, 18) | 不 |
| start_position | Decimal(38, 18) | 不 |
| tid | UInt64 | 是 |
| 时间戳 | DateTime64(3, 'UTC') | 是 |
| twap_id | Nullable(UInt64) | 不 |
| 更新时间 | DateTime64(6, 'UTC') | 不 |
| 用户 | FixedString(42) | 不 |
hyperliquid_builder_transactions
Sort Keys: ⚡ block_number, hash, user | Partition: toYYYYMM(block_time)
| Column | 类型 | Sort Key |
|---|---|---|
| action_type | LowCardinality(String) | 不 |
| 区块号 | UInt64 | 是 |
| block_time | DateTime64(6, 'UTC') | 不 |
| builder | String | 不 |
| builder_fee | Nullable(Decimal(38, 18)) | 不 |
| 硬币 | Nullable(String) | 不 |
| 哈希 | String | 是 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| is_success | UInt8 | 不 |
| 用户 | String | 是 |
hyperliquid_clearinghouse_states
Sort Keys: ⚡ block_number, clearinghouse, user, asset_idx | Partition: toYYYYMM(snapshot_time)
| Column | 类型 | Sort Key |
|---|---|---|
| asset_idx | UInt16 | 是 |
| 区块号 | UInt64 | 是 |
| clearinghouse | UInt8 | 是 |
| 硬币 | LowCardinality(String) | 不 |
| entry_notional | UInt64 | 不 |
| funding_alltime | Int64 | 不 |
| funding_since_change | Int64 | 不 |
| funding_since_open | Int64 | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| 边距 | UInt64 | 不 |
| 大小 | Int64 | 不 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
| usdc_balance | Int64 | 不 |
| 用户 | FixedString(42) | 是 |
hyperliquid_delegator_rewards
Sort Keys: ⚡ block_number, validator, delegator | Partition: toYYYYMM(snapshot_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 是 |
| c | UInt64 | 不 |
| commission_bps | UInt16 | 不 |
| delegator | FixedString(42) | 是 |
| e | UInt64 | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| m | UInt64 | 不 |
| reward | Decimal(38, 8) | 不 |
| reward_wei | UInt64 | 不 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
| source | LowCardinality(String) | 不 |
| validator | FixedString(42) | 是 |
| validator_total_delegated | UInt64 | 不 |
hyperliquid_dex_trades
Sort Keys: ⚡ none | Partition: none
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 不 |
| block_time | DateTime64(6, 'UTC') | 不 |
| buyer_address | FixedString(42) | 不 |
| buyer_builder_address | Nullable(FixedString(42)) | 不 |
| buyer_builder_fee | Nullable(Decimal(38, 18)) | 不 |
| buyer_closed_pnl | Decimal(38, 18) | 不 |
| buyer_crossed | UInt8 | 不 |
| buyer_dir | LowCardinality(String) | 不 |
| buyer_fee | Decimal(38, 18) | 不 |
| buyer_order_id | UInt64 | 不 |
| buyer_start_position | Decimal(38, 18) | 不 |
| buyer_twap_id | Nullable(UInt64) | 不 |
| 硬币 | LowCardinality(String) | 不 |
| fee_token | LowCardinality(String) | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| liquidated_user | Nullable(FixedString(42)) | 不 |
| liquidation_mark_price | Nullable(Decimal(38, 18)) | 不 |
| liquidation_method | Nullable(String) | 不 |
| market_type | String | 不 |
| 价格 | Decimal(38, 18) | 不 |
| seller_address | FixedString(42) | 不 |
| seller_builder_address | Nullable(FixedString(42)) | 不 |
| seller_builder_fee | Nullable(Decimal(38, 18)) | 不 |
| seller_closed_pnl | Decimal(38, 18) | 不 |
| seller_crossed | UInt8 | 不 |
| seller_dir | LowCardinality(String) | 不 |
| seller_fee | Decimal(38, 18) | 不 |
| seller_order_id | UInt64 | 不 |
| seller_start_position | Decimal(38, 18) | 不 |
| seller_twap_id | Nullable(UInt64) | 不 |
| side | Enum8('B' = 1, 'A' = 2) | 不 |
| 大小 | Decimal(38, 18) | 不 |
| 时间戳 | DateTime64(3, 'UTC') | 不 |
| total_builder_fee | Nullable(Decimal(38, 18)) | 不 |
| trade_id | UInt64 | 不 |
| 交易哈希 | FixedString(66) | 不 |
| unique_id | String | 不 |
| usd_amount | Decimal(38, 18) | 不 |
hyperliquid_display_names
Sort Keys: ⚡ block_number, user | Partition: toYYYYMM(snapshot_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 是 |
| display_name | String | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
| 用户 | FixedString(42) | 是 |
hyperliquid_fills
Sort Keys: ⚡ block_number, tid, user | Partition: toYYYYMM(block_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 是 |
| block_time | DateTime64(6, 'UTC') | 不 |
| builder | Nullable(FixedString(42)) | 不 |
| builder_fee | Nullable(Decimal(38, 18)) | 不 |
| cloid | Nullable(String) | 不 |
| closed_pnl | Decimal(38, 18) | 不 |
| 硬币 | LowCardinality(String) | 不 |
| crossed | UInt8 | 不 |
| deployer_fee | Nullable(Decimal(38, 18)) | 不 |
| dir | LowCardinality(String) | 不 |
| 费用 | Decimal(38, 18) | 不 |
| fee_token | LowCardinality(String) | 不 |
| 哈希 | FixedString(66) | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| is_liquidation | UInt8 | 不 |
| liquidated_user | Nullable(FixedString(42)) | 不 |
| liquidation_mark_price | Nullable(Decimal(38, 18)) | 不 |
| liquidation_method | Nullable(String) | 不 |
| oid | UInt64 | 不 |
| 价格 | Decimal(38, 18) | 不 |
| priority_gas | Nullable(Decimal(38, 18)) | 不 |
| side | Enum8('B' = 1, 'A' = 2) | 不 |
| 大小 | Decimal(38, 18) | 不 |
| start_position | Decimal(38, 18) | 不 |
| tid | UInt64 | 是 |
| 时间 | DateTime64(3, 'UTC') | 不 |
| twap_id | Nullable(UInt64) | 不 |
| 用户 | FixedString(42) | 是 |
hyperliquid_funding
Sort Keys: ⚡ block_number, user, coin, time | Partition: toYYYYMM(block_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 是 |
| block_time | DateTime64(6, 'UTC') | 不 |
| 硬币 | LowCardinality(String) | 是 |
| funding_amount | Decimal(38, 18) | 不 |
| funding_rate | Decimal(38, 18) | 不 |
| 哈希 | FixedString(66) | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| szi | Decimal(38, 18) | 不 |
| 时间 | DateTime64(6, 'UTC') | 是 |
| 用户 | FixedString(42) | 是 |
hyperliquid_funding_summary_hourly
Sort Keys: ⚡ coin, hour | Partition: toYYYYMM(hour)
| Column | 类型 | Sort Key |
|---|---|---|
| avg_funding_rate | SimpleAggregateFunction(any, Float64) | 不 |
| 硬币 | LowCardinality(String) | 是 |
| hour | DateTime('UTC') | 是 |
| total_funding | SimpleAggregateFunction(sum, Decimal(38, 18)) | 不 |
| unique_users | SimpleAggregateFunction(max, UInt64) | 不 |
hyperliquid_ledger_updates
Sort Keys: ⚡ block_number, user, time, hash | Partition: toYYYYMM(block_time)
| Column | 类型 | Sort Key |
|---|---|---|
| account_value | Nullable(Decimal(38, 18)) | 不 |
| 金额 | Nullable(Decimal(38, 18)) | 不 |
| basis | Nullable(Decimal(38, 18)) | 不 |
| 区块号 | UInt64 | 是 |
| block_time | DateTime64(6, 'UTC') | 不 |
| closing_cost | Nullable(Decimal(38, 18)) | 不 |
| 佣金 | Nullable(Decimal(38, 18)) | 不 |
| delta_type | LowCardinality(String) | 不 |
| destination | Nullable(FixedString(42)) | 不 |
| destination_dex | Nullable(String) | 不 |
| dex | Nullable(String) | 不 |
| 费用 | Nullable(Decimal(38, 18)) | 不 |
| fee_token | Nullable(String) | 不 |
| 哈希 | FixedString(66) | 是 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| interest_amount | Nullable(Decimal(38, 18)) | 不 |
| is_deposit | Nullable(UInt8) | 不 |
| leverage_type | Nullable(String) | 不 |
| liquidated_ntl_pos | Nullable(Decimal(38, 18)) | 不 |
| liquidated_positions | Nullable(String) | 不 |
| native_token_fee | Nullable(Decimal(38, 18)) | 不 |
| net_withdrawn_usd | Nullable(Decimal(38, 18)) | 不 |
| 非重复值 | Nullable(UInt64) | 不 |
| operation | Nullable(String) | 不 |
| requested_usd | Nullable(Decimal(38, 18)) | 不 |
| secondary_user | Nullable(FixedString(42)) | 不 |
| source_dex | Nullable(String) | 不 |
| 时间 | DateTime64(6, 'UTC') | 是 |
| to_perp | Nullable(UInt8) | 不 |
| token | Nullable(String) | 不 |
| usdc_amount | Nullable(Decimal(38, 18)) | 不 |
| usdc_value | Nullable(Decimal(38, 18)) | 不 |
| 用户 | FixedString(42) | 是 |
| vault | Nullable(FixedString(42)) | 不 |
hyperliquid_liquidations_hourly
Sort Keys: ⚡ hour, coin | Partition: toYYYYMM(hour)
| Column | 类型 | Sort Key |
|---|---|---|
| 硬币 | LowCardinality(String) | 是 |
| hour | DateTime | 是 |
| liquidated_volume | SimpleAggregateFunction(sum, Decimal(38, 18)) | 不 |
| liquidation_count | SimpleAggregateFunction(sum, UInt64) | 不 |
| unique_liquidated_users | SimpleAggregateFunction(max, UInt64) | 不 |
hyperliquid_market_volume_hourly
Sort Keys: ⚡ coin, hour | Partition: toYYYYMM(hour)
| Column | 类型 | Sort Key |
|---|---|---|
| close | SimpleAggregateFunction(anyLast, Decimal(38, 18)) | 不 |
| 硬币 | LowCardinality(String) | 是 |
| high | SimpleAggregateFunction(max, Decimal(38, 18)) | 不 |
| hour | DateTime('UTC') | 是 |
| low | SimpleAggregateFunction(min, Decimal(38, 18)) | 不 |
| open | SimpleAggregateFunction(any, Decimal(38, 18)) | 不 |
| trade_count | SimpleAggregateFunction(sum, UInt64) | 不 |
| 卷 | SimpleAggregateFunction(sum, Decimal(38, 18)) | 不 |
hyperliquid_metrics_dex_overview
Sort Keys: ⚡ day, coin | Partition: toYYYYMM(day)
| Column | 类型 | Sort Key |
|---|---|---|
| 硬币 | LowCardinality(String) | 是 |
| day | Date | 是 |
| fees | SimpleAggregateFunction(sum, Decimal(38, 18)) | 不 |
| fill_count | SimpleAggregateFunction(sum, UInt64) | 不 |
| high_price | SimpleAggregateFunction(max, Decimal(38, 18)) | 不 |
| liquidations | SimpleAggregateFunction(sum, UInt64) | 不 |
| low_price | SimpleAggregateFunction(min, Decimal(38, 18)) | 不 |
| unique_traders | SimpleAggregateFunction(max, UInt64) | 不 |
| volume_usd | SimpleAggregateFunction(sum, Decimal(38, 18)) | 不 |
hyperliquid_metrics_overview
Sort Keys: ⚡ day | Partition: toYYYYMM(day)
| Column | 类型 | Sort Key |
|---|---|---|
| active_traders | SimpleAggregateFunction(max, UInt64) | 不 |
| builder_fill_count | SimpleAggregateFunction(sum, UInt64) | 不 |
| coins_traded | SimpleAggregateFunction(max, UInt64) | 不 |
| day | Date | 是 |
| liquidation_count | SimpleAggregateFunction(sum, UInt64) | 不 |
| liquidation_volume_usd | SimpleAggregateFunction(sum, Decimal(38, 18)) | 不 |
| total_builder_fees | SimpleAggregateFunction(sum, Decimal(38, 18)) | 不 |
| total_fees | SimpleAggregateFunction(sum, Decimal(38, 18)) | 不 |
| total_fills | SimpleAggregateFunction(sum, UInt64) | 不 |
| total_volume_usd | SimpleAggregateFunction(sum, Decimal(38, 18)) | 不 |
hyperliquid_oracle_prices
Sort Keys: ⚡ block_number, clearinghouse, asset_idx | Partition: toYYYYMM(snapshot_time)
| Column | 类型 | Sort Key |
|---|---|---|
| asset_idx | UInt16 | 是 |
| 区块号 | UInt64 | 是 |
| clearinghouse | UInt8 | 是 |
| 硬币 | LowCardinality(String) | 不 |
| daily_px | String | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| mark_px | String | 不 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
hyperliquid_order_book_diffs
Sort Keys: ⚡ coin, side, block_number, oid | Partition: toYYYYMM(block_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 是 |
| block_time | DateTime64(6, 'UTC') | 不 |
| 硬币 | LowCardinality(String) | 是 |
| diff_type | LowCardinality(String) | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| new_size | Nullable(Decimal(38, 18)) | 不 |
| oid | UInt64 | 是 |
| orig_size | Nullable(Decimal(38, 18)) | 不 |
| 价格 | Decimal(38, 18) | 不 |
| side | Enum8('B' = 1, 'A' = 2) | 是 |
| 大小 | Nullable(Decimal(38, 18)) | 不 |
| 用户 | FixedString(42) | 不 |
hyperliquid_订单
Sort Keys: ⚡ block_number, oid, status_time | Partition: toYYYYMM(block_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 是 |
| block_time | DateTime64(6, 'UTC') | 不 |
| builder | Nullable(String) | 不 |
| children | Nullable(String) | 不 |
| cloid | Nullable(String) | 不 |
| 硬币 | LowCardinality(String) | 不 |
| 哈希 | Nullable(FixedString(66)) | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| is_position_tpsl | UInt8 | 不 |
| is_trigger | UInt8 | 不 |
| limit_price | Decimal(38, 18) | 不 |
| oid | UInt64 | 是 |
| order_timestamp | DateTime64(3, 'UTC') | 不 |
| 订单类型 | LowCardinality(String) | 不 |
| orig_size | Decimal(38, 18) | 不 |
| reduce_only | UInt8 | 不 |
| side | Enum8('B' = 1, 'A' = 2) | 不 |
| 大小 | Decimal(38, 18) | 不 |
| 状态 | LowCardinality(String) | 不 |
| status_time | DateTime64(6, 'UTC') | 是 |
| tif | LowCardinality(String) | 不 |
| trigger_condition | Nullable(String) | 不 |
| 触发价格 | Nullable(Decimal(38, 18)) | 不 |
| unique_id | String | 不 |
| 用户 | FixedString(42) | 不 |
hyperliquid_结果_市场
Sort Keys: ⚡ none | Partition: none
| Column | 类型 | Sort Key |
|---|---|---|
| base_token_idx | Nullable(UInt64) | 不 |
| 区块号 | UInt64 | 不 |
| 硬币 | Nullable(String) | 不 |
| 描述 | String | 不 |
| expiry | String | 不 |
| fee_share | Float64 | 不 |
| first_enabled_as_quote | String | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| is_liquid_base | UInt8 | 不 |
| is_liquid_quote | UInt8 | 不 |
| locked | UInt8 | 不 |
| 名称 | LowCardinality(String) | 不 |
| ndo | UInt64 | 不 |
| nou | UInt64 | 不 |
| nqu | UInt64 | 不 |
| outcome_class | LowCardinality(String) | 不 |
| outcome_id | UInt64 | 不 |
| pair_name | String | 不 |
| period | LowCardinality(String) | 不 |
| quote_raw | Nullable(UInt64) | 不 |
| quote_token_idx | Nullable(UInt64) | 不 |
| quote_token_name | Nullable(String) | 不 |
| quote_token_status | LowCardinality(String) | 不 |
| quote_token_usdc_px | Decimal(38, 18) | 不 |
| quote_token_usdc_px_raw | UInt64 | 不 |
| raw_side_json | String | 不 |
| raw_spec_json | String | 不 |
| side_count | UInt16 | 不 |
| side_index | UInt8 | 不 |
| side_name | LowCardinality(String) | 不 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
| spot_deploy_time | String | 不 |
| spot_index | Nullable(UInt64) | 不 |
| spot_resolution | LowCardinality(String) | 不 |
| target_price | String | 不 |
| token_idx | Nullable(UInt64) | 不 |
| token_name | Nullable(String) | 不 |
| underlying | LowCardinality(String) | 不 |
hyperliquid_outcome_meta
Sort Keys: ⚡ block_number, outcome_id | Partition: toYYYYMM(snapshot_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 是 |
| deploy_gas_auction_json | String | 不 |
| 描述 | String | 不 |
| expiry | String | 不 |
| fee_share | Float64 | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| locked | UInt8 | 不 |
| 名称 | LowCardinality(String) | 不 |
| ndo | UInt64 | 不 |
| nou | UInt64 | 不 |
| nqu | UInt64 | 不 |
| outcome_class | LowCardinality(String) | 不 |
| outcome_id | UInt64 | 是 |
| period | LowCardinality(String) | 不 |
| quote_raw | Nullable(UInt64) | 不 |
| raw_spec_json | String | 不 |
| side_count | UInt16 | 不 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
| target_price | String | 不 |
| underlying | LowCardinality(String) | 不 |
hyperliquid_outcome_question_members
Sort Keys: ⚡ block_number, question_id, outcome_id | Partition: toYYYYMM(snapshot_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 是 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| is_fallback | UInt8 | 不 |
| is_settled | UInt8 | 不 |
| outcome_id | UInt64 | 是 |
| question_id | UInt64 | 是 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
| source | LowCardinality(String) | 不 |
hyperliquid_outcome_questions
Sort Keys: ⚡ block_number, question_id | Partition: toYYYYMM(snapshot_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 是 |
| 描述 | String | 不 |
| fallback_outcome | Nullable(UInt64) | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| 名称 | String | 不 |
| named_outcomes_json | String | 不 |
| question_id | UInt64 | 是 |
| raw_question_json | String | 不 |
| settled_named_outcomes_json | String | 不 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
hyperliquid_outcome_sides
Sort Keys: ⚡ block_number, outcome_id, side_index | Partition: toYYYYMM(snapshot_time)
| Column | 类型 | Sort Key |
|---|---|---|
| base_token_idx | Nullable(UInt64) | 不 |
| 区块号 | UInt64 | 是 |
| 硬币 | Nullable(String) | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| outcome_id | UInt64 | 是 |
| quote_token_idx | Nullable(UInt64) | 不 |
| quote_token_name | Nullable(String) | 不 |
| raw_side_json | String | 不 |
| side_index | UInt8 | 是 |
| side_m_raw | String | 不 |
| side_m_value | Nullable(Int64) | 不 |
| side_name | LowCardinality(String) | 不 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
| spot_index | Nullable(UInt64) | 不 |
| spot_indices_json | String | 不 |
| spot_resolution | LowCardinality(String) | 不 |
| token_idx | Nullable(UInt64) | 不 |
| token_name | Nullable(String) | 不 |
hyperliquid_perpetual_market_contexts
Sort Keys: ⚡ none | Partition: none
| Column | 类型 | Sort Key |
|---|---|---|
| 硬币 | LowCardinality(String) | 不 |
| day_base_vlm | Decimal(38, 18) | 不 |
| day_ntl_vlm | Decimal(38, 18) | 不 |
| funding | Decimal(38, 18) | 不 |
| impact_ask | Nullable(Decimal(38, 18)) | 不 |
| impact_bid | Nullable(Decimal(38, 18)) | 不 |
| mark_px | Decimal(38, 18) | 不 |
| mid_px | Decimal(38, 18) | 不 |
| open_interest | Decimal(38, 18) | 不 |
| oracle_px | Decimal(38, 18) | 不 |
| polled_at | DateTime64(6, 'UTC') | 不 |
| premium | Decimal(38, 18) | 不 |
| prev_day_px | Decimal(38, 18) | 不 |
hyperliquid_perpetual_markets
Sort Keys: ⚡ coin | Partition: none
| Column | 类型 | Sort Key |
|---|---|---|
| 硬币 | LowCardinality(String) | 是 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| margin_table_id | Nullable(UInt16) | 不 |
| market_index | UInt16 | 不 |
| max_leverage | UInt16 | 不 |
| only_isolated | UInt8 | 不 |
| sz_decimals | UInt8 | 不 |
hyperliquid_perpetual_positions
Sort Keys: ⚡ block_number, clearinghouse, user, asset_idx | Partition: toYYYYMM(snapshot_time)
| Column | 类型 | Sort Key |
|---|---|---|
| asset_idx | UInt16 | 是 |
| 区块号 | UInt64 | 是 |
| clearinghouse | UInt8 | 是 |
| 硬币 | String | 不 |
| entry_notional | UInt64 | 不 |
| funding_alltime | Int64 | 不 |
| funding_since_change | Int64 | 不 |
| funding_since_open | Int64 | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| 边距 | UInt64 | 不 |
| 大小 | Int64 | 不 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
| usdc_balance | Int64 | 不 |
| 用户 | String | 是 |
hyperliquid_quote_token_meta
Sort Keys: ⚡ block_number, token_idx | Partition: toYYYYMM(snapshot_time)
| Column | 类型 | Sort Key |
|---|---|---|
| aligned_quote_info_json | String | 不 |
| 区块号 | UInt64 | 是 |
| first_enabled_as_quote | String | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| is_liquid_base | UInt8 | 不 |
| is_liquid_quote | UInt8 | 不 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
| 状态 | LowCardinality(String) | 不 |
| token_idx | UInt64 | 是 |
| token_name | LowCardinality(String) | 不 |
hyperliquid_register_referral
Sort Keys: ⚡ referral_code, user | Partition: none
| Column | 类型 | Sort Key |
|---|---|---|
| block_time | DateTime64(6, 'UTC') | 不 |
| 错误 | Nullable(String) | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| is_success | UInt8 | 不 |
| referral_code | String | 是 |
| 圆 | UInt64 | 不 |
| tx_hash | String | 不 |
| 用户 | String | 是 |
hyperliquid_set_referrer
Sort Keys: ⚡ referral_code, user | Partition: none
| Column | 类型 | Sort Key |
|---|---|---|
| block_time | DateTime64(6, 'UTC') | 不 |
| 错误 | Nullable(String) | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| is_success | UInt8 | 不 |
| referral_code | String | 是 |
| 圆 | UInt64 | 不 |
| tx_hash | String | 不 |
| 用户 | String | 是 |
hyperliquid_spot_balances
Sort Keys: ⚡ block_number, user, token_idx | Partition: toYYYYMM(snapshot_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 是 |
| escrowed | Int64 | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
| token | String | 不 |
| token_idx | UInt16 | 是 |
| 总计 | Int64 | 不 |
| 用户 | String | 是 |
hyperliquid_spot_clearinghouse_states
Sort Keys: ⚡ block_number, user, token_idx | Partition: toYYYYMM(snapshot_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 是 |
| escrowed | Int64 | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
| token | LowCardinality(String) | 不 |
| token_idx | UInt16 | 是 |
| 总计 | Int64 | 不 |
| 用户 | FixedString(42) | 是 |
hyperliquid_spot_markets
Sort Keys: ⚡ token_index | Partition: none
| Column | 类型 | Sort Key |
|---|---|---|
| deployer_trading_fee_share | Nullable(String) | 不 |
| evm_contract | Nullable(String) | 不 |
| full_name | Nullable(String) | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| is_canonical | UInt8 | 不 |
| pair_index | Nullable(UInt16) | 不 |
| pair_name | Nullable(String) | 不 |
| sz_decimals | UInt8 | 不 |
| token | LowCardinality(String) | 不 |
| token_id | String | 不 |
| token_index | UInt16 | 是 |
| wei_decimals | UInt8 | 不 |
hyperliquid_spot_pairs
Sort Keys: ⚡ block_number, spot_index | Partition: toYYYYMM(snapshot_time)
| Column | 类型 | Sort Key |
|---|---|---|
| base_token_idx | UInt64 | 不 |
| base_token_name | LowCardinality(String) | 不 |
| 区块号 | UInt64 | 是 |
| deploy_time | String | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| pair_name | String | 不 |
| quote_token_idx | UInt64 | 不 |
| quote_token_name | LowCardinality(String) | 不 |
| raw_spot_info_json | String | 不 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
| spot_index | UInt64 | 是 |
hyperliquid_staking_events
Sort Keys: ⚡ block_number, hash | Partition: toYYYYMM(block_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 金额 | Decimal(38, 18) | 不 |
| 区块号 | UInt64 | 是 |
| block_time | DateTime64(6, 'UTC') | 不 |
| event_type | Enum8('CDeposit' = 1, 'CWithdrawal' = 2, 'Delegation' = 3) | 不 |
| 哈希 | FixedString(66) | 是 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| is_finalized | Nullable(UInt8) | 不 |
| is_undelegate | Nullable(UInt8) | 不 |
| 时间 | DateTime64(6, 'UTC') | 不 |
| 用户 | FixedString(42) | 不 |
| validator | Nullable(FixedString(42)) | 不 |
hyperliquid_sub_accounts
Sort Keys: ⚡ block_number, sub_account | Partition: toYYYYMM(snapshot_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 是 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| master_account | FixedString(42) | 不 |
| 名称 | Nullable(String) | 不 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
| sub_account | FixedString(42) | 是 |
hyperliquid_summaries
Sort Keys: ⚡ user, polled_at | Partition: toYYYYMM(polled_at)
| Column | 类型 | Sort Key |
|---|---|---|
| cross_maintenance_margin_used | Decimal(38, 18) | 不 |
| cross_margin_account_value | Decimal(38, 18) | 不 |
| cross_margin_total_margin_used | Decimal(38, 18) | 不 |
| cross_margin_total_natl_pos | Decimal(38, 18) | 不 |
| cross_margin_total_raw_usd | Decimal(38, 18) | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| margin_account_value | Decimal(38, 18) | 不 |
| margin_total_margin_used | Decimal(38, 18) | 不 |
| margin_total_natl_pos | Decimal(38, 18) | 不 |
| margin_total_raw_usd | Decimal(38, 18) | 不 |
| polled_at | DateTime64(3, 'UTC') | 是 |
| 用户 | String | 是 |
| withdrawable | Decimal(38, 18) | 不 |
hyperliquid_system_actions
Sort Keys: ⚡ block_number, evm_tx_hash, nonce | Partition: toYYYYMM(block_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 动作 | String | 不 |
| action_type | LowCardinality(String) | 不 |
| agent_address | Nullable(FixedString(42)) | 不 |
| agent_name | Nullable(String) | 不 |
| 区块号 | UInt64 | 是 |
| block_time | DateTime64(6, 'UTC') | 不 |
| destination | Nullable(FixedString(42)) | 不 |
| destination_dex_or_spot | Nullable(UInt8) | 不 |
| evm_tx_hash | FixedString(66) | 是 |
| from_sub_account | Nullable(UInt8) | 不 |
| hyperliquid_chain | Nullable(String) | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| is_mint | Nullable(UInt8) | 不 |
| is_undelegate | Nullable(UInt8) | 不 |
| 非重复值 | UInt64 | 是 |
| ntl | Nullable(Decimal(38, 18)) | 不 |
| order_grouping | Nullable(String) | 不 |
| signature_chain_id | Nullable(String) | 不 |
| source_dex_or_spot | Nullable(UInt8) | 不 |
| to_perp | Nullable(UInt8) | 不 |
| token | Nullable(UInt16) | 不 |
| 用户 | FixedString(42) | 不 |
| validator | Nullable(FixedString(42)) | 不 |
| wei | Nullable(UInt256) | 不 |
hyperliquid_token_usdc_prices
Sort Keys: ⚡ block_number, token_idx | Partition: toYYYYMM(snapshot_time)
| Column | 类型 | Sort Key |
|---|---|---|
| approx_usdc_px | Decimal(38, 18) | 不 |
| approx_usdc_px_float_1e6 | Float64 | 不 |
| approx_usdc_px_raw | UInt64 | 不 |
| 区块号 | UInt64 | 是 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| raw_pair_json | String | 不 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
| token_idx | UInt64 | 是 |
| token_name | LowCardinality(String) | 不 |
hyperliquid_交易
Sort Keys: ⚡ block_number, trade_id | Partition: toYYYYMM(block_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 是 |
| block_time | DateTime64(6, 'UTC') | 不 |
| buyer_address | FixedString(42) | 不 |
| buyer_builder_address | Nullable(FixedString(42)) | 不 |
| buyer_builder_fee | Nullable(Decimal(38, 18)) | 不 |
| buyer_closed_pnl | Decimal(38, 18) | 不 |
| buyer_crossed | UInt8 | 不 |
| buyer_deployer_fee | Nullable(Decimal(38, 18)) | 不 |
| buyer_dir | LowCardinality(String) | 不 |
| buyer_fee | Decimal(38, 18) | 不 |
| buyer_order_id | UInt64 | 不 |
| buyer_priority_gas | Nullable(Decimal(38, 18)) | 不 |
| buyer_start_position | Decimal(38, 18) | 不 |
| buyer_twap_id | Nullable(UInt64) | 不 |
| 硬币 | LowCardinality(String) | 不 |
| fee_token | LowCardinality(String) | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| liquidated_user | Nullable(FixedString(42)) | 不 |
| liquidation_mark_price | Nullable(Decimal(38, 18)) | 不 |
| liquidation_method | Nullable(String) | 不 |
| 价格 | Decimal(38, 18) | 不 |
| seller_address | FixedString(42) | 不 |
| seller_builder_address | Nullable(FixedString(42)) | 不 |
| seller_builder_fee | Nullable(Decimal(38, 18)) | 不 |
| seller_closed_pnl | Decimal(38, 18) | 不 |
| seller_crossed | UInt8 | 不 |
| seller_deployer_fee | Nullable(Decimal(38, 18)) | 不 |
| seller_dir | LowCardinality(String) | 不 |
| seller_fee | Decimal(38, 18) | 不 |
| seller_order_id | UInt64 | 不 |
| seller_priority_gas | Nullable(Decimal(38, 18)) | 不 |
| seller_start_position | Decimal(38, 18) | 不 |
| seller_twap_id | Nullable(UInt64) | 不 |
| side | Enum8('B' = 1, 'A' = 2) | 不 |
| 大小 | Decimal(38, 18) | 不 |
| 时间戳 | DateTime64(3, 'UTC') | 不 |
| total_builder_fee | Nullable(Decimal(38, 18)) | 不 |
| trade_id | UInt64 | 是 |
| 交易哈希 | FixedString(66) | 不 |
| unique_id | String | 不 |
hyperliquid_transactions
Sort Keys: ⚡ round, tx_hash, nonce | Partition: toYYYYMM(block_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 动作 | JSON | 不 |
| action_type | LowCardinality(String) | 不 |
| block_time | DateTime64(6, 'UTC') | 不 |
| 错误 | Nullable(String) | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| is_success | UInt8 | 不 |
| 非重复值 | UInt64 | 是 |
| 提案人 | Nullable(String) | 不 |
| 圆 | UInt64 | 是 |
| tx_hash | String | 是 |
| 用户 | Nullable(String) | 不 |
| vault_address | Nullable(String) | 不 |
hyperliquid_twap_statuses
Sort Keys: ⚡ block_number, twap_id, time | Partition: toYYYYMM(block_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 是 |
| block_time | DateTime64(6, 'UTC') | 不 |
| 硬币 | LowCardinality(String) | 不 |
| executed_ntl | Decimal(38, 18) | 不 |
| executed_size | Decimal(38, 18) | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| minutes | UInt16 | 不 |
| randomize | UInt8 | 不 |
| reduce_only | UInt8 | 不 |
| side | Enum8('B' = 1, 'A' = 2) | 不 |
| 大小 | Decimal(38, 18) | 不 |
| 状态 | LowCardinality(String) | 不 |
| 时间 | DateTime64(6, 'UTC') | 是 |
| 时间戳 | DateTime64(3, 'UTC') | 不 |
| twap_id | UInt64 | 是 |
| 用户 | FixedString(42) | 不 |
hyperliquid_validator_rewards
Sort Keys: ⚡ block_number, validator, time | Partition: toYYYYMM(block_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 是 |
| block_time | DateTime64(6, 'UTC') | 不 |
| 哈希 | FixedString(66) | 不 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| reward | Decimal(38, 18) | 不 |
| 时间 | DateTime64(6, 'UTC') | 是 |
| validator | FixedString(42) | 是 |
hyperliquid_vault_equities
Sort Keys: ⚡ block_number, vault_address, depositor | Partition: toYYYYMM(snapshot_time)
| Column | 类型 | Sort Key |
|---|---|---|
| 区块号 | UInt64 | 是 |
| depositor | FixedString(42) | 是 |
| indexed_at | DateTime64(3, 'UTC') | 不 |
| leader | FixedString(42) | 不 |
| leader_commission | Float64 | 不 |
| net_deposits | Int64 | 不 |
| ownership_fraction | Float64 | 不 |
| snapshot_time | DateTime64(6, 'UTC') | 不 |
| vault_address | FixedString(42) | 是 |
| vault_name | String | 不 |
All tables are optimized with sort keys (marked ⚡ in the schema browser) and partition monthly by toYYYYMM(block_time) for efficient time-bounded queries. Data ingestion is near real-time with queries scanning across billions of rows in seconds.
Accessing the Schema
The schema can be accessed as static downloadable files or via the API endpoint.
Downloadable Files
These files are updated periodically:
- JSON Format: hyperliquid_schema.json - Complete schema with all tables and columns
- Plain Text Format: hyperliquid_schema.txt - Formatted for LLM context windows
Schema API
Fetch the current schema with real-time row counts and latest table structures. See the REST API Overview for API authentication details.
Request (Hyperliquid):
curl https://api.quicknode.com/sql/rest/v1/schema/hyperliquid-core-mainnet \
-H "x-api-key: YOUR_API_KEY"
替换 hyperliquid-core-mainnet with the appropriate cluster ID for other supported chains.
示例回复：
[
{
"chain": "Hyperliquid (HyperCore)",
"clusterId": "hyperliquid-core-mainnet",
"tables": [
{
"name": "hyperliquid_agents",
"engine": "SharedReplacingMergeTree",
"totalRows": 55686595,
"sortingKey": ["block_number", "agent"],
"partitionKey": "toYYYYMM(snapshot_time)",
"columns": [
{
"name": "block_number",
"type": "UInt64"
},
{
"name": "snapshot_time",
"type": "DateTime64(6, 'UTC')"
},
{
"name": "agent",
"type": "FixedString(42)"
}
// ... more columns
]
}
// ... more tables
]
}
]
The response includes table names, engines, column names and data types, sort keys for optimization, partition strategies, and current row counts.
For AI Agents & LLMs
This schema is specifically formatted for programmatic consumption.
Build Web3 Plugin
For AI agents and LLM applications, install the Build Web3 plugin so your agent can build on SQL Explorer, with full knowledge of its schemas and of every other Quicknode product. In Claude Code:
/plugin marketplace add quicknode/agent-plugins
Using Schema in Your Agent
When building custom AI agents or LLM applications:
- Fetch the schema via the API endpoint above or download the plain text schema optimized for LLM context windows
- Include it in your prompt context when generating SQL queries
- Reference sort keys for optimal query performance
- Use partition keys to limit data scans
Example prompts for AI agents:
Example 1: Generate a SQL query to find the top 10 traders by volume in the last 24 hours.
Schema: [include JSON from schema API or plain text schema file]
Example 2: Create a query to analyze funding rate changes for the BTC perpetual market over the past week, grouped by hour.
Schema: [include JSON from schema API or plain text schema file]
Example 3: Write a SQL query to identify liquidation events larger than $100K in the last 30 days, showing the user, asset, and liquidation size.
Schema: [include JSON from schema API or plain text schema file]