Schema Reference

개요

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.

하이퍼리퀴드 (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)	네
block_number	UInt64	네
indexed_at	DateTime64(3, 'UTC')	아니요
이름	문자열	아니요
snapshot_time	DateTime64(6, 'UTC')	아니요
사용자	FixedString(42)	아니요
valid_until	문자열	아니요

hyperliquid_asset_transfers

Sort Keys: ⚡ block_number, tx_hash, user | Partition: toYYYYMM(block_time)

Column	유형	Sort Key
금액	Nullable(Decimal(38, 18))	아니요
block_number	UInt64	네
block_time	DateTime64(6, 'UTC')	아니요
destination	Nullable(FixedString(42))	아니요
수수료	Nullable(Decimal(38, 18))	아니요
indexed_at	DateTime64(3, 'UTC')	아니요
논스	Nullable(UInt64)	아니요
시간	DateTime64(6, 'UTC')	아니요
토큰	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
block_number	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	아니요
block_number	UInt64	네
bridge_type	LowCardinality(String)	네
eth_block_number	UInt64	네
event_time	문자열	아니요
indexed_at	DateTime64(3, 'UTC')	아니요
논스	UInt64	네
snapshot_time	DateTime64(6, 'UTC')	아니요
tx_hash	문자열	네
사용자	FixedString(42)	네

hyperliquid_builder_fills

Sort Keys: ⚡ builder_address, timestamp, tid | Partition: toYYYYMM(block_time)

Column	유형	Sort Key
block_number	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)	아니요
측면	Enum8('B' = 1, 'A' = 2)	아니요
크기	Decimal(38, 18)	아니요
start_position	Decimal(38, 18)	아니요
tid	UInt64	네
타임스탬프	DateTime64(3, 'UTC')	네
twap_id	Nullable(UInt64)	아니요
updated_at	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)	아니요
block_number	UInt64	네
block_time	DateTime64(6, 'UTC')	아니요
builder	문자열	아니요
builder_fee	Nullable(Decimal(38, 18))	아니요
동전	Nullable(String)	아니요
해시	문자열	네
indexed_at	DateTime64(3, 'UTC')	아니요
is_success	UInt8	아니요
사용자	문자열	네

hyperliquid_clearinghouse_states

Sort Keys: ⚡ block_number, clearinghouse, user, asset_idx | Partition: toYYYYMM(snapshot_time)

Column	유형	Sort Key
asset_idx	UInt16	네
block_number	UInt64	네
clearinghouse	UInt8	네
동전	LowCardinality(String)	아니요
entry_notional	UInt64	아니요
funding_alltime	Int64	아니요
funding_since_change	Int64	아니요
funding_since_open	Int64	아니요
indexed_at	DateTime64(3, 'UTC')	아니요
margin	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
block_number	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)	아니요
검증기	FixedString(42)	네
validator_total_delegated	UInt64	아니요

hyperliquid_dex_trades

Sort Keys: ⚡ none | Partition: none

Column	유형	Sort Key
block_number	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	문자열	아니요
가격	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)	아니요
측면	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	문자열	아니요
usd_amount	Decimal(38, 18)	아니요

hyperliquid_display_names

Sort Keys: ⚡ block_number, user | Partition: toYYYYMM(snapshot_time)

Column	유형	Sort Key
block_number	UInt64	네
display_name	문자열	아니요
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
block_number	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))	아니요
측면	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
block_number	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))	아니요
block_number	UInt64	네
block_time	DateTime64(6, 'UTC')	아니요
closing_cost	Nullable(Decimal(38, 18))	아니요
commission	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)	아니요
토큰	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)	아니요
volume	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	네
block_number	UInt64	네
clearinghouse	UInt8	네
동전	LowCardinality(String)	아니요
daily_px	문자열	아니요
indexed_at	DateTime64(3, 'UTC')	아니요
mark_px	문자열	아니요
snapshot_time	DateTime64(6, 'UTC')	아니요

hyperliquid_order_book_diffs

Sort Keys: ⚡ coin, side, block_number, oid | Partition: toYYYYMM(block_time)

Column	유형	Sort Key
block_number	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)	아니요
측면	Enum8('B' = 1, 'A' = 2)	네
크기	Nullable(Decimal(38, 18))	아니요
사용자	FixedString(42)	아니요

hyperliquid_orders

Sort Keys: ⚡ block_number, oid, status_time | Partition: toYYYYMM(block_time)

Column	유형	Sort Key
block_number	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')	아니요
order_type	LowCardinality(String)	아니요
orig_size	Decimal(38, 18)	아니요
reduce_only	UInt8	아니요
측면	Enum8('B' = 1, 'A' = 2)	아니요
크기	Decimal(38, 18)	아니요
상태	LowCardinality(String)	아니요
status_time	DateTime64(6, 'UTC')	네
tif	LowCardinality(String)	아니요
trigger_condition	Nullable(String)	아니요
trigger_price	Nullable(Decimal(38, 18))	아니요
unique_id	문자열	아니요
사용자	FixedString(42)	아니요

초유동성_결과_시장

Sort Keys: ⚡ none | Partition: none

Column	유형	Sort Key
base_token_idx	Nullable(UInt64)	아니요
block_number	UInt64	아니요
동전	Nullable(String)	아니요
설명	문자열	아니요
expiry	문자열	아니요
fee_share	Float64	아니요
first_enabled_as_quote	문자열	아니요
indexed_at	DateTime64(3, 'UTC')	아니요
is_liquid_base	UInt8	아니요
is_liquid_quote	UInt8	아니요
잠김	UInt8	아니요
이름	LowCardinality(String)	아니요
ndo	UInt64	아니요
nou	UInt64	아니요
nqu	UInt64	아니요
outcome_class	LowCardinality(String)	아니요
outcome_id	UInt64	아니요
pair_name	문자열	아니요
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	문자열	아니요
raw_spec_json	문자열	아니요
side_count	UInt16	아니요
side_index	UInt8	아니요
side_name	LowCardinality(String)	아니요
snapshot_time	DateTime64(6, 'UTC')	아니요
spot_deploy_time	문자열	아니요
spot_index	Nullable(UInt64)	아니요
spot_resolution	LowCardinality(String)	아니요
target_price	문자열	아니요
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
block_number	UInt64	네
deploy_gas_auction_json	문자열	아니요
설명	문자열	아니요
expiry	문자열	아니요
fee_share	Float64	아니요
indexed_at	DateTime64(3, 'UTC')	아니요
잠김	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	문자열	아니요
side_count	UInt16	아니요
snapshot_time	DateTime64(6, 'UTC')	아니요
target_price	문자열	아니요
underlying	LowCardinality(String)	아니요

hyperliquid_outcome_question_members

Sort Keys: ⚡ block_number, question_id, outcome_id | Partition: toYYYYMM(snapshot_time)

Column	유형	Sort Key
block_number	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
block_number	UInt64	네
설명	문자열	아니요
fallback_outcome	Nullable(UInt64)	아니요
indexed_at	DateTime64(3, 'UTC')	아니요
이름	문자열	아니요
named_outcomes_json	문자열	아니요
question_id	UInt64	네
raw_question_json	문자열	아니요
settled_named_outcomes_json	문자열	아니요
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)	아니요
block_number	UInt64	네
동전	Nullable(String)	아니요
indexed_at	DateTime64(3, 'UTC')	아니요
outcome_id	UInt64	네
quote_token_idx	Nullable(UInt64)	아니요
quote_token_name	Nullable(String)	아니요
raw_side_json	문자열	아니요
side_index	UInt8	네
side_m_raw	문자열	아니요
side_m_value	Nullable(Int64)	아니요
side_name	LowCardinality(String)	아니요
snapshot_time	DateTime64(6, 'UTC')	아니요
spot_index	Nullable(UInt64)	아니요
spot_indices_json	문자열	아니요
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	네
block_number	UInt64	네
clearinghouse	UInt8	네
동전	문자열	아니요
entry_notional	UInt64	아니요
funding_alltime	Int64	아니요
funding_since_change	Int64	아니요
funding_since_open	Int64	아니요
indexed_at	DateTime64(3, 'UTC')	아니요
margin	UInt64	아니요
크기	Int64	아니요
snapshot_time	DateTime64(6, 'UTC')	아니요
usdc_balance	Int64	아니요
사용자	문자열	네

hyperliquid_quote_token_meta

Sort Keys: ⚡ block_number, token_idx | Partition: toYYYYMM(snapshot_time)

Column	유형	Sort Key
aligned_quote_info_json	문자열	아니요
block_number	UInt64	네
first_enabled_as_quote	문자열	아니요
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	문자열	네
둥근	UInt64	아니요
tx_hash	문자열	아니요
사용자	문자열	네

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	문자열	네
둥근	UInt64	아니요
tx_hash	문자열	아니요
사용자	문자열	네

hyperliquid_spot_balances

Sort Keys: ⚡ block_number, user, token_idx | Partition: toYYYYMM(snapshot_time)

Column	유형	Sort Key
block_number	UInt64	네
escrowed	Int64	아니요
indexed_at	DateTime64(3, 'UTC')	아니요
snapshot_time	DateTime64(6, 'UTC')	아니요
토큰	문자열	아니요
token_idx	UInt16	네
합계	Int64	아니요
사용자	문자열	네

hyperliquid_spot_clearinghouse_states

Sort Keys: ⚡ block_number, user, token_idx | Partition: toYYYYMM(snapshot_time)

Column	유형	Sort Key
block_number	UInt64	네
escrowed	Int64	아니요
indexed_at	DateTime64(3, 'UTC')	아니요
snapshot_time	DateTime64(6, 'UTC')	아니요
토큰	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	아니요
토큰	LowCardinality(String)	아니요
token_id	문자열	아니요
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)	아니요
block_number	UInt64	네
deploy_time	문자열	아니요
indexed_at	DateTime64(3, 'UTC')	아니요
pair_name	문자열	아니요
quote_token_idx	UInt64	아니요
quote_token_name	LowCardinality(String)	아니요
raw_spot_info_json	문자열	아니요
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)	아니요
block_number	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)	아니요
검증기	Nullable(FixedString(42))	아니요

hyperliquid_sub_accounts

Sort Keys: ⚡ block_number, sub_account | Partition: toYYYYMM(snapshot_time)

Column	유형	Sort Key
block_number	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')	네
사용자	문자열	네
withdrawable	Decimal(38, 18)	아니요

hyperliquid_system_actions

Sort Keys: ⚡ block_number, evm_tx_hash, nonce | Partition: toYYYYMM(block_time)

Column	유형	Sort Key
액션	문자열	아니요
action_type	LowCardinality(String)	아니요
agent_address	Nullable(FixedString(42))	아니요
agent_name	Nullable(String)	아니요
block_number	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)	아니요
토큰	Nullable(UInt16)	아니요
사용자	FixedString(42)	아니요
검증기	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	아니요
block_number	UInt64	네
indexed_at	DateTime64(3, 'UTC')	아니요
raw_pair_json	문자열	아니요
snapshot_time	DateTime64(6, 'UTC')	아니요
token_idx	UInt64	네
token_name	LowCardinality(String)	아니요

hyperliquid_trades

Sort Keys: ⚡ block_number, trade_id | Partition: toYYYYMM(block_time)

Column	유형	Sort Key
block_number	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)	아니요
측면	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	문자열	아니요

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	문자열	네
사용자	Nullable(String)	아니요
vault_address	Nullable(String)	아니요

hyperliquid_twap_statuses

Sort Keys: ⚡ block_number, twap_id, time | Partition: toYYYYMM(block_time)

Column	유형	Sort Key
block_number	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	아니요
측면	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
block_number	UInt64	네
block_time	DateTime64(6, 'UTC')	아니요
해시	FixedString(66)	아니요
indexed_at	DateTime64(3, 'UTC')	아니요
reward	Decimal(38, 18)	아니요
시간	DateTime64(6, 'UTC')	네
검증기	FixedString(42)	네

hyperliquid_vault_equities

Sort Keys: ⚡ block_number, vault_address, depositor | Partition: toYYYYMM(snapshot_time)

Column	유형	Sort Key
block_number	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	문자열	아니요

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.

Example Response:

[
  {
    "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.

Quicknode Skill

For AI agents and LLM applications, install the Quicknode Skill to give your agent full knowledge of SQL Explorer and all Quicknode products:

npx skills add quiknode-labs/blockchain-skills

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]

여러분의 피드백을 ❤️ 환영합니다!

이 문서에 대한 의견이나 질문이 있으시면 언제든지 알려주세요. 여러분의 의견을 기다리고 있습니다!

개요​

하이퍼리퀴드 (HyperCore)​

How to Use This Reference​

hyperliquid_agents

hyperliquid_asset_transfers

hyperliquid_blocks

hyperliquid_bridge

hyperliquid_builder_fills

hyperliquid_builder_transactions

hyperliquid_clearinghouse_states

hyperliquid_delegator_rewards

hyperliquid_dex_trades

hyperliquid_display_names

hyperliquid_fills

hyperliquid_funding

hyperliquid_funding_summary_hourly

hyperliquid_ledger_updates

hyperliquid_liquidations_hourly

hyperliquid_market_volume_hourly

hyperliquid_metrics_dex_overview

hyperliquid_metrics_overview

hyperliquid_oracle_prices

hyperliquid_order_book_diffs

hyperliquid_orders

초유동성_결과_시장

hyperliquid_outcome_meta

hyperliquid_outcome_question_members

hyperliquid_outcome_questions

hyperliquid_outcome_sides

hyperliquid_perpetual_market_contexts

hyperliquid_perpetual_markets

hyperliquid_perpetual_positions

hyperliquid_quote_token_meta

hyperliquid_register_referral

hyperliquid_set_referrer

hyperliquid_spot_balances

hyperliquid_spot_clearinghouse_states

hyperliquid_spot_markets

hyperliquid_spot_pairs

hyperliquid_staking_events

hyperliquid_sub_accounts

hyperliquid_summaries

hyperliquid_system_actions

hyperliquid_token_usdc_prices

hyperliquid_trades

hyperliquid_transactions

hyperliquid_twap_statuses

hyperliquid_validator_rewards

hyperliquid_vault_equities

Accessing the Schema​

Downloadable Files​

Schema API​

For AI Agents & LLMs​

Quicknode Skill​

Using Schema in Your Agent​

여러분의 피드백을 ❤️ 환영합니다!​

개요

하이퍼리퀴드 (HyperCore)

How to Use This Reference

Accessing the Schema

Downloadable Files

Schema API

For AI Agents & LLMs

Quicknode Skill

Using Schema in Your Agent

여러분의 피드백을 ❤️ 환영합니다!