Visão geral

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	Tipo	Sort Key
agent	FixedString(42)	Sim
block_number	UInt64	Sim
indexed_at	DateTime64(3, 'UTC')	Não
nome	String	Não
snapshot_time	DateTime64(6, 'UTC')	Não
user	FixedString(42)	Não
valid_until	String	Não

hyperliquid_asset_transfers

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

Column	Tipo	Sort Key
quantia	Nullable(Decimal(38, 18))	Não
block_number	UInt64	Sim
block_time	DateTime64(6, 'UTC')	Não
destination	Nullable(FixedString(42))	Não
fee	Nullable(Decimal(38, 18))	Não
indexed_at	DateTime64(3, 'UTC')	Não
nonce	Nullable(UInt64)	Não
hora	DateTime64(6, 'UTC')	Não
ficha	Nullable(String)	Não
transfer_type	LowCardinality(String)	Não
tx_hash	FixedString(66)	Sim
usdc_amount	Nullable(Decimal(38, 18))	Não
user	FixedString(42)	Sim

hyperliquid_blocks

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

Column	Tipo	Sort Key
block_number	UInt64	Sim
block_time	DateTime64(6, 'UTC')	Não
book_diffs_count	UInt32	Não
fills_count	UInt32	Não
indexed_at	DateTime64(3, 'UTC')	Não
misc_events_count	UInt32	Não
orders_count	UInt32	Não
twap_statuses_count	UInt32	Não
writer_actions_count	UInt32	Não

hyperliquid_bridge

Sort Keys: ⚡ block_number, bridge_type, user, nonce, eth_block_number, tx_hash | Partition: toYYYYMM(snapshot_time)

Column	Tipo	Sort Key
amount_wei	UInt64	Não
block_number	UInt64	Sim
bridge_type	LowCardinality(String)	Sim
eth_block_number	UInt64	Sim
event_time	String	Não
indexed_at	DateTime64(3, 'UTC')	Não
nonce	UInt64	Sim
snapshot_time	DateTime64(6, 'UTC')	Não
tx_hash	String	Sim
user	FixedString(42)	Sim

hyperliquid_builder_fills

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

Column	Tipo	Sort Key
block_number	UInt64	Não
block_time	DateTime64(6, 'UTC')	Não
builder_address	Nullable(FixedString(42))	Sim
builder_fee	Nullable(Decimal(38, 18))	Não
cloid	Nullable(String)	Não
closed_pnl	Decimal(38, 18)	Não
moeda	LowCardinality(String)	Não
created_at	DateTime64(6, 'UTC')	Não
crossed	UInt8	Não
dir	LowCardinality(String)	Não
fee	Decimal(38, 18)	Não
hash	FixedString(66)	Não
indexed_at	DateTime64(3, 'UTC')	Não
is_liquidation	UInt8	Não
liquidated_user	Nullable(FixedString(42))	Não
liquidation_mark_price	Nullable(Decimal(38, 18))	Não
liquidation_method	Nullable(String)	Não
oid	UInt64	Não
preço	Decimal(38, 18)	Não
lado	Enum8('B' = 1, 'A' = 2)	Não
tamanho	Decimal(38, 18)	Não
start_position	Decimal(38, 18)	Não
tid	UInt64	Sim
marca temporal	DateTime64(3, 'UTC')	Sim
twap_id	Nullable(UInt64)	Não
atualizado_em	DateTime64(6, 'UTC')	Não
user	FixedString(42)	Não

hyperliquid_builder_transactions

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

Column	Tipo	Sort Key
action_type	LowCardinality(String)	Não
block_number	UInt64	Sim
block_time	DateTime64(6, 'UTC')	Não
builder	String	Não
builder_fee	Nullable(Decimal(38, 18))	Não
moeda	Nullable(String)	Não
hash	String	Sim
indexed_at	DateTime64(3, 'UTC')	Não
is_success	UInt8	Não
user	String	Sim

hyperliquid_clearinghouse_states

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

Column	Tipo	Sort Key
asset_idx	UInt16	Sim
block_number	UInt64	Sim
clearinghouse	UInt8	Sim
moeda	LowCardinality(String)	Não
entry_notional	UInt64	Não
funding_alltime	Int64	Não
funding_since_change	Int64	Não
funding_since_open	Int64	Não
indexed_at	DateTime64(3, 'UTC')	Não
margin	UInt64	Não
tamanho	Int64	Não
snapshot_time	DateTime64(6, 'UTC')	Não
usdc_balance	Int64	Não
user	FixedString(42)	Sim

hyperliquid_delegator_rewards

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

Column	Tipo	Sort Key
block_number	UInt64	Sim
c	UInt64	Não
commission_bps	UInt16	Não
delegator	FixedString(42)	Sim
e	UInt64	Não
indexed_at	DateTime64(3, 'UTC')	Não
m	UInt64	Não
reward	Decimal(38, 8)	Não
reward_wei	UInt64	Não
snapshot_time	DateTime64(6, 'UTC')	Não
source	LowCardinality(String)	Não
validator	FixedString(42)	Sim
validator_total_delegated	UInt64	Não

hyperliquid_dex_trades

Sort Keys: ⚡ none | Partition: none

Column	Tipo	Sort Key
block_number	UInt64	Não
block_time	DateTime64(6, 'UTC')	Não
buyer_address	FixedString(42)	Não
buyer_builder_address	Nullable(FixedString(42))	Não
buyer_builder_fee	Nullable(Decimal(38, 18))	Não
buyer_closed_pnl	Decimal(38, 18)	Não
buyer_crossed	UInt8	Não
buyer_dir	LowCardinality(String)	Não
buyer_fee	Decimal(38, 18)	Não
buyer_order_id	UInt64	Não
buyer_start_position	Decimal(38, 18)	Não
buyer_twap_id	Nullable(UInt64)	Não
moeda	LowCardinality(String)	Não
fee_token	LowCardinality(String)	Não
indexed_at	DateTime64(3, 'UTC')	Não
liquidated_user	Nullable(FixedString(42))	Não
liquidation_mark_price	Nullable(Decimal(38, 18))	Não
liquidation_method	Nullable(String)	Não
market_type	String	Não
preço	Decimal(38, 18)	Não
seller_address	FixedString(42)	Não
seller_builder_address	Nullable(FixedString(42))	Não
seller_builder_fee	Nullable(Decimal(38, 18))	Não
seller_closed_pnl	Decimal(38, 18)	Não
seller_crossed	UInt8	Não
seller_dir	LowCardinality(String)	Não
seller_fee	Decimal(38, 18)	Não
seller_order_id	UInt64	Não
seller_start_position	Decimal(38, 18)	Não
seller_twap_id	Nullable(UInt64)	Não
lado	Enum8('B' = 1, 'A' = 2)	Não
tamanho	Decimal(38, 18)	Não
marca temporal	DateTime64(3, 'UTC')	Não
total_builder_fee	Nullable(Decimal(38, 18))	Não
trade_id	UInt64	Não
transaction_hash	FixedString(66)	Não
unique_id	String	Não
usd_amount	Decimal(38, 18)	Não

hyperliquid_display_names

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

Column	Tipo	Sort Key
block_number	UInt64	Sim
display_name	String	Não
indexed_at	DateTime64(3, 'UTC')	Não
snapshot_time	DateTime64(6, 'UTC')	Não
user	FixedString(42)	Sim

hyperliquid_fills

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

Column	Tipo	Sort Key
block_number	UInt64	Sim
block_time	DateTime64(6, 'UTC')	Não
builder	Nullable(FixedString(42))	Não
builder_fee	Nullable(Decimal(38, 18))	Não
cloid	Nullable(String)	Não
closed_pnl	Decimal(38, 18)	Não
moeda	LowCardinality(String)	Não
crossed	UInt8	Não
deployer_fee	Nullable(Decimal(38, 18))	Não
dir	LowCardinality(String)	Não
fee	Decimal(38, 18)	Não
fee_token	LowCardinality(String)	Não
hash	FixedString(66)	Não
indexed_at	DateTime64(3, 'UTC')	Não
is_liquidation	UInt8	Não
liquidated_user	Nullable(FixedString(42))	Não
liquidation_mark_price	Nullable(Decimal(38, 18))	Não
liquidation_method	Nullable(String)	Não
oid	UInt64	Não
preço	Decimal(38, 18)	Não
priority_gas	Nullable(Decimal(38, 18))	Não
lado	Enum8('B' = 1, 'A' = 2)	Não
tamanho	Decimal(38, 18)	Não
start_position	Decimal(38, 18)	Não
tid	UInt64	Sim
hora	DateTime64(3, 'UTC')	Não
twap_id	Nullable(UInt64)	Não
user	FixedString(42)	Sim

hyperliquid_funding

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

Column	Tipo	Sort Key
block_number	UInt64	Sim
block_time	DateTime64(6, 'UTC')	Não
moeda	LowCardinality(String)	Sim
funding_amount	Decimal(38, 18)	Não
funding_rate	Decimal(38, 18)	Não
hash	FixedString(66)	Não
indexed_at	DateTime64(3, 'UTC')	Não
szi	Decimal(38, 18)	Não
hora	DateTime64(6, 'UTC')	Sim
user	FixedString(42)	Sim

hyperliquid_funding_summary_hourly

Sort Keys: ⚡ coin, hour | Partition: toYYYYMM(hour)

Column	Tipo	Sort Key
avg_funding_rate	SimpleAggregateFunction(any, Float64)	Não
moeda	LowCardinality(String)	Sim
hour	DateTime('UTC')	Sim
total_funding	SimpleAggregateFunction(sum, Decimal(38, 18))	Não
unique_users	SimpleAggregateFunction(max, UInt64)	Não

hyperliquid_ledger_updates

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

Column	Tipo	Sort Key
account_value	Nullable(Decimal(38, 18))	Não
quantia	Nullable(Decimal(38, 18))	Não
basis	Nullable(Decimal(38, 18))	Não
block_number	UInt64	Sim
block_time	DateTime64(6, 'UTC')	Não
closing_cost	Nullable(Decimal(38, 18))	Não
commission	Nullable(Decimal(38, 18))	Não
delta_type	LowCardinality(String)	Não
destination	Nullable(FixedString(42))	Não
destination_dex	Nullable(String)	Não
dex	Nullable(String)	Não
fee	Nullable(Decimal(38, 18))	Não
fee_token	Nullable(String)	Não
hash	FixedString(66)	Sim
indexed_at	DateTime64(3, 'UTC')	Não
interest_amount	Nullable(Decimal(38, 18))	Não
is_deposit	Nullable(UInt8)	Não
leverage_type	Nullable(String)	Não
liquidated_ntl_pos	Nullable(Decimal(38, 18))	Não
liquidated_positions	Nullable(String)	Não
native_token_fee	Nullable(Decimal(38, 18))	Não
net_withdrawn_usd	Nullable(Decimal(38, 18))	Não
nonce	Nullable(UInt64)	Não
operation	Nullable(String)	Não
requested_usd	Nullable(Decimal(38, 18))	Não
secondary_user	Nullable(FixedString(42))	Não
source_dex	Nullable(String)	Não
hora	DateTime64(6, 'UTC')	Sim
to_perp	Nullable(UInt8)	Não
ficha	Nullable(String)	Não
usdc_amount	Nullable(Decimal(38, 18))	Não
usdc_value	Nullable(Decimal(38, 18))	Não
user	FixedString(42)	Sim
vault	Nullable(FixedString(42))	Não

hyperliquid_liquidations_hourly

Sort Keys: ⚡ hour, coin | Partition: toYYYYMM(hour)

Column	Tipo	Sort Key
moeda	LowCardinality(String)	Sim
hour	DateTime	Sim
liquidated_volume	SimpleAggregateFunction(sum, Decimal(38, 18))	Não
liquidation_count	SimpleAggregateFunction(sum, UInt64)	Não
unique_liquidated_users	SimpleAggregateFunction(max, UInt64)	Não

hyperliquid_market_volume_hourly

Sort Keys: ⚡ coin, hour | Partition: toYYYYMM(hour)

Column	Tipo	Sort Key
close	SimpleAggregateFunction(anyLast, Decimal(38, 18))	Não
moeda	LowCardinality(String)	Sim
high	SimpleAggregateFunction(max, Decimal(38, 18))	Não
hour	DateTime('UTC')	Sim
low	SimpleAggregateFunction(min, Decimal(38, 18))	Não
abrir	SimpleAggregateFunction(any, Decimal(38, 18))	Não
trade_count	SimpleAggregateFunction(sum, UInt64)	Não
volume	SimpleAggregateFunction(sum, Decimal(38, 18))	Não

hyperliquid_metrics_dex_overview

Sort Keys: ⚡ day, coin | Partition: toYYYYMM(day)

Column	Tipo	Sort Key
moeda	LowCardinality(String)	Sim
day	Date	Sim
taxas	SimpleAggregateFunction(sum, Decimal(38, 18))	Não
fill_count	SimpleAggregateFunction(sum, UInt64)	Não
high_price	SimpleAggregateFunction(max, Decimal(38, 18))	Não
liquidations	SimpleAggregateFunction(sum, UInt64)	Não
low_price	SimpleAggregateFunction(min, Decimal(38, 18))	Não
unique_traders	SimpleAggregateFunction(max, UInt64)	Não
volume_usd	SimpleAggregateFunction(sum, Decimal(38, 18))	Não

hyperliquid_metrics_overview

Sort Keys: ⚡ day | Partition: toYYYYMM(day)

Column	Tipo	Sort Key
active_traders	SimpleAggregateFunction(max, UInt64)	Não
builder_fill_count	SimpleAggregateFunction(sum, UInt64)	Não
coins_traded	SimpleAggregateFunction(max, UInt64)	Não
day	Date	Sim
liquidation_count	SimpleAggregateFunction(sum, UInt64)	Não
liquidation_volume_usd	SimpleAggregateFunction(sum, Decimal(38, 18))	Não
total_builder_fees	SimpleAggregateFunction(sum, Decimal(38, 18))	Não
total_fees	SimpleAggregateFunction(sum, Decimal(38, 18))	Não
total_fills	SimpleAggregateFunction(sum, UInt64)	Não
total_volume_usd	SimpleAggregateFunction(sum, Decimal(38, 18))	Não

hyperliquid_oracle_prices

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

Column	Tipo	Sort Key
asset_idx	UInt16	Sim
block_number	UInt64	Sim
clearinghouse	UInt8	Sim
moeda	LowCardinality(String)	Não
daily_px	String	Não
indexed_at	DateTime64(3, 'UTC')	Não
mark_px	String	Não
snapshot_time	DateTime64(6, 'UTC')	Não

hyperliquid_order_book_diffs

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

Column	Tipo	Sort Key
block_number	UInt64	Sim
block_time	DateTime64(6, 'UTC')	Não
moeda	LowCardinality(String)	Sim
diff_type	LowCardinality(String)	Não
indexed_at	DateTime64(3, 'UTC')	Não
new_size	Nullable(Decimal(38, 18))	Não
oid	UInt64	Sim
orig_size	Nullable(Decimal(38, 18))	Não
preço	Decimal(38, 18)	Não
lado	Enum8('B' = 1, 'A' = 2)	Sim
tamanho	Nullable(Decimal(38, 18))	Não
user	FixedString(42)	Não

hyperliquid_orders

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

Column	Tipo	Sort Key
block_number	UInt64	Sim
block_time	DateTime64(6, 'UTC')	Não
builder	Nullable(String)	Não
children	Nullable(String)	Não
cloid	Nullable(String)	Não
moeda	LowCardinality(String)	Não
hash	Nullable(FixedString(66))	Não
indexed_at	DateTime64(3, 'UTC')	Não
is_position_tpsl	UInt8	Não
is_trigger	UInt8	Não
limit_price	Decimal(38, 18)	Não
oid	UInt64	Sim
order_timestamp	DateTime64(3, 'UTC')	Não
order_type	LowCardinality(String)	Não
orig_size	Decimal(38, 18)	Não
reduce_only	UInt8	Não
lado	Enum8('B' = 1, 'A' = 2)	Não
tamanho	Decimal(38, 18)	Não
status	LowCardinality(String)	Não
status_time	DateTime64(6, 'UTC')	Sim
tif	LowCardinality(String)	Não
trigger_condition	Nullable(String)	Não
trigger_price	Nullable(Decimal(38, 18))	Não
unique_id	String	Não
user	FixedString(42)	Não

hyperliquid_outcome_markets

Sort Keys: ⚡ none | Partition: none

Column	Tipo	Sort Key
base_token_idx	Nullable(UInt64)	Não
block_number	UInt64	Não
moeda	Nullable(String)	Não
description	String	Não
expiry	String	Não
fee_share	Float64	Não
first_enabled_as_quote	String	Não
indexed_at	DateTime64(3, 'UTC')	Não
is_liquid_base	UInt8	Não
is_liquid_quote	UInt8	Não
locked	UInt8	Não
nome	LowCardinality(String)	Não
ndo	UInt64	Não
nou	UInt64	Não
nqu	UInt64	Não
outcome_class	LowCardinality(String)	Não
outcome_id	UInt64	Não
pair_name	String	Não
period	LowCardinality(String)	Não
quote_raw	Nullable(UInt64)	Não
quote_token_idx	Nullable(UInt64)	Não
quote_token_name	Nullable(String)	Não
quote_token_status	LowCardinality(String)	Não
quote_token_usdc_px	Decimal(38, 18)	Não
quote_token_usdc_px_raw	UInt64	Não
raw_side_json	String	Não
raw_spec_json	String	Não
side_count	UInt16	Não
side_index	UInt8	Não
side_name	LowCardinality(String)	Não
snapshot_time	DateTime64(6, 'UTC')	Não
spot_deploy_time	String	Não
spot_index	Nullable(UInt64)	Não
spot_resolution	LowCardinality(String)	Não
target_price	String	Não
token_idx	Nullable(UInt64)	Não
token_name	Nullable(String)	Não
underlying	LowCardinality(String)	Não

hyperliquid_outcome_meta

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

Column	Tipo	Sort Key
block_number	UInt64	Sim
deploy_gas_auction_json	String	Não
description	String	Não
expiry	String	Não
fee_share	Float64	Não
indexed_at	DateTime64(3, 'UTC')	Não
locked	UInt8	Não
nome	LowCardinality(String)	Não
ndo	UInt64	Não
nou	UInt64	Não
nqu	UInt64	Não
outcome_class	LowCardinality(String)	Não
outcome_id	UInt64	Sim
period	LowCardinality(String)	Não
quote_raw	Nullable(UInt64)	Não
raw_spec_json	String	Não
side_count	UInt16	Não
snapshot_time	DateTime64(6, 'UTC')	Não
target_price	String	Não
underlying	LowCardinality(String)	Não

hyperliquid_outcome_question_members

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

Column	Tipo	Sort Key
block_number	UInt64	Sim
indexed_at	DateTime64(3, 'UTC')	Não
is_fallback	UInt8	Não
is_settled	UInt8	Não
outcome_id	UInt64	Sim
question_id	UInt64	Sim
snapshot_time	DateTime64(6, 'UTC')	Não
source	LowCardinality(String)	Não

hyperliquid_outcome_questions

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

Column	Tipo	Sort Key
block_number	UInt64	Sim
description	String	Não
fallback_outcome	Nullable(UInt64)	Não
indexed_at	DateTime64(3, 'UTC')	Não
nome	String	Não
named_outcomes_json	String	Não
question_id	UInt64	Sim
raw_question_json	String	Não
settled_named_outcomes_json	String	Não
snapshot_time	DateTime64(6, 'UTC')	Não

hyperliquid_outcome_sides

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

Column	Tipo	Sort Key
base_token_idx	Nullable(UInt64)	Não
block_number	UInt64	Sim
moeda	Nullable(String)	Não
indexed_at	DateTime64(3, 'UTC')	Não
outcome_id	UInt64	Sim
quote_token_idx	Nullable(UInt64)	Não
quote_token_name	Nullable(String)	Não
raw_side_json	String	Não
side_index	UInt8	Sim
side_m_raw	String	Não
side_m_value	Nullable(Int64)	Não
side_name	LowCardinality(String)	Não
snapshot_time	DateTime64(6, 'UTC')	Não
spot_index	Nullable(UInt64)	Não
spot_indices_json	String	Não
spot_resolution	LowCardinality(String)	Não
token_idx	Nullable(UInt64)	Não
token_name	Nullable(String)	Não

hyperliquid_perpetual_market_contexts

Sort Keys: ⚡ none | Partition: none

Column	Tipo	Sort Key
moeda	LowCardinality(String)	Não
day_base_vlm	Decimal(38, 18)	Não
day_ntl_vlm	Decimal(38, 18)	Não
funding	Decimal(38, 18)	Não
impact_ask	Nullable(Decimal(38, 18))	Não
impact_bid	Nullable(Decimal(38, 18))	Não
mark_px	Decimal(38, 18)	Não
mid_px	Decimal(38, 18)	Não
open_interest	Decimal(38, 18)	Não
oracle_px	Decimal(38, 18)	Não
polled_at	DateTime64(6, 'UTC')	Não
premium	Decimal(38, 18)	Não
prev_day_px	Decimal(38, 18)	Não

hyperliquid_perpetual_markets

Sort Keys: ⚡ coin | Partition: none

Column	Tipo	Sort Key
moeda	LowCardinality(String)	Sim
indexed_at	DateTime64(3, 'UTC')	Não
margin_table_id	Nullable(UInt16)	Não
market_index	UInt16	Não
max_leverage	UInt16	Não
only_isolated	UInt8	Não
sz_decimals	UInt8	Não

hyperliquid_perpetual_positions

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

Column	Tipo	Sort Key
asset_idx	UInt16	Sim
block_number	UInt64	Sim
clearinghouse	UInt8	Sim
moeda	String	Não
entry_notional	UInt64	Não
funding_alltime	Int64	Não
funding_since_change	Int64	Não
funding_since_open	Int64	Não
indexed_at	DateTime64(3, 'UTC')	Não
margin	UInt64	Não
tamanho	Int64	Não
snapshot_time	DateTime64(6, 'UTC')	Não
usdc_balance	Int64	Não
user	String	Sim

hyperliquid_quote_token_meta

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

Column	Tipo	Sort Key
aligned_quote_info_json	String	Não
block_number	UInt64	Sim
first_enabled_as_quote	String	Não
indexed_at	DateTime64(3, 'UTC')	Não
is_liquid_base	UInt8	Não
is_liquid_quote	UInt8	Não
snapshot_time	DateTime64(6, 'UTC')	Não
status	LowCardinality(String)	Não
token_idx	UInt64	Sim
token_name	LowCardinality(String)	Não

hyperliquid_register_referral

Sort Keys: ⚡ referral_code, user | Partition: none

Column	Tipo	Sort Key
block_time	DateTime64(6, 'UTC')	Não
erro	Nullable(String)	Não
indexed_at	DateTime64(3, 'UTC')	Não
is_success	UInt8	Não
referral_code	String	Sim
round	UInt64	Não
tx_hash	String	Não
user	String	Sim

hyperliquid_set_referrer

Sort Keys: ⚡ referral_code, user | Partition: none

Column	Tipo	Sort Key
block_time	DateTime64(6, 'UTC')	Não
erro	Nullable(String)	Não
indexed_at	DateTime64(3, 'UTC')	Não
is_success	UInt8	Não
referral_code	String	Sim
round	UInt64	Não
tx_hash	String	Não
user	String	Sim

hyperliquid_spot_balances

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

Column	Tipo	Sort Key
block_number	UInt64	Sim
escrowed	Int64	Não
indexed_at	DateTime64(3, 'UTC')	Não
snapshot_time	DateTime64(6, 'UTC')	Não
ficha	String	Não
token_idx	UInt16	Sim
total	Int64	Não
user	String	Sim

hyperliquid_spot_clearinghouse_states

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

Column	Tipo	Sort Key
block_number	UInt64	Sim
escrowed	Int64	Não
indexed_at	DateTime64(3, 'UTC')	Não
snapshot_time	DateTime64(6, 'UTC')	Não
ficha	LowCardinality(String)	Não
token_idx	UInt16	Sim
total	Int64	Não
user	FixedString(42)	Sim

hyperliquid_spot_markets

Sort Keys: ⚡ token_index | Partition: none

Column	Tipo	Sort Key
deployer_trading_fee_share	Nullable(String)	Não
evm_contract	Nullable(String)	Não
full_name	Nullable(String)	Não
indexed_at	DateTime64(3, 'UTC')	Não
is_canonical	UInt8	Não
pair_index	Nullable(UInt16)	Não
pair_name	Nullable(String)	Não
sz_decimals	UInt8	Não
ficha	LowCardinality(String)	Não
token_id	String	Não
token_index	UInt16	Sim
wei_decimals	UInt8	Não

hyperliquid_spot_pairs

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

Column	Tipo	Sort Key
base_token_idx	UInt64	Não
base_token_name	LowCardinality(String)	Não
block_number	UInt64	Sim
deploy_time	String	Não
indexed_at	DateTime64(3, 'UTC')	Não
pair_name	String	Não
quote_token_idx	UInt64	Não
quote_token_name	LowCardinality(String)	Não
raw_spot_info_json	String	Não
snapshot_time	DateTime64(6, 'UTC')	Não
spot_index	UInt64	Sim

hyperliquid_staking_events

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

Column	Tipo	Sort Key
quantia	Decimal(38, 18)	Não
block_number	UInt64	Sim
block_time	DateTime64(6, 'UTC')	Não
event_type	Enum8('CDeposit' = 1, 'CWithdrawal' = 2, 'Delegation' = 3)	Não
hash	FixedString(66)	Sim
indexed_at	DateTime64(3, 'UTC')	Não
is_finalized	Nullable(UInt8)	Não
is_undelegate	Nullable(UInt8)	Não
hora	DateTime64(6, 'UTC')	Não
user	FixedString(42)	Não
validator	Nullable(FixedString(42))	Não

hyperliquid_sub_accounts

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

Column	Tipo	Sort Key
block_number	UInt64	Sim
indexed_at	DateTime64(3, 'UTC')	Não
master_account	FixedString(42)	Não
nome	Nullable(String)	Não
snapshot_time	DateTime64(6, 'UTC')	Não
sub_account	FixedString(42)	Sim

hyperliquid_summaries

Sort Keys: ⚡ user, polled_at | Partition: toYYYYMM(polled_at)

Column	Tipo	Sort Key
cross_maintenance_margin_used	Decimal(38, 18)	Não
cross_margin_account_value	Decimal(38, 18)	Não
cross_margin_total_margin_used	Decimal(38, 18)	Não
cross_margin_total_natl_pos	Decimal(38, 18)	Não
cross_margin_total_raw_usd	Decimal(38, 18)	Não
indexed_at	DateTime64(3, 'UTC')	Não
margin_account_value	Decimal(38, 18)	Não
margin_total_margin_used	Decimal(38, 18)	Não
margin_total_natl_pos	Decimal(38, 18)	Não
margin_total_raw_usd	Decimal(38, 18)	Não
polled_at	DateTime64(3, 'UTC')	Sim
user	String	Sim
withdrawable	Decimal(38, 18)	Não

hyperliquid_system_actions

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

Column	Tipo	Sort Key
action	String	Não
action_type	LowCardinality(String)	Não
agent_address	Nullable(FixedString(42))	Não
agent_name	Nullable(String)	Não
block_number	UInt64	Sim
block_time	DateTime64(6, 'UTC')	Não
destination	Nullable(FixedString(42))	Não
destination_dex_or_spot	Nullable(UInt8)	Não
evm_tx_hash	FixedString(66)	Sim
from_sub_account	Nullable(UInt8)	Não
hyperliquid_chain	Nullable(String)	Não
indexed_at	DateTime64(3, 'UTC')	Não
is_mint	Nullable(UInt8)	Não
is_undelegate	Nullable(UInt8)	Não
nonce	UInt64	Sim
ntl	Nullable(Decimal(38, 18))	Não
order_grouping	Nullable(String)	Não
signature_chain_id	Nullable(String)	Não
source_dex_or_spot	Nullable(UInt8)	Não
to_perp	Nullable(UInt8)	Não
ficha	Nullable(UInt16)	Não
user	FixedString(42)	Não
validator	Nullable(FixedString(42))	Não
wei	Nullable(UInt256)	Não

hyperliquid_token_usdc_prices

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

Column	Tipo	Sort Key
approx_usdc_px	Decimal(38, 18)	Não
approx_usdc_px_float_1e6	Float64	Não
approx_usdc_px_raw	UInt64	Não
block_number	UInt64	Sim
indexed_at	DateTime64(3, 'UTC')	Não
raw_pair_json	String	Não
snapshot_time	DateTime64(6, 'UTC')	Não
token_idx	UInt64	Sim
token_name	LowCardinality(String)	Não

hyperliquid_trades

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

Column	Tipo	Sort Key
block_number	UInt64	Sim
block_time	DateTime64(6, 'UTC')	Não
buyer_address	FixedString(42)	Não
buyer_builder_address	Nullable(FixedString(42))	Não
buyer_builder_fee	Nullable(Decimal(38, 18))	Não
buyer_closed_pnl	Decimal(38, 18)	Não
buyer_crossed	UInt8	Não
buyer_deployer_fee	Nullable(Decimal(38, 18))	Não
buyer_dir	LowCardinality(String)	Não
buyer_fee	Decimal(38, 18)	Não
buyer_order_id	UInt64	Não
buyer_priority_gas	Nullable(Decimal(38, 18))	Não
buyer_start_position	Decimal(38, 18)	Não
buyer_twap_id	Nullable(UInt64)	Não
moeda	LowCardinality(String)	Não
fee_token	LowCardinality(String)	Não
indexed_at	DateTime64(3, 'UTC')	Não
liquidated_user	Nullable(FixedString(42))	Não
liquidation_mark_price	Nullable(Decimal(38, 18))	Não
liquidation_method	Nullable(String)	Não
preço	Decimal(38, 18)	Não
seller_address	FixedString(42)	Não
seller_builder_address	Nullable(FixedString(42))	Não
seller_builder_fee	Nullable(Decimal(38, 18))	Não
seller_closed_pnl	Decimal(38, 18)	Não
seller_crossed	UInt8	Não
seller_deployer_fee	Nullable(Decimal(38, 18))	Não
seller_dir	LowCardinality(String)	Não
seller_fee	Decimal(38, 18)	Não
seller_order_id	UInt64	Não
seller_priority_gas	Nullable(Decimal(38, 18))	Não
seller_start_position	Decimal(38, 18)	Não
seller_twap_id	Nullable(UInt64)	Não
lado	Enum8('B' = 1, 'A' = 2)	Não
tamanho	Decimal(38, 18)	Não
marca temporal	DateTime64(3, 'UTC')	Não
total_builder_fee	Nullable(Decimal(38, 18))	Não
trade_id	UInt64	Sim
transaction_hash	FixedString(66)	Não
unique_id	String	Não

hyperliquid_transactions

Sort Keys: ⚡ round, tx_hash, nonce | Partition: toYYYYMM(block_time)

Column	Tipo	Sort Key
action	JSON	Não
action_type	LowCardinality(String)	Não
block_time	DateTime64(6, 'UTC')	Não
erro	Nullable(String)	Não
indexed_at	DateTime64(3, 'UTC')	Não
is_success	UInt8	Não
nonce	UInt64	Sim
proposer	Nullable(String)	Não
round	UInt64	Sim
tx_hash	String	Sim
user	Nullable(String)	Não
vault_address	Nullable(String)	Não

hyperliquid_twap_statuses

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

Column	Tipo	Sort Key
block_number	UInt64	Sim
block_time	DateTime64(6, 'UTC')	Não
moeda	LowCardinality(String)	Não
executed_ntl	Decimal(38, 18)	Não
executed_size	Decimal(38, 18)	Não
indexed_at	DateTime64(3, 'UTC')	Não
minutes	UInt16	Não
randomize	UInt8	Não
reduce_only	UInt8	Não
lado	Enum8('B' = 1, 'A' = 2)	Não
tamanho	Decimal(38, 18)	Não
status	LowCardinality(String)	Não
hora	DateTime64(6, 'UTC')	Sim
marca temporal	DateTime64(3, 'UTC')	Não
twap_id	UInt64	Sim
user	FixedString(42)	Não

hyperliquid_validator_rewards

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

Column	Tipo	Sort Key
block_number	UInt64	Sim
block_time	DateTime64(6, 'UTC')	Não
hash	FixedString(66)	Não
indexed_at	DateTime64(3, 'UTC')	Não
reward	Decimal(38, 18)	Não
hora	DateTime64(6, 'UTC')	Sim
validator	FixedString(42)	Sim

hyperliquid_vault_equities

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

Column	Tipo	Sort Key
block_number	UInt64	Sim
depositor	FixedString(42)	Sim
indexed_at	DateTime64(3, 'UTC')	Não
leader	FixedString(42)	Não
leader_commission	Float64	Não
net_deposits	Int64	Não
ownership_fraction	Float64	Não
snapshot_time	DateTime64(6, 'UTC')	Não
vault_address	FixedString(42)	Sim
vault_name	String	Não

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"

Replace 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.

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:

1. Fetch the schema via the API endpoint above or download the plain text schema optimized for LLM context windows
2. Include it in your prompt context when generating SQL queries
3. Reference sort keys for optimal query performance
4. 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]