Overview
This page documents all pre-built SQL queries available for Hyperliquid HyperCore data analysis through the SQL Explorer REST API. These queries cover trading activity, market analysis, position tracking, infrastructure monitoring, portfolio management, and platform analytics.
All queries use the same endpoint and authentication method:
- Endpoint:
POST https://api.quicknode.com/sql/rest/v1/query - Authentication: Include your API key in the
x-api-keyheader - Cluster ID:
hyperliquid-core-mainnet
See the Schema Reference for complete table and column documentation to build your own SQL queries.
Trading Queries
Query individual trades and trading volume data from Hyperliquid.
Recent Trades
Last 100 trades with buyer/seller details.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT timestamp, coin, side, price, size, price * size AS notional_usd, buyer_address, seller_address, buyer_fee, seller_fee, fee_token FROM hyperliquid_trades WHERE block_time > now() - INTERVAL 1 HOUR ORDER BY block_number DESC, trade_id DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"timestamp": "2026-03-25 10:45:23.000",
"coin": "BTC",
"side": "B",
"price": "95432.500000000000000000",
"size": "0.150000000000000000",
"notional_usd": "14314.875000000000000000000000000000000000",
"buyer_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"seller_address": "0x8dF3aad3a84da6b69A4DA8aeC3eA40d9091B2Ac",
"buyer_fee": "7.156437500000000000",
"seller_fee": "7.156437500000000000",
"fee_token": "USDC"
},
{
"timestamp": "2026-03-25 10:45:18.000",
"coin": "ETH",
"side": "A",
"price": "3245.750000000000000000",
"size": "2.500000000000000000",
"notional_usd": "8114.375000000000000000000000000000000000",
"buyer_address": "0x1a2B3c4D5e6F7a8b9C0d1E2f3A4b5C6d7E8f9A0",
"seller_address": "0x9f8e7D6c5B4a3F2e1D0c9B8a7F6e5D4c3B2a1F0",
"buyer_fee": "4.057187500000000000",
"seller_fee": "4.057187500000000000",
"fee_token": "USDC"
},
{
"timestamp": "2026-03-25 10:45:12.000",
"coin": "SOL",
"side": "B",
"price": "142.350000000000000000",
"size": "50.000000000000000000",
"notional_usd": "7117.500000000000000000000000000000000000",
"buyer_address": "0x5a6B7c8D9e0F1a2b3C4d5E6f7A8b9C0d1E2f3A4",
"seller_address": "0x4f3E2d1C0b9A8f7E6d5C4b3A2f1E0d9C8b7A6f5",
"buyer_fee": "3.558750000000000000",
"seller_fee": "3.558750000000000000",
"fee_token": "USDC"
}
],
"meta": [
{"name": "timestamp", "type": "DateTime64(3, 'UTC')"},
{"name": "coin", "type": "LowCardinality(String)"},
{"name": "side", "type": "Enum8('B' = 1, 'A' = 2)"},
{"name": "price", "type": "Decimal(38, 18)"},
{"name": "size", "type": "Decimal(38, 18)"},
{"name": "notional_usd", "type": "Decimal(38, 36)"},
{"name": "buyer_address", "type": "FixedString(42)"},
{"name": "seller_address", "type": "FixedString(42)"},
{"name": "buyer_fee", "type": "Decimal(38, 18)"},
{"name": "seller_fee", "type": "Decimal(38, 18)"},
{"name": "fee_token", "type": "LowCardinality(String)"}
],
"rows": 3,
"statistics": {
"elapsed": 0.042,
"rows_read": 15847,
"bytes_read": 2456789
}
}
Volume by Coin (24h)
Top coins by trading volume in the last 24 hours.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT coin, count() AS trade_count, sum(price * size) AS volume_usd, min(price) AS low, max(price) AS high, avg(price) AS avg_price FROM hyperliquid_trades WHERE timestamp > now() - INTERVAL 24 HOUR GROUP BY coin ORDER BY volume_usd DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"coin": "BTC",
"trade_count": 45673,
"volume_usd": "2847561234.567890123456789012345678901234567890",
"low": "94125.000000000000000000",
"high": "96785.500000000000000000",
"avg_price": "95432.250000000000000000"
},
{
"coin": "ETH",
"trade_count": 38912,
"volume_usd": "1245789345.123456789012345678901234567890123456",
"low": "3198.250000000000000000",
"high": "3289.750000000000000000",
"avg_price": "3245.125000000000000000"
},
{
"coin": "SOL",
"trade_count": 52341,
"volume_usd": "456123789.456789012345678901234567890123456789",
"low": "140.150000000000000000",
"high": "144.850000000000000000",
"avg_price": "142.450000000000000000"
}
],
"meta": [
{"name": "coin", "type": "LowCardinality(String)"},
{"name": "trade_count", "type": "UInt64"},
{"name": "volume_usd", "type": "Decimal(38, 36)"},
{"name": "low", "type": "Decimal(38, 18)"},
{"name": "high", "type": "Decimal(38, 18)"},
{"name": "avg_price", "type": "Decimal(38, 18)"}
],
"rows": 3,
"statistics": {
"elapsed": 0.156,
"rows_read": 2456781,
"bytes_read": 45678912
}
}
Whale Trades (24h)
Trades over $100K in the last 24 hours.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT timestamp, coin, side, price, size, price * size AS notional_usd, buyer_address, seller_address FROM hyperliquid_trades WHERE timestamp > now() - INTERVAL 24 HOUR AND price * size > 100000 ORDER BY notional_usd DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"timestamp": "2026-03-25 09:23:45.000",
"coin": "BTC",
"side": "B",
"price": "95678.250000000000000000",
"size": "15.750000000000000000",
"notional_usd": "1506932.437500000000000000000000000000000000",
"buyer_address": "0xa1b2C3d4E5f6A7b8C9d0E1f2A3b4C5d6E7f8A9b0",
"seller_address": "0x9f8e7D6c5B4a3F2e1D0c9B8a7F6e5D4c3B2a1F0"
},
{
"timestamp": "2026-03-25 08:15:32.000",
"coin": "ETH",
"side": "A",
"price": "3267.500000000000000000",
"size": "235.500000000000000000",
"notional_usd": "769496.250000000000000000000000000000000000",
"buyer_address": "0x2b3C4d5E6f7A8b9C0d1E2f3A4b5C6d7E8f9A0b1",
"seller_address": "0x8e7D6c5B4a3F2e1D0c9B8a7F6e5D4c3B2a1F0e9"
},
{
"timestamp": "2026-03-25 07:42:18.000",
"coin": "BTC",
"side": "A",
"price": "95234.750000000000000000",
"size": "6.250000000000000000",
"notional_usd": "595217.187500000000000000000000000000000000",
"buyer_address": "0x3c4D5e6F7a8B9c0D1e2F3a4B5c6D7e8F9a0B1c2",
"seller_address": "0x7d6C5b4A3f2E1d0C9b8A7f6E5d4C3b2A1f0E9d8"
}
],
"meta": [
{"name": "timestamp", "type": "DateTime64(3, 'UTC')"},
{"name": "coin", "type": "LowCardinality(String)"},
{"name": "side", "type": "Enum8('B' = 1, 'A' = 2)"},
{"name": "price", "type": "Decimal(38, 18)"},
{"name": "size", "type": "Decimal(38, 18)"},
{"name": "notional_usd", "type": "Decimal(38, 36)"},
{"name": "buyer_address", "type": "FixedString(42)"},
{"name": "seller_address", "type": "FixedString(42)"}
],
"rows": 3,
"statistics": {
"elapsed": 0.089,
"rows_read": 876543,
"bytes_read": 12345678
}
}
DEX Trades (Enriched View)
Trades with market type (perpetual vs spot) from the enriched view.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT timestamp, coin, market_type, side, price, size, usd_amount, buyer_address, seller_address FROM hyperliquid_dex_trades WHERE block_time > now() - INTERVAL 1 HOUR ORDER BY block_number DESC, trade_id DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"timestamp": "2026-03-25 10:45:12.000",
"coin": "PURR",
"market_type": "spot",
"side": "B",
"price": "0.125000000000000000",
"size": "5000.000000000000000000",
"usd_amount": "625.000000000000000000000000000000000000",
"buyer_address": "0x4d5E6f7A8b9C0d1E2f3A4b5C6d7E8f9A0b1C2d3",
"seller_address": "0x6c5B4a3F2e1D0c9B8a7F6e5D4c3B2a1F0e9D8c7"
},
{
"timestamp": "2026-03-25 10:44:58.000",
"coin": "BTC",
"market_type": "perpetual",
"side": "A",
"price": "95432.500000000000000000",
"size": "0.250000000000000000",
"usd_amount": "23858.125000000000000000000000000000000000",
"buyer_address": "0x5e6F7a8B9c0D1e2F3a4B5c6D7e8F9a0B1c2D3e4",
"seller_address": "0x5b4A3f2E1d0C9b8A7f6E5d4C3b2A1f0E9d8C7b6"
},
{
"timestamp": "2026-03-25 10:44:45.000",
"coin": "HFUN",
"market_type": "spot",
"side": "B",
"price": "0.045000000000000000",
"size": "12000.000000000000000000",
"usd_amount": "540.000000000000000000000000000000000000",
"buyer_address": "0x6f7A8b9C0d1E2f3A4b5C6d7E8f9A0b1C2d3E4f5",
"seller_address": "0x4a3F2e1D0c9B8a7F6e5D4c3B2a1F0e9D8c7B6a5"
}
],
"meta": [
{"name": "timestamp", "type": "DateTime64(3, 'UTC')"},
{"name": "coin", "type": "LowCardinality(String)"},
{"name": "market_type", "type": "LowCardinality(String)"},
{"name": "side", "type": "Enum8('B' = 1, 'A' = 2)"},
{"name": "price", "type": "Decimal(38, 18)"},
{"name": "size", "type": "Decimal(38, 18)"},
{"name": "usd_amount", "type": "Decimal(38, 36)"},
{"name": "buyer_address", "type": "FixedString(42)"},
{"name": "seller_address", "type": "FixedString(42)"}
],
"rows": 3,
"statistics": {
"elapsed": 0.034,
"rows_read": 8234,
"bytes_read": 1456789
}
}
Activity Queries
Analyze trading volume and user activity metrics aggregated over time periods.
Hourly Volume
Trading volume aggregated by hour for the last 7 days.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT toStartOfHour(timestamp) AS hour, count() AS trades, sum(price * size) AS volume_usd FROM hyperliquid_trades WHERE timestamp > now() - INTERVAL 7 DAY GROUP BY hour ORDER BY hour DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"hour": "2026-03-25 10:00:00",
"trades": 3456,
"volume_usd": "124567890.123456789012345678901234567890123456"
},
{
"hour": "2026-03-25 09:00:00",
"trades": 3821,
"volume_usd": "145678901.234567890123456789012345678901234567"
},
{
"hour": "2026-03-25 08:00:00",
"trades": 2987,
"volume_usd": "98765432.109876543210987654321098765432109876"
}
],
"meta": [
{"name": "hour", "type": "DateTime"},
{"name": "trades", "type": "UInt64"},
{"name": "volume_usd", "type": "Decimal(38, 36)"}
],
"rows": 3,
"statistics": {
"elapsed": 0.234,
"rows_read": 4567890,
"bytes_read": 67891234
}
}
Daily Volume
Daily trading volume for the last 30 days.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT toStartOfDay(timestamp) AS day, count() AS trades, sum(price * size) AS volume_usd, uniqExact(buyer_address) + uniqExact(seller_address) AS unique_traders FROM hyperliquid_trades WHERE timestamp > now() - INTERVAL 30 DAY GROUP BY day ORDER BY day DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"day": "2026-03-25",
"trades": 67843,
"volume_usd": "3456789012.345678901234567890123456789012345678",
"unique_traders": 8934
},
{
"day": "2026-03-24",
"trades": 72156,
"volume_usd": "3789012345.678901234567890123456789012345678901",
"unique_traders": 9241
},
{
"day": "2026-03-23",
"trades": 65432,
"volume_usd": "2987654321.098765432109876543210987654321098765",
"unique_traders": 8567
}
],
"meta": [
{"name": "day", "type": "Date"},
{"name": "trades", "type": "UInt64"},
{"name": "volume_usd", "type": "Decimal(38, 36)"},
{"name": "unique_traders", "type": "UInt64"}
],
"rows": 3,
"statistics": {
"elapsed": 0.567,
"rows_read": 12345678,
"bytes_read": 234567890
}
}
Top Traders by Volume (7d)
Most active traders by volume in the last 7 days.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT buyer_address AS trader, count() AS trade_count, sum(price * size) AS total_volume, uniqExact(coin) AS coins_traded FROM hyperliquid_trades WHERE timestamp > now() - INTERVAL 7 DAY GROUP BY trader ORDER BY total_volume DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"trader": "0xa1b2C3d4E5f6A7b8C9d0E1f2A3b4C5d6E7f8A9b0",
"trade_count": 1234,
"total_volume": "456789012.345678901234567890123456789012345678",
"coins_traded": 15
},
{
"trader": "0xb2C3d4E5f6A7b8C9d0E1f2A3b4C5d6E7f8A9b0C1",
"trade_count": 987,
"total_volume": "234567890.123456789012345678901234567890123456",
"coins_traded": 12
},
{
"trader": "0xc3D4e5F6a7B8c9D0e1F2a3B4c5D6e7F8a9B0c1D2",
"trade_count": 856,
"total_volume": "198765432.109876543210987654321098765432109876",
"coins_traded": 18
}
],
"meta": [
{"name": "trader", "type": "FixedString(42)"},
{"name": "trade_count", "type": "UInt64"},
{"name": "total_volume", "type": "Decimal(38, 36)"},
{"name": "coins_traded", "type": "UInt64"}
],
"rows": 3,
"statistics": {
"elapsed": 0.345,
"rows_read": 5678901,
"bytes_read": 89012345
}
}
Fills Queries
Access fill events including position changes, liquidations, and realized PnL data.
Recent Fills
Last 100 individual fill events.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT time, coin, side, price, size, fee, fee_token, closed_pnl, dir, user, hash FROM hyperliquid_fills WHERE block_time > now() - INTERVAL 1 HOUR ORDER BY block_number DESC, tid DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"time": "2026-03-25 10:45:23.000",
"coin": "BTC",
"side": "B",
"price": "95432.500000000000000000",
"size": "0.150000000000000000",
"fee": "7.156437500000000000",
"fee_token": "USDC",
"closed_pnl": "0.000000000000000000",
"dir": "Open Long",
"user": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"hash": "0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b"
},
{
"time": "2026-03-25 10:45:18.000",
"coin": "ETH",
"side": "A",
"price": "3245.750000000000000000",
"size": "2.500000000000000000",
"fee": "4.057187500000000000",
"fee_token": "USDC",
"closed_pnl": "125.450000000000000000",
"dir": "Close Long",
"user": "0x9f8e7D6c5B4a3F2e1D0c9B8a7F6e5D4c3B2a1F0",
"hash": "0x2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3"
},
{
"time": "2026-03-25 10:45:12.000",
"coin": "SOL",
"side": "B",
"price": "142.350000000000000000",
"size": "50.000000000000000000",
"fee": "3.558750000000000000",
"fee_token": "USDC",
"closed_pnl": "0.000000000000000000",
"dir": "Open Long",
"user": "0x5a6B7c8D9e0F1a2b3C4d5E6f7A8b9C0d1E2f3A4",
"hash": "0x3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4"
}
],
"meta": [
{"name": "time", "type": "DateTime64(3, 'UTC')"},
{"name": "coin", "type": "LowCardinality(String)"},
{"name": "side", "type": "Enum8('B' = 1, 'A' = 2)"},
{"name": "price", "type": "Decimal(38, 18)"},
{"name": "size", "type": "Decimal(38, 18)"},
{"name": "fee", "type": "Decimal(38, 18)"},
{"name": "fee_token", "type": "LowCardinality(String)"},
{"name": "closed_pnl", "type": "Decimal(38, 18)"},
{"name": "dir", "type": "String"},
{"name": "user", "type": "FixedString(42)"},
{"name": "hash", "type": "FixedString(66)"}
],
"rows": 3,
"statistics": {
"elapsed": 0.038,
"rows_read": 12456,
"bytes_read": 2345678
}
}
Recent Liquidations
Recent liquidation events with mark prices.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT time, coin, side, price, size, price * size AS notional, liquidated_user, liquidation_mark_price, liquidation_method, user FROM hyperliquid_fills WHERE block_time > now() - INTERVAL 24 HOUR AND is_liquidation = 1 ORDER BY block_number DESC, tid DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"time": "2026-03-25 09:32:15.000",
"coin": "BTC",
"side": "A",
"price": "94567.250000000000000000",
"size": "0.450000000000000000",
"notional": "42555.262500000000000000000000000000000000",
"liquidated_user": "0x7a8B9c0D1e2F3a4B5c6D7e8F9a0B1c2D3e4F5a6B",
"liquidation_mark_price": "94523.500000000000000000",
"liquidation_method": "Partial",
"user": "0x8b9C0d1E2f3A4b5C6d7E8f9A0b1C2d3E4f5A6b7C"
},
{
"time": "2026-03-25 08:15:42.000",
"coin": "ETH",
"side": "B",
"price": "3198.500000000000000000",
"size": "5.250000000000000000",
"notional": "16792.125000000000000000000000000000000000",
"liquidated_user": "0x9c0D1e2F3a4B5c6D7e8F9a0B1c2D3e4F5a6B7c8D",
"liquidation_mark_price": "3195.750000000000000000",
"liquidation_method": "Full",
"user": "0x0d1E2f3A4b5C6d7E8f9A0b1C2d3E4f5A6b7C8d9E"
},
{
"time": "2026-03-25 06:47:28.000",
"coin": "SOL",
"side": "A",
"price": "140.250000000000000000",
"size": "125.000000000000000000",
"notional": "17531.250000000000000000000000000000000000",
"liquidated_user": "0x1e2F3a4B5c6D7e8F9a0B1c2D3e4F5a6B7c8D9e0F",
"liquidation_mark_price": "140.150000000000000000",
"liquidation_method": "Partial",
"user": "0x2f3A4b5C6d7E8f9A0b1C2d3E4f5A6b7C8d9E0f1A"
}
],
"meta": [
{"name": "time", "type": "DateTime64(3, 'UTC')"},
{"name": "coin", "type": "LowCardinality(String)"},
{"name": "side", "type": "Enum8('B' = 1, 'A' = 2)"},
{"name": "price", "type": "Decimal(38, 18)"},
{"name": "size", "type": "Decimal(38, 18)"},
{"name": "notional", "type": "Decimal(38, 36)"},
{"name": "liquidated_user", "type": "FixedString(42)"},
{"name": "liquidation_mark_price", "type": "Decimal(38, 18)"},
{"name": "liquidation_method", "type": "String"},
{"name": "user", "type": "FixedString(42)"}
],
"rows": 3,
"statistics": {
"elapsed": 0.067,
"rows_read": 3456,
"bytes_read": 456789
}
}
Orders Queries
Retrieve order placement, cancellation, and status update events.
Recent Orders
Latest 100 order events.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT status_time, coin, side, order_type, limit_price, size, orig_size, status, tif, user FROM hyperliquid_orders WHERE block_time > now() - INTERVAL 1 HOUR ORDER BY block_number DESC, oid DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"status_time": "2026-03-25 10:45:25.000",
"coin": "BTC",
"side": "B",
"order_type": "Limit",
"limit_price": "95400.000000000000000000",
"size": "0.000000000000000000",
"orig_size": "0.150000000000000000",
"status": "Filled",
"tif": "Gtc",
"user": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
},
{
"status_time": "2026-03-25 10:45:20.000",
"coin": "ETH",
"side": "A",
"order_type": "Limit",
"limit_price": "3245.000000000000000000",
"size": "0.000000000000000000",
"orig_size": "2.500000000000000000",
"status": "Filled",
"tif": "Gtc",
"user": "0x9f8e7D6c5B4a3F2e1D0c9B8a7F6e5D4c3B2a1F0"
},
{
"status_time": "2026-03-25 10:45:15.000",
"coin": "SOL",
"side": "B",
"order_type": "Market",
"limit_price": "0.000000000000000000",
"size": "0.000000000000000000",
"orig_size": "50.000000000000000000",
"status": "Filled",
"tif": "Ioc",
"user": "0x5a6B7c8D9e0F1a2b3C4d5E6f7A8b9C0d1E2f3A4"
}
],
"meta": [
{"name": "status_time", "type": "DateTime64(3, 'UTC')"},
{"name": "coin", "type": "LowCardinality(String)"},
{"name": "side", "type": "Enum8('B' = 1, 'A' = 2)"},
{"name": "order_type", "type": "String"},
{"name": "limit_price", "type": "Decimal(38, 18)"},
{"name": "size", "type": "Decimal(38, 18)"},
{"name": "orig_size", "type": "Decimal(38, 18)"},
{"name": "status", "type": "String"},
{"name": "tif", "type": "String"},
{"name": "user", "type": "FixedString(42)"}
],
"rows": 3,
"statistics": {
"elapsed": 0.041,
"rows_read": 15678,
"bytes_read": 2567890
}
}
Order Type Distribution (1h)
Breakdown of order types in the last hour.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT order_type, side, status, count() AS order_count, uniqExact(user) AS unique_users FROM hyperliquid_orders WHERE block_time > now() - INTERVAL 1 HOUR GROUP BY order_type, side, status ORDER BY order_count DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"order_type": "Limit",
"side": "B",
"status": "Filled",
"order_count": 2341,
"unique_users": 567
},
{
"order_type": "Limit",
"side": "A",
"status": "Filled",
"order_count": 2198,
"unique_users": 534
},
{
"order_type": "Limit",
"side": "B",
"status": "Canceled",
"order_count": 1876,
"unique_users": 412
}
],
"meta": [
{"name": "order_type", "type": "String"},
{"name": "side", "type": "Enum8('B' = 1, 'A' = 2)"},
{"name": "status", "type": "String"},
{"name": "order_count", "type": "UInt64"},
{"name": "unique_users", "type": "UInt64"}
],
"rows": 3,
"statistics": {
"elapsed": 0.078,
"rows_read": 45678,
"bytes_read": 5678901
}
}
Funding Queries
Query funding rate payments and historical funding rate data for perpetual positions.
Latest Funding Payments
Most recent funding payments by coin.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT coin, funding_rate, count() AS payments, sum(funding_amount) AS total_funding, avg(szi) AS avg_position_size FROM hyperliquid_funding WHERE time > now() - INTERVAL 8 HOUR GROUP BY coin, funding_rate ORDER BY abs(total_funding) DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"coin": "BTC",
"funding_rate": "0.000045000000000000",
"payments": 3456,
"total_funding": "12345.678901234567890123",
"avg_position_size": "2.456789012345678901"
},
{
"coin": "ETH",
"funding_rate": "0.000038000000000000",
"payments": 2987,
"total_funding": "8765.432109876543210987",
"avg_position_size": "15.234567890123456789"
},
{
"coin": "SOL",
"funding_rate": "-0.000012000000000000",
"payments": 2341,
"total_funding": "-987.654321098765432109",
"avg_position_size": "145.678901234567890123"
}
],
"meta": [
{"name": "coin", "type": "LowCardinality(String)"},
{"name": "funding_rate", "type": "Decimal(38, 18)"},
{"name": "payments", "type": "UInt64"},
{"name": "total_funding", "type": "Decimal(38, 18)"},
{"name": "avg_position_size", "type": "Decimal(38, 18)"}
],
"rows": 3,
"statistics": {
"elapsed": 0.089,
"rows_read": 67890,
"bytes_read": 8901234
}
}
Funding Rate History by Coin
Hourly funding rates for top coins over 7 days.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT toStartOfHour(time) AS hour, coin, avg(funding_rate) AS avg_funding_rate, count() AS payment_count, sum(funding_amount) AS total_funding FROM hyperliquid_funding WHERE time > now() - INTERVAL 7 DAY AND coin IN ('\''BTC'\'', '\''ETH'\'', '\''SOL'\'') GROUP BY hour, coin ORDER BY hour DESC, coin LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"hour": "2026-03-25 10:00:00",
"coin": "BTC",
"avg_funding_rate": "0.000042000000000000",
"payment_count": 456,
"total_funding": "1234.567890123456789012"
},
{
"hour": "2026-03-25 10:00:00",
"coin": "ETH",
"avg_funding_rate": "0.000035000000000000",
"payment_count": 389,
"total_funding": "876.543210987654321098"
},
{
"hour": "2026-03-25 10:00:00",
"coin": "SOL",
"avg_funding_rate": "-0.000008000000000000",
"payment_count": 312,
"total_funding": "-98.765432109876543210"
}
],
"meta": [
{"name": "hour", "type": "DateTime"},
{"name": "coin", "type": "LowCardinality(String)"},
{"name": "avg_funding_rate", "type": "Decimal(38, 18)"},
{"name": "payment_count", "type": "UInt64"},
{"name": "total_funding", "type": "Decimal(38, 18)"}
],
"rows": 3,
"statistics": {
"elapsed": 0.234,
"rows_read": 234567,
"bytes_read": 12345678
}
}
Infrastructure Queries
Monitor block production, transaction execution, and network-level activity.
Block Activity
Event counts per block for recent blocks.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT block_number, block_time, fills_count, orders_count, misc_events_count, book_diffs_count, twap_statuses_count, writer_actions_count FROM hyperliquid_blocks ORDER BY block_number DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"block_number": 15678934,
"block_time": "2026-03-25 10:45:30.000",
"fills_count": 45,
"orders_count": 123,
"misc_events_count": 12,
"book_diffs_count": 234,
"twap_statuses_count": 8,
"writer_actions_count": 3
},
{
"block_number": 15678933,
"block_time": "2026-03-25 10:45:29.000",
"fills_count": 38,
"orders_count": 98,
"misc_events_count": 9,
"book_diffs_count": 189,
"twap_statuses_count": 6,
"writer_actions_count": 2
},
{
"block_number": 15678932,
"block_time": "2026-03-25 10:45:28.000",
"fills_count": 52,
"orders_count": 145,
"misc_events_count": 15,
"book_diffs_count": 267,
"twap_statuses_count": 11,
"writer_actions_count": 4
}
],
"meta": [
{"name": "block_number", "type": "UInt64"},
{"name": "block_time", "type": "DateTime64(3, 'UTC')"},
{"name": "fills_count", "type": "UInt32"},
{"name": "orders_count", "type": "UInt32"},
{"name": "misc_events_count", "type": "UInt32"},
{"name": "book_diffs_count", "type": "UInt32"},
{"name": "twap_statuses_count", "type": "UInt32"},
{"name": "writer_actions_count", "type": "UInt32"}
],
"rows": 3,
"statistics": {
"elapsed": 0.012,
"rows_read": 3,
"bytes_read": 456
}
}
Recent Transactions
Latest L1 transactions with action types.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT block_time, round, tx_hash, user, action_type, is_success, error FROM hyperliquid_transactions ORDER BY round DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"block_time": "2026-03-25 10:45:30.000",
"round": 15678934,
"tx_hash": "0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b",
"user": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"action_type": "order",
"is_success": 1,
"error": ""
},
{
"block_time": "2026-03-25 10:45:28.000",
"round": 15678932,
"tx_hash": "0x2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3",
"user": "0x9f8e7D6c5B4a3F2e1D0c9B8a7F6e5D4c3B2a1F0",
"action_type": "withdraw",
"is_success": 1,
"error": ""
},
{
"block_time": "2026-03-25 10:45:25.000",
"round": 15678929,
"tx_hash": "0x3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4",
"user": "0x5a6B7c8D9e0F1a2b3C4d5E6f7A8b9C0d1E2f3A4",
"action_type": "spot_send",
"is_success": 0,
"error": "Insufficient balance"
}
],
"meta": [
{"name": "block_time", "type": "DateTime64(3, 'UTC')"},
{"name": "round", "type": "UInt64"},
{"name": "tx_hash", "type": "FixedString(66)"},
{"name": "user", "type": "FixedString(42)"},
{"name": "action_type", "type": "String"},
{"name": "is_success", "type": "UInt8"},
{"name": "error", "type": "String"}
],
"rows": 3,
"statistics": {
"elapsed": 0.023,
"rows_read": 3,
"bytes_read": 678
}
}
Action Type Breakdown (24h)
Distribution of transaction types.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT action_type, count() AS tx_count, countIf(is_success = 1) AS success_count, countIf(is_success = 0) AS failed_count, round(countIf(is_success = 1) / count() * 100, 2) AS success_rate FROM hyperliquid_transactions WHERE block_time > now() - INTERVAL 24 HOUR GROUP BY action_type ORDER BY tx_count DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"action_type": "order",
"tx_count": 145678,
"success_count": 143234,
"failed_count": 2444,
"success_rate": "98.32"
},
{
"action_type": "cancel",
"tx_count": 67834,
"success_count": 67689,
"failed_count": 145,
"success_rate": "99.79"
},
{
"action_type": "withdraw",
"tx_count": 23456,
"success_count": 22987,
"failed_count": 469,
"success_rate": "98.00"
}
],
"meta": [
{"name": "action_type", "type": "String"},
{"name": "tx_count", "type": "UInt64"},
{"name": "success_count", "type": "UInt64"},
{"name": "failed_count", "type": "UInt64"},
{"name": "success_rate", "type": "Float64"}
],
"rows": 3,
"statistics": {
"elapsed": 0.189,
"rows_read": 567890,
"bytes_read": 23456789
}
}
Ledger Queries
Track asset transfers, deposits, withdrawals, and balance changes across accounts.
Recent Asset Transfers
Latest deposits, withdrawals, and internal transfers.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT time, transfer_type, user, destination, token, amount, usdc_amount, fee, tx_hash FROM hyperliquid_asset_transfers ORDER BY block_number DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"time": "2026-03-25 10:45:28.000",
"transfer_type": "withdraw",
"user": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"destination": "0x9f8e7D6c5B4a3F2e1D0c9B8a7F6e5D4c3B2a1F0",
"token": "USDC",
"amount": "5000.000000000000000000",
"usdc_amount": "5000.000000000000000000",
"fee": "1.000000000000000000",
"tx_hash": "0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b"
},
{
"time": "2026-03-25 10:44:12.000",
"transfer_type": "deposit",
"user": "0x5a6B7c8D9e0F1a2b3C4d5E6f7A8b9C0d1E2f3A4",
"destination": "0x5a6B7c8D9e0F1a2b3C4d5E6f7A8b9C0d1E2f3A4",
"token": "USDC",
"amount": "10000.000000000000000000",
"usdc_amount": "10000.000000000000000000",
"fee": "0.000000000000000000",
"tx_hash": "0x2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3"
},
{
"time": "2026-03-25 10:42:45.000",
"transfer_type": "internal_transfer",
"user": "0x4d5E6f7A8b9C0d1E2f3A4b5C6d7E8f9A0b1C2d3",
"destination": "0x6c5B4a3F2e1D0c9B8a7F6e5D4c3B2a1F0e9D8c7",
"token": "PURR",
"amount": "10000.000000000000000000",
"usdc_amount": "1250.000000000000000000",
"fee": "0.000000000000000000",
"tx_hash": "0x3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4"
}
],
"meta": [
{"name": "time", "type": "DateTime64(3, 'UTC')"},
{"name": "transfer_type", "type": "String"},
{"name": "user", "type": "FixedString(42)"},
{"name": "destination", "type": "FixedString(42)"},
{"name": "token", "type": "LowCardinality(String)"},
{"name": "amount", "type": "Decimal(38, 18)"},
{"name": "usdc_amount", "type": "Decimal(38, 18)"},
{"name": "fee", "type": "Decimal(38, 18)"},
{"name": "tx_hash", "type": "FixedString(66)"}
],
"rows": 3,
"statistics": {
"elapsed": 0.028,
"rows_read": 3,
"bytes_read": 789
}
}
Transfer Volume by Type (7d)
Aggregate transfer volumes grouped by type.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT transfer_type, count() AS transfer_count, sum(usdc_amount) AS total_usdc, uniqExact(user) AS unique_users FROM hyperliquid_asset_transfers WHERE time > now() - INTERVAL 7 DAY GROUP BY transfer_type ORDER BY total_usdc DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"transfer_type": "deposit",
"transfer_count": 12456,
"total_usdc": "456789012.345678901234567890",
"unique_users": 3456
},
{
"transfer_type": "withdraw",
"transfer_count": 9876,
"total_usdc": "345678901.234567890123456789",
"unique_users": 2987
},
{
"transfer_type": "internal_transfer",
"transfer_count": 23456,
"total_usdc": "123456789.012345678901234567",
"unique_users": 5678
}
],
"meta": [
{"name": "transfer_type", "type": "String"},
{"name": "transfer_count", "type": "UInt64"},
{"name": "total_usdc", "type": "Decimal(38, 18)"},
{"name": "unique_users", "type": "UInt64"}
],
"rows": 3,
"statistics": {
"elapsed": 0.145,
"rows_read": 234567,
"bytes_read": 12345678
}
}
Recent Ledger Updates
Raw ledger deltas (deposits, withdrawals, liquidations, etc.).
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT time, delta_type, user, usdc_amount, token, amount, destination, fee, hash FROM hyperliquid_ledger_updates ORDER BY block_number DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"time": "2026-03-25 10:45:30.000",
"delta_type": "funding",
"user": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"usdc_amount": "-12.345678901234567890",
"token": "USDC",
"amount": "-12.345678901234567890",
"destination": "",
"fee": "0.000000000000000000",
"hash": "0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b"
},
{
"time": "2026-03-25 10:45:28.000",
"delta_type": "withdraw",
"user": "0x9f8e7D6c5B4a3F2e1D0c9B8a7F6e5D4c3B2a1F0",
"usdc_amount": "-5000.000000000000000000",
"token": "USDC",
"amount": "-5000.000000000000000000",
"destination": "0x8dF3aad3a84da6b69A4DA8aeC3eA40d9091B2Ac",
"fee": "1.000000000000000000",
"hash": "0x2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3"
},
{
"time": "2026-03-25 10:45:25.000",
"delta_type": "trade",
"user": "0x5a6B7c8D9e0F1a2b3C4d5E6f7A8b9C0d1E2f3A4",
"usdc_amount": "-7.156437500000000000",
"token": "USDC",
"amount": "-7.156437500000000000",
"destination": "",
"fee": "7.156437500000000000",
"hash": "0x3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4"
}
],
"meta": [
{"name": "time", "type": "DateTime64(3, 'UTC')"},
{"name": "delta_type", "type": "String"},
{"name": "user", "type": "FixedString(42)"},
{"name": "usdc_amount", "type": "Decimal(38, 18)"},
{"name": "token", "type": "LowCardinality(String)"},
{"name": "amount", "type": "Decimal(38, 18)"},
{"name": "destination", "type": "String"},
{"name": "fee", "type": "Decimal(38, 18)"},
{"name": "hash", "type": "FixedString(66)"}
],
"rows": 3,
"statistics": {
"elapsed": 0.019,
"rows_read": 3,
"bytes_read": 890
}
}
Bridge Deposits & Withdrawals
L1 bridge activity from the latest ABCI snapshot.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT bridge_type, user, amount_wei, tx_hash, eth_block_number, event_time, snapshot_time FROM hyperliquid_bridge WHERE block_number = (SELECT max(block_number) FROM hyperliquid_bridge) ORDER BY amount_wei DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"bridge_type": "deposit",
"user": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"amount_wei": "50000000000000000000000",
"tx_hash": "0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b",
"eth_block_number": 19876543,
"event_time": "2026-03-25 10:30:15.000",
"snapshot_time": "2026-03-25 10:45:30.000"
},
{
"bridge_type": "withdraw",
"user": "0x9f8e7D6c5B4a3F2e1D0c9B8a7F6e5D4c3B2a1F0",
"amount_wei": "25000000000000000000000",
"tx_hash": "0x2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3",
"eth_block_number": 19876521,
"event_time": "2026-03-25 10:15:42.000",
"snapshot_time": "2026-03-25 10:45:30.000"
},
{
"bridge_type": "deposit",
"user": "0x5a6B7c8D9e0F1a2b3C4d5E6f7A8b9C0d1E2f3A4",
"amount_wei": "10000000000000000000000",
"tx_hash": "0x3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4",
"eth_block_number": 19876498,
"event_time": "2026-03-25 09:58:23.000",
"snapshot_time": "2026-03-25 10:45:30.000"
}
],
"meta": [
{"name": "bridge_type", "type": "String"},
{"name": "user", "type": "FixedString(42)"},
{"name": "amount_wei", "type": "UInt256"},
{"name": "tx_hash", "type": "FixedString(66)"},
{"name": "eth_block_number", "type": "UInt64"},
{"name": "event_time", "type": "DateTime64(3, 'UTC')"},
{"name": "snapshot_time", "type": "DateTime64(3, 'UTC')"}
],
"rows": 3,
"statistics": {
"elapsed": 0.025,
"rows_read": 1234,
"bytes_read": 234567
}
}
Markets Queries
Access market configuration, current prices, funding rates, and open positions data.
Perpetual Markets
All perpetual markets with leverage and decimals.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT coin, market_index, sz_decimals, max_leverage, only_isolated FROM hyperliquid_perpetual_markets ORDER BY coin LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"coin": "1INCH",
"market_index": 45,
"sz_decimals": 1,
"max_leverage": 20,
"only_isolated": 0
},
{
"coin": "AAVE",
"market_index": 23,
"sz_decimals": 3,
"max_leverage": 20,
"only_isolated": 0
},
{
"coin": "ADA",
"market_index": 12,
"sz_decimals": 0,
"max_leverage": 50,
"only_isolated": 0
}
],
"meta": [
{"name": "coin", "type": "LowCardinality(String)"},
{"name": "market_index", "type": "UInt32"},
{"name": "sz_decimals", "type": "UInt8"},
{"name": "max_leverage", "type": "UInt32"},
{"name": "only_isolated", "type": "UInt8"}
],
"rows": 3,
"statistics": {
"elapsed": 0.008,
"rows_read": 150,
"bytes_read": 2345
}
}
Spot Markets
All spot tokens with metadata.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT token_index, token, token_id, full_name, sz_decimals, wei_decimals, is_canonical, evm_contract FROM hyperliquid_spot_markets ORDER BY token_index LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"token_index": 0,
"token": "PURR",
"token_id": "0x7241c8a4b8f8c7b6a2a8c9b0d1e2f3a4b5c6d7e8",
"full_name": "PURR",
"sz_decimals": 1,
"wei_decimals": 18,
"is_canonical": 1,
"evm_contract": "0x7241c8a4b8f8c7b6a2a8c9b0d1e2f3a4b5c6d7e8"
},
{
"token_index": 1,
"token": "HFUN",
"token_id": "0x8352d9c8b9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4",
"full_name": "HFUN",
"sz_decimals": 0,
"wei_decimals": 18,
"is_canonical": 1,
"evm_contract": "0x8352d9c8b9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4"
},
{
"token_index": 2,
"token": "JEFF",
"token_id": "0x9463e0d9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5",
"full_name": "JEFF",
"sz_decimals": 5,
"wei_decimals": 18,
"is_canonical": 1,
"evm_contract": "0x9463e0d9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5"
}
],
"meta": [
{"name": "token_index", "type": "UInt32"},
{"name": "token", "type": "LowCardinality(String)"},
{"name": "token_id", "type": "String"},
{"name": "full_name", "type": "String"},
{"name": "sz_decimals", "type": "UInt8"},
{"name": "wei_decimals", "type": "UInt8"},
{"name": "is_canonical", "type": "UInt8"},
{"name": "evm_contract", "type": "String"}
],
"rows": 3,
"statistics": {
"elapsed": 0.011,
"rows_read": 200,
"bytes_read": 3456
}
}
Market Context (Latest)
Current funding rates, open interest, and prices.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT coin, funding, open_interest, mark_px, oracle_px, mid_px, premium, day_ntl_vlm, prev_day_px FROM hyperliquid_perpetual_market_contexts WHERE polled_at > now() - INTERVAL 5 MINUTE ORDER BY day_ntl_vlm DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"coin": "BTC",
"funding": "0.000042000000000000",
"open_interest": "456789012.345678901234567890",
"mark_px": "95432.500000000000000000",
"oracle_px": "95428.250000000000000000",
"mid_px": "95433.125000000000000000",
"premium": "0.000045000000000000",
"day_ntl_vlm": "2847561234.567890123456789012",
"prev_day_px": "94567.000000000000000000"
},
{
"coin": "ETH",
"funding": "0.000035000000000000",
"open_interest": "234567890.123456789012345678",
"mark_px": "3245.750000000000000000",
"oracle_px": "3244.500000000000000000",
"mid_px": "3245.875000000000000000",
"premium": "0.000038000000000000",
"day_ntl_vlm": "1245789345.123456789012345678",
"prev_day_px": "3198.250000000000000000"
},
{
"coin": "SOL",
"funding": "-0.000008000000000000",
"open_interest": "123456789.012345678901234567",
"mark_px": "142.350000000000000000",
"oracle_px": "142.375000000000000000",
"mid_px": "142.362500000000000000",
"premium": "-0.000012000000000000",
"day_ntl_vlm": "456123789.456789012345678901",
"prev_day_px": "140.150000000000000000"
}
],
"meta": [
{"name": "coin", "type": "LowCardinality(String)"},
{"name": "funding", "type": "Decimal(38, 18)"},
{"name": "open_interest", "type": "Decimal(38, 18)"},
{"name": "mark_px", "type": "Decimal(38, 18)"},
{"name": "oracle_px", "type": "Decimal(38, 18)"},
{"name": "mid_px", "type": "Decimal(38, 18)"},
{"name": "premium", "type": "Decimal(38, 18)"},
{"name": "day_ntl_vlm", "type": "Decimal(38, 18)"},
{"name": "prev_day_px", "type": "Decimal(38, 18)"}
],
"rows": 3,
"statistics": {
"elapsed": 0.015,
"rows_read": 150,
"bytes_read": 4567
}
}
Largest Open Positions
Top positions by notional value.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT user, coin, size, entry_px, position_value, unrealized_pnl, return_on_equity, leverage_type, leverage_value, liquidation_price FROM hyperliquid_perpetual_positions WHERE polled_at > now() - INTERVAL 10 MINUTE ORDER BY abs(position_value) DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"user": "0xa1b2C3d4E5f6A7b8C9d0E1f2A3b4C5d6E7f8A9b0",
"coin": "BTC",
"size": "125.750000000000000000",
"entry_px": "94567.000000000000000000",
"position_value": "11999294.250000000000000000",
"unrealized_pnl": "108843.437500000000000000",
"return_on_equity": "4.562000000000000000",
"leverage_type": "cross",
"leverage_value": "5.000000000000000000",
"liquidation_price": "75653.600000000000000000"
},
{
"user": "0xb2C3d4E5f6A7b8C9d0E1f2A3b4C5d6E7f8A9b0C1",
"coin": "ETH",
"size": "-2456.500000000000000000",
"entry_px": "3289.750000000000000000",
"position_value": "-7973468.875000000000000000",
"unrealized_pnl": "-108653.437500000000000000",
"return_on_equity": "-6.823000000000000000",
"leverage_type": "cross",
"leverage_value": "10.000000000000000000",
"liquidation_price": "3617.725000000000000000"
},
{
"user": "0xc3D4e5F6a7B8c9D0e1F2a3B4c5D6e7F8a9B0c1D2",
"coin": "SOL",
"size": "45678.000000000000000000",
"entry_px": "140.150000000000000000",
"position_value": "6501050.700000000000000000",
"unrealized_pnl": "100471.800000000000000000",
"return_on_equity": "7.743000000000000000",
"leverage_type": "isolated",
"leverage_value": "20.000000000000000000",
"liquidation_price": "133.142500000000000000"
}
],
"meta": [
{"name": "user", "type": "FixedString(42)"},
{"name": "coin", "type": "LowCardinality(String)"},
{"name": "size", "type": "Decimal(38, 18)"},
{"name": "entry_px", "type": "Decimal(38, 18)"},
{"name": "position_value", "type": "Decimal(38, 18)"},
{"name": "unrealized_pnl", "type": "Decimal(38, 18)"},
{"name": "return_on_equity", "type": "Decimal(38, 18)"},
{"name": "leverage_type", "type": "String"},
{"name": "leverage_value", "type": "Decimal(38, 18)"},
{"name": "liquidation_price", "type": "Decimal(38, 18)"}
],
"rows": 3,
"statistics": {
"elapsed": 0.045,
"rows_read": 5678,
"bytes_read": 678901
}
}
Oracle Prices (All DEXes)
Mark and daily prices for all assets at the latest snapshot.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT clearinghouse, coin, mark_px, daily_px, snapshot_time FROM hyperliquid_oracle_prices WHERE block_number = (SELECT max(block_number) FROM hyperliquid_oracle_prices) ORDER BY clearinghouse, asset_idx LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"clearinghouse": "0x0",
"coin": "BTC",
"mark_px": "95432.500000000000000000",
"daily_px": "94567.250000000000000000",
"snapshot_time": "2026-03-25 10:45:30.000"
},
{
"clearinghouse": "0x0",
"coin": "ETH",
"mark_px": "3245.750000000000000000",
"daily_px": "3198.500000000000000000",
"snapshot_time": "2026-03-25 10:45:30.000"
},
{
"clearinghouse": "0x0",
"coin": "SOL",
"mark_px": "142.350000000000000000",
"daily_px": "140.150000000000000000",
"snapshot_time": "2026-03-25 10:45:30.000"
}
],
"meta": [
{"name": "clearinghouse", "type": "String"},
{"name": "coin", "type": "LowCardinality(String)"},
{"name": "mark_px", "type": "Decimal(38, 18)"},
{"name": "daily_px", "type": "Decimal(38, 18)"},
{"name": "snapshot_time", "type": "DateTime64(3, 'UTC')"}
],
"rows": 3,
"statistics": {
"elapsed": 0.018,
"rows_read": 450,
"bytes_read": 12345
}
}
Portfolio & Positions Queries
Track user portfolios, positions, vault equity, sub-accounts, and agent authorizations.
Spot Balances for Address
Token balances from the latest ABCI snapshot (replace address).
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "-- Replace address below\nSELECT token, token_idx, total, escrowed, snapshot_time FROM hyperliquid_spot_clearinghouse_states WHERE user = lower('\''0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'\'') AND block_number = (SELECT max(block_number) FROM hyperliquid_spot_clearinghouse_states) AND total != 0 ORDER BY abs(total) DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"token": "USDC",
"token_idx": 0,
"total": "125678.450000000000000000",
"escrowed": "5000.000000000000000000",
"snapshot_time": "2026-03-25 10:45:30.000"
},
{
"token": "PURR",
"token_idx": 1,
"total": "50000.000000000000000000",
"escrowed": "0.000000000000000000",
"snapshot_time": "2026-03-25 10:45:30.000"
},
{
"token": "HFUN",
"token_idx": 2,
"total": "25000.000000000000000000",
"escrowed": "2500.000000000000000000",
"snapshot_time": "2026-03-25 10:45:30.000"
}
],
"meta": [
{"name": "token", "type": "LowCardinality(String)"},
{"name": "token_idx", "type": "UInt32"},
{"name": "total", "type": "Decimal(38, 18)"},
{"name": "escrowed", "type": "Decimal(38, 18)"},
{"name": "snapshot_time", "type": "DateTime64(3, 'UTC')"}
],
"rows": 3,
"statistics": {
"elapsed": 0.021,
"rows_read": 15,
"bytes_read": 2345
}
}
Vault Depositor Equity
Top vault depositors by ownership fraction.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT vault_name, depositor, ownership_fraction, net_deposits, leader, leader_commission, snapshot_time FROM hyperliquid_vault_equities WHERE block_number = (SELECT max(block_number) FROM hyperliquid_vault_equities) ORDER BY ownership_fraction DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"vault_name": "Alpha Vault",
"depositor": "0xa1b2C3d4E5f6A7b8C9d0E1f2A3b4C5d6E7f8A9b0",
"ownership_fraction": "0.145678901234567890",
"net_deposits": "456789.120000000000000000",
"leader": "0xb2C3d4E5f6A7b8C9d0E1f2A3b4C5d6E7f8A9b0C1",
"leader_commission": "0.100000000000000000",
"snapshot_time": "2026-03-25 10:45:30.000"
},
{
"vault_name": "Beta Vault",
"depositor": "0xc3D4e5F6a7B8c9D0e1F2a3B4c5D6e7F8a9B0c1D2",
"ownership_fraction": "0.089765432109876543",
"net_deposits": "234567.890000000000000000",
"leader": "0xd4E5f6A7b8C9d0E1f2A3b4C5d6E7f8A9b0C1d2E3",
"leader_commission": "0.150000000000000000",
"snapshot_time": "2026-03-25 10:45:30.000"
},
{
"vault_name": "Gamma Vault",
"depositor": "0xe5F6a7B8c9D0e1F2a3B4c5D6e7F8a9B0c1D2e3F4",
"ownership_fraction": "0.067890123456789012",
"net_deposits": "123456.780000000000000000",
"leader": "0xf6A7b8C9d0E1f2A3b4C5d6E7f8A9b0C1d2E3f4A5",
"leader_commission": "0.125000000000000000",
"snapshot_time": "2026-03-25 10:45:30.000"
}
],
"meta": [
{"name": "vault_name", "type": "String"},
{"name": "depositor", "type": "FixedString(42)"},
{"name": "ownership_fraction", "type": "Decimal(38, 18)"},
{"name": "net_deposits", "type": "Decimal(38, 18)"},
{"name": "leader", "type": "FixedString(42)"},
{"name": "leader_commission", "type": "Decimal(38, 18)"},
{"name": "snapshot_time", "type": "DateTime64(3, 'UTC')"}
],
"rows": 3,
"statistics": {
"elapsed": 0.034,
"rows_read": 1234,
"bytes_read": 45678
}
}
Sub-Account Mappings
Sub-account to master-account relationships.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "-- Replace address to find sub-accounts for a specific master\nSELECT sub_account, master_account, name, snapshot_time FROM hyperliquid_sub_accounts WHERE master_account = lower('\''0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'\'') AND block_number = (SELECT max(block_number) FROM hyperliquid_sub_accounts) ORDER BY name LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"sub_account": "0x1a2B3c4D5e6F7a8b9C0d1E2f3A4b5C6d7E8f9A0",
"master_account": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"name": "BTC Trading",
"snapshot_time": "2026-03-25 10:45:30.000"
},
{
"sub_account": "0x2b3C4d5E6f7A8b9C0d1E2f3A4b5C6d7E8f9A0b1",
"master_account": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"name": "ETH Perps",
"snapshot_time": "2026-03-25 10:45:30.000"
},
{
"sub_account": "0x3c4D5e6F7a8B9c0D1e2F3a4B5c6D7e8F9a0B1c2",
"master_account": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"name": "Spot Holdings",
"snapshot_time": "2026-03-25 10:45:30.000"
}
],
"meta": [
{"name": "sub_account", "type": "FixedString(42)"},
{"name": "master_account", "type": "FixedString(42)"},
{"name": "name", "type": "String"},
{"name": "snapshot_time", "type": "DateTime64(3, 'UTC')"}
],
"rows": 3,
"statistics": {
"elapsed": 0.015,
"rows_read": 8,
"bytes_read": 1234
}
}
Bot/Agent Lookups
Find which bot or app submitted trades for a user.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "-- Replace address to find agents for a specific user\nSELECT agent, user, name, valid_until, snapshot_time FROM hyperliquid_agents WHERE user = lower('\''0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'\'') AND block_number = (SELECT max(block_number) FROM hyperliquid_agents) ORDER BY name LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"agent": "0x4d5E6f7A8b9C0d1E2f3A4b5C6d7E8f9A0b1C2d3",
"user": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"name": "Grid Bot v2",
"valid_until": "2026-06-25 00:00:00.000",
"snapshot_time": "2026-03-25 10:45:30.000"
},
{
"agent": "0x5e6F7a8B9c0D1e2F3a4B5c6D7e8F9a0B1c2D3e4",
"user": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"name": "Market Maker Pro",
"valid_until": "2026-12-31 23:59:59.000",
"snapshot_time": "2026-03-25 10:45:30.000"
},
{
"agent": "0x6f7A8b9C0d1E2f3A4b5C6d7E8f9A0b1C2d3E4f5",
"user": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"name": "Sniper Bot",
"valid_until": "2026-09-15 12:00:00.000",
"snapshot_time": "2026-03-25 10:45:30.000"
}
],
"meta": [
{"name": "agent", "type": "FixedString(42)"},
{"name": "user", "type": "FixedString(42)"},
{"name": "name", "type": "String"},
{"name": "valid_until", "type": "DateTime64(3, 'UTC')"},
{"name": "snapshot_time", "type": "DateTime64(3, 'UTC')"}
],
"rows": 3,
"statistics": {
"elapsed": 0.012,
"rows_read": 5,
"bytes_read": 890
}
}
Display Name Lookups
Resolve addresses to human-readable display names.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT user, display_name, snapshot_time FROM hyperliquid_display_names WHERE block_number = (SELECT max(block_number) FROM hyperliquid_display_names) ORDER BY display_name LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"user": "0xa1b2C3d4E5f6A7b8C9d0E1f2A3b4C5d6E7f8A9b0",
"display_name": "AlphaTrader",
"snapshot_time": "2026-03-25 10:45:30.000"
},
{
"user": "0xb2C3d4E5f6A7b8C9d0E1f2A3b4C5d6E7f8A9b0C1",
"display_name": "BetaMaker",
"snapshot_time": "2026-03-25 10:45:30.000"
},
{
"user": "0xc3D4e5F6a7B8c9D0e1F2a3B4c5D6e7F8a9B0c1D2",
"display_name": "CryptoWhale",
"snapshot_time": "2026-03-25 10:45:30.000"
}
],
"meta": [
{"name": "user", "type": "FixedString(42)"},
{"name": "display_name", "type": "String"},
{"name": "snapshot_time", "type": "DateTime64(3, 'UTC')"}
],
"rows": 3,
"statistics": {
"elapsed": 0.019,
"rows_read": 456,
"bytes_read": 8901
}
}
Full Portfolio View
Unified portfolio across perps, spot, vaults, and staking (replace address).
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "-- Replace address below for full portfolio snapshot\nSELECT '\''perps'\'' AS type, coin AS asset, size AS amount, entry_notional AS extra FROM hyperliquid_clearinghouse_states WHERE user = lower('\''0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'\'') AND block_number = (SELECT max(block_number) FROM hyperliquid_clearinghouse_states) AND size != 0 UNION ALL SELECT '\''spot'\'', token, total, escrowed FROM hyperliquid_spot_clearinghouse_states WHERE user = lower('\''0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'\'') AND block_number = (SELECT max(block_number) FROM hyperliquid_spot_clearinghouse_states) AND total != 0 UNION ALL SELECT '\''vault'\'', vault_name, toInt64(ownership_fraction * 1000000), net_deposits FROM hyperliquid_vault_equities WHERE depositor = lower('\''0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'\'') AND block_number = (SELECT max(block_number) FROM hyperliquid_vault_equities) UNION ALL SELECT '\''delegation'\'', validator, toInt64(reward), toInt64(commission_bps) FROM hyperliquid_delegator_rewards WHERE delegator = lower('\''0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'\'') AND block_number = (SELECT max(block_number) FROM hyperliquid_delegator_rewards) LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"type": "perps",
"asset": "BTC",
"amount": "2.500000000000000000",
"extra": "238580.625000000000000000"
},
{
"type": "perps",
"asset": "ETH",
"amount": "-15.750000000000000000",
"extra": "-51120.562500000000000000"
},
{
"type": "spot",
"asset": "USDC",
"amount": "125678.450000000000000000",
"extra": "5000.000000000000000000"
}
],
"meta": [
{"name": "type", "type": "String"},
{"name": "asset", "type": "String"},
{"name": "amount", "type": "Decimal(38, 18)"},
{"name": "extra", "type": "Decimal(38, 18)"}
],
"rows": 3,
"statistics": {
"elapsed": 0.067,
"rows_read": 234,
"bytes_read": 12345
}
}
Builders Query
Query frontend application activity and builder fee distribution metrics.
Builder Activity (24h)
Builder (frontend) transaction volume.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT b.builder, l.builder_name, count() AS tx_count, sum(b.builder_fee) AS total_fees, uniqExact(b.user) AS unique_users FROM hyperliquid_builder_transactions b LEFT JOIN hyperliquid_builder_labels l ON b.builder = l.builder_address WHERE b.block_time > now() - INTERVAL 24 HOUR GROUP BY b.builder, l.builder_name ORDER BY total_fees DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"builder": "0x0000000000000000000000000000000000000000",
"builder_name": "Hyperliquid",
"tx_count": 98765,
"total_fees": "12345.678901234567890123",
"unique_users": 5678
},
{
"builder": "0x1a2B3c4D5e6F7a8b9C0d1E2f3A4b5C6d7E8f9A0",
"builder_name": "Rage Trade",
"tx_count": 23456,
"total_fees": "3456.789012345678901234",
"unique_users": 1234
},
{
"builder": "0x2b3C4d5E6f7A8b9C0d1E2f3A4b5C6d7E8f9A0b1",
"builder_name": "HyperDEX",
"tx_count": 15678,
"total_fees": "2345.678901234567890123",
"unique_users": 987
}
],
"meta": [
{"name": "builder", "type": "FixedString(42)"},
{"name": "builder_name", "type": "String"},
{"name": "tx_count", "type": "UInt64"},
{"name": "total_fees", "type": "Decimal(38, 18)"},
{"name": "unique_users", "type": "UInt64"}
],
"rows": 3,
"statistics": {
"elapsed": 0.123,
"rows_read": 234567,
"bytes_read": 12345678
}
}
Builder Fill Volume (24h)
Trading volume routed through builder apps (Phantom, Based, etc.).
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT builder_address, count() AS fills, sum(price * size) AS volume_usd, sum(builder_fee) AS total_builder_fees, uniqExact(user) AS unique_users FROM hyperliquid_builder_fills WHERE block_time > now() - INTERVAL 24 HOUR GROUP BY builder_address ORDER BY volume_usd DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"builder_address": "0x0000000000000000000000000000000000000000",
"fills": 45678,
"volume_usd": "1245678901.234567890123456789012345678901234567",
"total_builder_fees": "6228.394506172839450617",
"unique_users": 3456
},
{
"builder_address": "0x1a2B3c4D5e6F7a8b9C0d1E2f3A4b5C6d7E8f9A0",
"fills": 12345,
"volume_usd": "345678901.234567890123456789012345678901234567",
"total_builder_fees": "1728.394506172839450617",
"unique_users": 987
},
{
"builder_address": "0x2b3C4d5E6f7A8b9C0d1E2f3A4b5C6d7E8f9A0b1",
"fills": 8765,
"volume_usd": "234567890.123456789012345678901234567890123456",
"total_builder_fees": "1172.839450617283945061",
"unique_users": 654
}
],
"meta": [
{"name": "builder_address", "type": "FixedString(42)"},
{"name": "fills", "type": "UInt64"},
{"name": "volume_usd", "type": "Decimal(38, 36)"},
{"name": "total_builder_fees", "type": "Decimal(38, 18)"},
{"name": "unique_users", "type": "UInt64"}
],
"rows": 3,
"statistics": {
"elapsed": 0.234,
"rows_read": 456789,
"bytes_read": 23456789
}
}
Analytics Queries
Access pre-aggregated analytics data for funding rates, liquidations, OHLCV, and platform-wide metrics.
Funding Rate Summary (Hourly)
Pre-aggregated hourly funding rates by coin.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT coin, hour, avg_funding_rate, total_funding, unique_users FROM hyperliquid_funding_summary_hourly WHERE hour > now() - INTERVAL 24 HOUR ORDER BY hour DESC, abs(avg_funding_rate) DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"coin": "BTC",
"hour": "2026-03-25 10:00:00",
"avg_funding_rate": "0.000042000000000000",
"total_funding": "1234.567890123456789012",
"unique_users": 456
},
{
"coin": "ETH",
"hour": "2026-03-25 10:00:00",
"avg_funding_rate": "0.000035000000000000",
"total_funding": "876.543210987654321098",
"unique_users": 389
},
{
"coin": "DOGE",
"hour": "2026-03-25 10:00:00",
"avg_funding_rate": "-0.000028000000000000",
"total_funding": "-234.567890123456789012",
"unique_users": 234
}
],
"meta": [
{"name": "coin", "type": "LowCardinality(String)"},
{"name": "hour", "type": "DateTime"},
{"name": "avg_funding_rate", "type": "Decimal(38, 18)"},
{"name": "total_funding", "type": "Decimal(38, 18)"},
{"name": "unique_users", "type": "UInt64"}
],
"rows": 3,
"statistics": {
"elapsed": 0.045,
"rows_read": 2400,
"bytes_read": 123456
}
}
Daily Liquidation Stats
Pre-aggregated daily liquidation counts and volume by coin.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT day, coin, liquidation_count, liquidated_volume, unique_liquidated_users FROM hyperliquid_liquidations_daily ORDER BY day DESC, liquidated_volume DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"day": "2026-03-25",
"coin": "BTC",
"liquidation_count": 45,
"liquidated_volume": "2345678.901234567890123456",
"unique_liquidated_users": 38
},
{
"day": "2026-03-25",
"coin": "ETH",
"liquidation_count": 67,
"liquidated_volume": "1234567.890123456789012345",
"unique_liquidated_users": 52
},
{
"day": "2026-03-25",
"coin": "SOL",
"liquidation_count": 89,
"liquidated_volume": "567890.123456789012345678",
"unique_liquidated_users": 71
}
],
"meta": [
{"name": "day", "type": "Date"},
{"name": "coin", "type": "LowCardinality(String)"},
{"name": "liquidation_count", "type": "UInt64"},
{"name": "liquidated_volume", "type": "Decimal(38, 18)"},
{"name": "unique_liquidated_users", "type": "UInt64"}
],
"rows": 3,
"statistics": {
"elapsed": 0.028,
"rows_read": 150,
"bytes_read": 12345
}
}
Hourly OHLCV
Pre-aggregated hourly candlestick data per coin.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT coin, hour, volume, trade_count, high, low, open, close FROM hyperliquid_market_volume_hourly WHERE hour > now() - INTERVAL 24 HOUR AND coin = '\''BTC'\'' ORDER BY hour DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"coin": "BTC",
"hour": "2026-03-25 10:00:00",
"volume": "124567890.123456789012345678",
"trade_count": 3456,
"high": "95678.500000000000000000",
"low": "95234.250000000000000000",
"open": "95432.500000000000000000",
"close": "95567.750000000000000000"
},
{
"coin": "BTC",
"hour": "2026-03-25 09:00:00",
"volume": "145678901.234567890123456789",
"trade_count": 3821,
"high": "95789.250000000000000000",
"low": "95123.500000000000000000",
"open": "95567.750000000000000000",
"close": "95432.500000000000000000"
},
{
"coin": "BTC",
"hour": "2026-03-25 08:00:00",
"volume": "98765432.109876543210987654",
"trade_count": 2987,
"high": "95456.750000000000000000",
"low": "94876.250000000000000000",
"open": "95123.500000000000000000",
"close": "95234.500000000000000000"
}
],
"meta": [
{"name": "coin", "type": "LowCardinality(String)"},
{"name": "hour", "type": "DateTime"},
{"name": "volume", "type": "Decimal(38, 18)"},
{"name": "trade_count", "type": "UInt64"},
{"name": "high", "type": "Decimal(38, 18)"},
{"name": "low", "type": "Decimal(38, 18)"},
{"name": "open", "type": "Decimal(38, 18)"},
{"name": "close", "type": "Decimal(38, 18)"}
],
"rows": 3,
"statistics": {
"elapsed": 0.034,
"rows_read": 720,
"bytes_read": 45678
}
}
Daily Per-Coin Metrics
Volume, fills, traders, fees, and liquidations per coin per day.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT day, coin, volume_usd, fill_count, unique_traders, fees, liquidations, high_price, low_price FROM hyperliquid_metrics_dex_overview ORDER BY day DESC, volume_usd DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"day": "2026-03-25",
"coin": "BTC",
"volume_usd": "2847561234.567890123456789012",
"fill_count": 45673,
"unique_traders": 3456,
"fees": "14237.806172839506172840",
"liquidations": 45,
"high_price": "96785.500000000000000000",
"low_price": "94125.000000000000000000"
},
{
"day": "2026-03-25",
"coin": "ETH",
"volume_usd": "1245789345.123456789012345678",
"fill_count": 38912,
"unique_traders": 2987,
"fees": "6228.946725617283945061",
"liquidations": 67,
"high_price": "3289.750000000000000000",
"low_price": "3198.250000000000000000"
},
{
"day": "2026-03-25",
"coin": "SOL",
"volume_usd": "456123789.456789012345678901",
"fill_count": 52341,
"unique_traders": 4123,
"fees": "2280.618947283945061728",
"liquidations": 89,
"high_price": "144.850000000000000000",
"low_price": "140.150000000000000000"
}
],
"meta": [
{"name": "day", "type": "Date"},
{"name": "coin", "type": "LowCardinality(String)"},
{"name": "volume_usd", "type": "Decimal(38, 18)"},
{"name": "fill_count", "type": "UInt64"},
{"name": "unique_traders", "type": "UInt64"},
{"name": "fees", "type": "Decimal(38, 18)"},
{"name": "liquidations", "type": "UInt64"},
{"name": "high_price", "type": "Decimal(38, 18)"},
{"name": "low_price", "type": "Decimal(38, 18)"}
],
"rows": 3,
"statistics": {
"elapsed": 0.056,
"rows_read": 450,
"bytes_read": 34567
}
}
Platform Daily Overview
Platform-wide daily volume, fills, traders, and fees.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT day, total_volume_usd, total_fills, active_traders, total_fees, liquidation_count, liquidation_volume_usd, coins_traded, total_builder_fees, builder_fill_count FROM hyperliquid_metrics_overview ORDER BY day DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"day": "2026-03-25",
"total_volume_usd": "5678901234.567890123456789012",
"total_fills": 156789,
"active_traders": 12345,
"total_fees": "28394.506172839506172840",
"liquidation_count": 234,
"liquidation_volume_usd": "4567890.123456789012345678",
"coins_traded": 125,
"total_builder_fees": "8518.351851851851851852",
"builder_fill_count": 78945
},
{
"day": "2026-03-24",
"total_volume_usd": "6234567890.123456789012345678",
"total_fills": 167234,
"active_traders": 13456,
"total_fees": "31172.839450617283945061",
"liquidation_count": 198,
"liquidation_volume_usd": "3456789.012345678901234567",
"coins_traded": 128,
"total_builder_fees": "9351.701482370973425295",
"builder_fill_count": 84123
},
{
"day": "2026-03-23",
"total_volume_usd": "4987654321.098765432109876543",
"total_fills": 145678,
"active_traders": 11234,
"total_fees": "24938.271604938271604938",
"liquidation_count": 156,
"liquidation_volume_usd": "2345678.901234567890123456",
"coins_traded": 121,
"total_builder_fees": "7481.481481481481481481",
"builder_fill_count": 73456
}
],
"meta": [
{"name": "day", "type": "Date"},
{"name": "total_volume_usd", "type": "Decimal(38, 18)"},
{"name": "total_fills", "type": "UInt64"},
{"name": "active_traders", "type": "UInt64"},
{"name": "total_fees", "type": "Decimal(38, 18)"},
{"name": "liquidation_count", "type": "UInt64"},
{"name": "liquidation_volume_usd", "type": "Decimal(38, 18)"},
{"name": "coins_traded", "type": "UInt64"},
{"name": "total_builder_fees", "type": "Decimal(38, 18)"},
{"name": "builder_fill_count", "type": "UInt64"}
],
"rows": 3,
"statistics": {
"elapsed": 0.023,
"rows_read": 30,
"bytes_read": 4567
}
}
Staking Queries
Access staking delegation events, undelegations, and validator reward distributions.
Staking Events
Recent staking deposits, withdrawals, and delegations.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT time, event_type, user, amount, validator, is_undelegate, is_finalized, hash FROM hyperliquid_staking_events ORDER BY block_number DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"time": "2026-03-25 10:42:15.000",
"event_type": "delegate",
"user": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"amount": "10000.000000000000000000",
"validator": "0xa1b2C3d4E5f6A7b8C9d0E1f2A3b4C5d6E7f8A9b0",
"is_undelegate": 0,
"is_finalized": 1,
"hash": "0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b"
},
{
"time": "2026-03-25 10:38:42.000",
"event_type": "undelegate",
"user": "0x9f8e7D6c5B4a3F2e1D0c9B8a7F6e5D4c3B2a1F0",
"amount": "5000.000000000000000000",
"validator": "0xb2C3d4E5f6A7b8C9d0E1f2A3b4C5d6E7f8A9b0C1",
"is_undelegate": 1,
"is_finalized": 0,
"hash": "0x2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3"
},
{
"time": "2026-03-25 10:25:18.000",
"event_type": "delegate",
"user": "0x5a6B7c8D9e0F1a2b3C4d5E6f7A8b9C0d1E2f3A4",
"amount": "25000.000000000000000000",
"validator": "0xc3D4e5F6a7B8c9D0e1F2a3B4c5D6e7F8a9B0c1D2",
"is_undelegate": 0,
"is_finalized": 1,
"hash": "0x3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4"
}
],
"meta": [
{"name": "time", "type": "DateTime64(3, 'UTC')"},
{"name": "event_type", "type": "String"},
{"name": "user", "type": "FixedString(42)"},
{"name": "amount", "type": "Decimal(38, 18)"},
{"name": "validator", "type": "FixedString(42)"},
{"name": "is_undelegate", "type": "UInt8"},
{"name": "is_finalized", "type": "UInt8"},
{"name": "hash", "type": "FixedString(66)"}
],
"rows": 3,
"statistics": {
"elapsed": 0.021,
"rows_read": 3,
"bytes_read": 567
}
}
Validator Rewards
Recent validator reward distributions.
- Request
- Response
curl -X POST 'https://api.quicknode.com/sql/rest/v1/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"query": "SELECT time, validator, reward, block_number FROM hyperliquid_validator_rewards ORDER BY block_number DESC LIMIT 3",
"clusterId": "hyperliquid-core-mainnet"
}'
{
"data": [
{
"time": "2026-03-25 10:45:30.000",
"validator": "0xa1b2C3d4E5f6A7b8C9d0E1f2A3b4C5d6E7f8A9b0",
"reward": "1234.567890123456789012",
"block_number": 15678934
},
{
"time": "2026-03-25 10:45:30.000",
"validator": "0xb2C3d4E5f6A7b8C9d0E1f2A3b4C5d6E7f8A9b0C1",
"reward": "987.654321098765432109",
"block_number": 15678934
},
{
"time": "2026-03-25 10:45:30.000",
"validator": "0xc3D4e5F6a7B8c9D0e1F2a3B4c5D6e7F8a9B0c1D2",
"reward": "765.432109876543210987",
"block_number": 15678934
}
],
"meta": [
{"name": "time", "type": "DateTime64(3, 'UTC')"},
{"name": "validator", "type": "FixedString(42)"},
{"name": "reward", "type": "Decimal(38, 18)"},
{"name": "block_number", "type": "UInt64"}
],
"rows": 3,
"statistics": {
"elapsed": 0.009,
"rows_read": 3,
"bytes_read": 234
}
}
Additional Resources
For more information on using the SQL Explorer REST API:
- REST API Overview - Learn about authentication, making requests, and response formats
- SQL Explorer Dashboard - Test queries before integrating them into your code
We ❤️ Feedback!
If you have any feedback or questions about this documentation, let us know. We'd love to hear from you!