Pinax
AppContact usDocs

Blog
HyperLiquid

Perp Exchange

Production-grade HyperLiquid data — markets, OHLC, open interest, liquidations, vaults and per-user activity — through a single HTTP API.

Power perps trading agents, copy-trading apps, leaderboards and risk dashboards with on-chain HyperCore data enriched with HyperLiquid orderbook metadata. Part of Pinax API.

  • Read-only REST endpoints covering markets, OHLC, OI, activity, liquidations, users, positions, vaults and platform aggregates
  • Native HyperCore events enriched with perpetual orderbook + funding metadata

What you get with the Perp Exchange API

14 REST endpoints

DEXes, markets, OHLC, OI, activity, liquidations, users, positions, vaults, platform

HyperCore native

Trades, funding, splits, redemptions, liquidations — at the tx level

Per-user PNL

Realized + unrealized P&L, leverage, margin, position health

Sub-minute refresh

Aggregated leaderboards and platform stats updated continuously

// 01 · Platform activity

24-hour macro

Aggregate notional, trades, funding and liquidations across every HyperLiquid perp.
Queried live via /v1/hyperliquid/platform.

Notional volume · 24h rolling↗ +12.4% over window
$3.16B
Aggregate perp notional across all HyperLiquid markets. Bucket avg $316.02M · trades 2.31M · active coins 334.
Buy vs. sell flow · window
1.12×Buy-side dominated 7 of 10 buckets. $1.67B buy vs $1.49B sell across $3.16B total flow.
53.0%BUY
SELL47.0%
Buy volume$1.67B
Sell volume$1.49B
Active coinslive
334coins
Active coins traded this bucket
Total trades↗ 230.7k/hr
2.31M
1.10M buys · 1.21M sells
Total feesvol-weighted
$398.89k
Total fees collected · vol-weighted
Liquidations↘ $27.33M
7,973events
27.33M forced exits over window
// 02 · Supported DEX

Coverage

Every supported HyperLiquid + HyperCore perp dex with assets, 24h volume, trades and unique users.
Queried live via /v1/hyperliquid/dexes.

P
perps
184 assets · 2.73M trades · 24h · 36.0k users · 24h
Live
X
xyz
59 assets · 1.56M trades · 24h · 15.4k users · 24h
Live
C
cash
15 assets · 1.11M trades · 24h · 447 users · 24h
Live
S
spot
65 assets · 160.1k trades · 24h · 6.2k users · 24h
Live
K
km
22 assets · 60.6k trades · 24h · 546 users · 24h
Live
F
flx
15 assets · 8.6k trades · 24h · 169 users · 24h
Live
H
hyna
22 assets · 19.0k trades · 24h · 382 users · 24h
Live
V
vntl
13 assets · 5.0k trades · 24h · 478 users · 24h
Live
P
para
3 assets · 577 trades · 24h · 51 users · 24h
Live
O
outcome
8 assets · 23.7k trades · 24h · 1.8k users · 24h
Live
// 03 · Longs & Shorts

Bias by market

Open-Interest-weighted long/short split and annualized funding for the top 6 markets. + rate = shorts pay longs; − rate = longs pay shorts.
Queried live via /v1/hyperliquid/markets/oi.

BTC
$2.4B
57% L
43% S
+10.95%
shorts → longs
xyz:CL
$227M
70% L
30% S
−145.61%
longs → shorts
ETH
$1.2B
60% L
40% S
+10.95%
shorts → longs
xyz:BRENTOIL
$273M
63% L
37% S
+5.47%
shorts → longs
SOL
$369M
68% L
32% S
+10.95%
shorts → longs
xyz:SILVER
$70M
70% L
30% S
+5.47%
shorts → longs
top 6 markets · sorted by Open Interestaggregate L/S 59.7% / 40.3%refresh ≤ 60s
// 04 · Liquidations

Liquidations

30d liquidation flow split by side, plus a top-10 market breakdown across the last 500 events.
Queried live via /v1/hyperliquid/markets/liquidations/ohlc.

Liquidations · 30d total · BTC
$670.78M
74,681 events · avg ticket $9.0k · max $24.41M (BTC, short).
LONG · $194.63MSHORT · $476.16M
$83.91M$41.95M0$41.95M$83.91M04-1004-1504-2004-2504-3005-0505-09
Breakdown · top 10 markets
Last 436 liquidation events · 2026-04-09 13:56 → 2026-05-09 01:50 UTC.
MarketEventsLong #Short #Long $Short $NotionalShare
BTC20856152$57.60M$316.41M$374.01M59.1%
xyz:CL664719$53.91M$36.25M$90.16M14.3%
ETH362511$42.84M$18.40M$61.24M9.7%
xyz:BRENTOIL402515$36.14M$16.59M$52.73M8.3%
xyz:SP50017017$0.00$15.98M$15.98M2.5%
xyz:XYZ100909$0.00$10.93M$10.93M1.7%
ZEC817$499.8k$7.81M$8.31M1.3%
SOL505$0.00$6.91M$6.91M1.1%
ZRO440$6.41M$0.00$6.41M1.0%
xyz:SNDK817$450.3k$5.50M$5.95M0.9%
// 05 · 21d liquidation heatmap

BTC & ETH heatmap

Daily perp liquidation volume — last 3 complete weeks (Mon–Sun), today excluded. Hover a cell for full daily metrics. Queried via /v1/hyperliquid/markets/liquidations/ohlc.

HyperLiquid Website →
low
high
BTC logo
BTC · 3w total
$411.54M
48,103 events · peak $51.18M · Tue May 05
BTC-PERP
Mon
Tue
Wed
Thu
Fri
Sat
Sun
18
Apr
19
Apr
20
Apr
21
Apr
22
Apr
23
Apr
24
Apr
25
Apr
26
Apr
27
Apr
28
Apr
29
Apr
30
Apr
01
May
02
May
03
May
04
May
05
May
06
May
07
May
08
May
2026-04-182026-05-08
ETH logo
ETH · 3w total
$94.06M
10,171 events · peak $21.53M · Wed Apr 29
ETH-PERP
Mon
Tue
Wed
Thu
Fri
Sat
Sun
18
Apr
19
Apr
20
Apr
21
Apr
22
Apr
23
Apr
24
Apr
25
Apr
26
Apr
27
Apr
28
Apr
29
Apr
30
Apr
01
May
02
May
03
May
04
May
05
May
06
May
07
May
08
May
2026-04-182026-05-08
// 06 · Whale profile

Lifetime Trader Card

Lifetime aggregates for 0xecb6…2b00 across every HyperLiquid market. One call: /v1/hyperliquid/users?user={addr}.

Lifetime volume
$32.88B
15,051,272 trades across 124 coins · 2026-02-012026-05-08 (96 days)
user
0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00
Notional volume biasbuy $16.70B · sell $16.18B
50.8% BUY
49.2% SELL
Transaction count split7,488,995 buys · 7,562,277 sells
Realized PnL
+$11.74M
+0.036% of volume
Net Funding
+$1.09M
shorts → user (longs paid in)
Total Fees Paid
$19.17M
5.83 bps avg
Liquidation Fills
0
clean book
Coins Traded
124
distinct markets touched
Avg Trade Size
$2.2k
volume / transactions
Daily Volume
$342.55M
over 96 active days
Daily Trades
156,784
trades per day
Net funding sign follows HyperLiquid convention: positive = wallet received funding (held longs while shorts paid, or shorts while longs paid), negative = wallet paid funding to the other side.
// 07 · User activity insights

Trader Footprint

Last 500 ledger events for 0xecb6…2b00: deposits, withdrawals, funding flows. Queried via /v1/hyperliquid/users/activity.

Events
500
Net flow
+$3.62M
Net funding
+$7.8k
Markets touched
122
Window UTC
05-08 21:00 → 05-09 01:33
Event type breakdown
TypeCountGrossNet
funding499$8.2k+$7.8k
deposit1$3.62M+$3.62M
Deposits +$3.62M · Withdrawals +$0.0000 · Funding gross $8.2k.
Top 10 markets · funding gross
MarketTicksGrossNet
ZEC4$1.5k+$1.5k
ETH4$1.2k+$1.2k
XPL4$735.89+$735.89
SOL4$689.27+$689.27
ENA4$574.27+$574.27
FARTCOIN4$316.16+$316.16
ASTER4$301.11+$301.11
DOGE4$206.35+$206.35
MON4$186.59+$186.59
HYPE4$183.53+$183.53
Worst payer: JUP (-$27.71). Best earner: ZEC (+$1.5k).
// 08 · User leaderboards

BTC Trader Leaderboards

Top 10 wallets across volume, PnL, activity, and funding flow on BTC-PERP. Each board flips sort_by / order_by on /v1/hyperliquid/users.

Top Volume
?sort_by=total_volume&order_by=desc
Volume
  1. 01
    0xecb6…2b00
    15,087,531 tx · 124 coins · 02-0105-09
    $32.93B
    vol $32.93B
  2. 02
    0xc6ac…8e84
    1,050,263 tx · 1 coin · 02-0105-09
    $28.13B
    vol $28.13B
  3. 03
    0xc926…98d3
    14,975,132 tx · 203 coins · 02-0105-09
    $27.10B
    vol $27.10B
  4. 04
    0xce97…7e78
    6,595,418 tx · 11 coins · 03-0305-09
    $24.17B
    vol $24.17B
  5. 05
    0x7700…4216
    9,665,300 tx · 30 coins · 02-0105-09
    $21.57B
    vol $21.57B
  6. 06
    0x7b7f…dee2
    3,106,200 tx · 11 coins · 02-0105-09
    $21.36B
    vol $21.36B
  7. 07
    0xfc66…ca06
    4,949,695 tx · 66 coins · 02-0105-09
    $19.08B
    vol $19.08B
  8. 08
    0xe3b6…0acb
    836,428 tx · 1 coin · 02-0105-09
    $16.03B
    vol $16.03B
  9. 09
    0xf910…0a2d
    3,786,064 tx · 69 coins · 02-0105-09
    $15.19B
    vol $15.19B
  10. 10
    0x0fd4…e0c7
    1,494,700 tx · 1 coin · 02-0105-09
    $15.10B
    vol $15.10B
Top PnL
?sort_by=realized_pnl&order_by=desc
Realized PnL
  1. 01
    0x35d1…acb1
    88,906 tx · 5 coins · 02-0104-01
    +$40.96M
    vol $143.30M
  2. 02
    0x5b5d…c060
    188,678 tx · 12 coins · 02-0105-04
    +$31.25M
    vol $384.09M
  3. 03
    0x8def…2dae
    939,484 tx · 23 coins · 02-0105-08
    +$26.55M
    vol $907.42M
  4. 04
    0x20c2…44f5
    22,516 tx · 2 coins · 02-0104-22
    +$26.07M
    vol $86.34M
  5. 05
    0xa5b0…1d41
    38,791 tx · 2 coins · 02-0404-29
    +$25.06M
    vol $1.12B
  6. 06
    0x45d2…4029
    102,691 tx · 42 coins · 02-0105-08
    +$23.08M
    vol $109.74M
  7. 07
    0x6c85…84f6
    21,581 tx · 1 coin · 02-1004-29
    +$19.09M
    vol $480.22M
  8. 08
    0x1b52…d41b
    12,120 tx · 2 coins · 02-0303-19
    +$18.51M
    vol $67.59M
  9. 09
    0xeadc…9d55
    212,899 tx · 62 coins · 02-0305-09
    +$18.45M
    vol $458.07M
  10. 10
    0xb83d…6e36
    214,128 tx · 18 coins · 02-0105-08
    +$16.44M
    vol $476.12M
Worst PnL
?sort_by=realized_pnl&order_by=asc
Realized PnL
  1. 01
    0x35d1…acb1
    88,906 tx · 5 coins · 02-0104-01
    +$40.96M
    vol $143.30M
  2. 02
    0x5b5d…c060
    188,678 tx · 12 coins · 02-0105-04
    +$31.25M
    vol $384.09M
  3. 03
    0x8def…2dae
    939,484 tx · 23 coins · 02-0105-08
    +$26.55M
    vol $907.42M
  4. 04
    0x20c2…44f5
    22,516 tx · 2 coins · 02-0104-22
    +$26.07M
    vol $86.34M
  5. 05
    0xa5b0…1d41
    38,791 tx · 2 coins · 02-0404-29
    +$25.06M
    vol $1.12B
  6. 06
    0x45d2…4029
    102,691 tx · 42 coins · 02-0105-08
    +$23.08M
    vol $109.74M
  7. 07
    0x6c85…84f6
    21,581 tx · 1 coin · 02-1004-29
    +$19.09M
    vol $480.22M
  8. 08
    0x1b52…d41b
    12,120 tx · 2 coins · 02-0303-19
    +$18.51M
    vol $67.59M
  9. 09
    0xeadc…9d55
    212,899 tx · 62 coins · 02-0305-09
    +$18.45M
    vol $458.07M
  10. 10
    0xb83d…6e36
    214,128 tx · 18 coins · 02-0105-08
    +$16.44M
    vol $476.12M
Most Active
?sort_by=transactions&order_by=desc
Transactions
  1. 01
    0x31ca…974b
    19,719,511 tx · 191 coins · 02-0105-09
    19,719,511
    vol $3.54B
  2. 02
    0x0104…703a
    19,540,548 tx · 191 coins · 02-0105-09
    19,540,548
    vol $3.68B
  3. 03
    0x3999…3336
    16,432,720 tx · 51 coins · 02-0105-09
    16,432,720
    vol $11.23B
  4. 04
    0xecb6…2b00
    15,059,631 tx · 124 coins · 02-0105-09
    15,059,631
    vol $32.90B
  5. 05
    0xc926…98d3
    14,975,010 tx · 203 coins · 02-0105-09
    14,975,010
    vol $27.10B
  6. 06
    0x1724…9d02
    12,711,994 tx · 13 coins · 02-0505-09
    12,711,994
    vol $1.70B
  7. 07
    0xf5d8…ad53
    10,359,073 tx · 23 coins · 02-0105-09
    10,359,073
    vol $9.54B
  8. 08
    0xcee1…df73
    10,047,145 tx · 4 coins · 02-0105-09
    10,047,145
    vol $485.88M
  9. 09
    0x7700…4216
    9,663,650 tx · 30 coins · 02-0105-09
    9,663,650
    vol $21.57B
  10. 10
    0xc5ed…4346
    9,040,065 tx · 93 coins · 02-0105-09
    9,040,065
    vol $2.23B
Funding Earners
?sort_by=total_funding&order_by=desc
Net Funding
  1. 01
    0x63c7…cb78
    72,132 tx · 9 coins · 02-2705-07
    +$1.47M
    vol $172.61M
  2. 02
    0x1e48…e773
    4,817 tx · 7 coins · 03-0905-07
    +$1.39M
    vol $60.90M
  3. 03
    0x7f5f…f47e
    21,349 tx · 2 coins · 03-1005-08
    +$1.34M
    vol $349.41M
  4. 04
    0xefd3…28df
    835,059 tx · 37 coins · 02-0205-08
    +$1.34M
    vol $5.18B
  5. 05
    0x023a…2355
    3,071,010 tx · 231 coins · 02-0105-09
    +$1.23M
    vol $7.58B
  6. 06
    0x0e0b…e57e
    3,894 tx · 6 coins · 02-2805-06
    +$1.20M
    vol $77.11M
  7. 07
    0xfc66…ca06
    4,949,695 tx · 66 coins · 02-0105-09
    +$1.17M
    vol $19.08B
  8. 08
    0xecb6…2b00
    15,087,531 tx · 124 coins · 02-0105-09
    +$1.10M
    vol $32.93B
  9. 09
    0x7fda…17d1
    617,436 tx · 21 coins · 02-0105-09
    +$929.9k
    vol $1.42B
  10. 10
    0x936c…bb0f
    227,478 tx · 13 coins · 02-0105-09
    +$699.9k
    vol $1.18B
Funding Payers
?sort_by=total_funding&order_by=asc
Net Funding
  1. 01
    0x63c7…cb78
    72,132 tx · 9 coins · 02-2705-07
    +$1.47M
    vol $172.61M
  2. 02
    0x1e48…e773
    4,817 tx · 7 coins · 03-0905-07
    +$1.38M
    vol $60.90M
  3. 03
    0x7f5f…f47e
    21,349 tx · 2 coins · 03-1005-08
    +$1.34M
    vol $349.41M
  4. 04
    0xefd3…28df
    835,059 tx · 37 coins · 02-0205-08
    +$1.33M
    vol $5.18B
  5. 05
    0x023a…2355
    3,061,479 tx · 228 coins · 02-0105-09
    +$1.22M
    vol $7.57B
  6. 06
    0x0e0b…e57e
    3,894 tx · 6 coins · 02-2805-06
    +$1.19M
    vol $77.11M
  7. 07
    0xfc66…ca06
    4,947,250 tx · 66 coins · 02-0105-09
    +$1.16M
    vol $19.07B
  8. 08
    0xecb6…2b00
    15,059,631 tx · 124 coins · 02-0105-09
    +$1.09M
    vol $32.90B
  9. 09
    0x7fda…17d1
    612,296 tx · 21 coins · 02-0105-09
    +$915.7k
    vol $1.41B
  10. 10
    0x936c…bb0f
    227,478 tx · 13 coins · 02-0105-09
    +$700.0k
    vol $1.18B
// 09 · Filter slices

By Coin · By Dex

Same endpoint, different filter — pass coin or dex on /v1/hyperliquid/users to swap the leaderboard scope.

coin=BTC
Top BTC Traders
Lifetime stats restricted to the BTC market.
Top-10 vol
$220.65B
Top-10 trades
61,546,731
Top-10 PnL
+$26.20M
  1. 01
    0xecb6…2b00
    15,087,531 tx · 124 coins · PnL +$11.69M
    $32.93B
    fund +$1.10M
  2. 02
    0xc6ac…8e84
    1,050,263 tx · 1 coin · PnL +$4.91M
    $28.13B
    fund +$52.2k
  3. 03
    0xc926…98d3
    14,975,132 tx · 203 coins · PnL -$346.3k
    $27.10B
    fund +$150.4k
  4. 04
    0xce97…7e78
    6,595,418 tx · 11 coins · PnL +$212.1k
    $24.17B
    fund +$196.2k
  5. 05
    0x7700…4216
    9,665,300 tx · 30 coins · PnL +$1.61M
    $21.57B
    fund +$40.4k
  6. 06
    0x7b7f…dee2
    3,106,200 tx · 11 coins · PnL +$952.1k
    $21.36B
    fund +$12.0k
  7. 07
    0xfc66…ca06
    4,949,695 tx · 66 coins · PnL +$4.07M
    $19.08B
    fund +$1.17M
  8. 08
    0xe3b6…0acb
    836,428 tx · 1 coin · PnL +$1.26M
    $16.03B
    fund +$93.6k
  9. 09
    0xf910…0a2d
    3,786,064 tx · 69 coins · PnL +$137.5k
    $15.19B
    fund +$53.9k
  10. 10
    0x0fd4…e0c7
    1,494,700 tx · 1 coin · PnL +$1.70M
    $15.10B
    fund +$29.4k
dex=perps
Top Perps Traders
Aggregated across every coin on the perps DEX.
Top-10 vol
$220.65B
Top-10 trades
61,546,731
Top-10 PnL
+$26.20M
  1. 01
    0xecb6…2b00
    15,087,531 tx · 124 coins · PnL +$11.69M
    $32.93B
    fund +$1.10M
  2. 02
    0xc6ac…8e84
    1,050,263 tx · 1 coin · PnL +$4.91M
    $28.13B
    fund +$52.2k
  3. 03
    0xc926…98d3
    14,975,132 tx · 203 coins · PnL -$346.3k
    $27.10B
    fund +$150.4k
  4. 04
    0xce97…7e78
    6,595,418 tx · 11 coins · PnL +$212.1k
    $24.17B
    fund +$196.2k
  5. 05
    0x7700…4216
    9,665,300 tx · 30 coins · PnL +$1.61M
    $21.57B
    fund +$40.4k
  6. 06
    0x7b7f…dee2
    3,106,200 tx · 11 coins · PnL +$952.1k
    $21.36B
    fund +$12.0k
  7. 07
    0xfc66…ca06
    4,949,695 tx · 66 coins · PnL +$4.07M
    $19.08B
    fund +$1.17M
  8. 08
    0xe3b6…0acb
    836,428 tx · 1 coin · PnL +$1.26M
    $16.03B
    fund +$93.6k
  9. 09
    0xf910…0a2d
    3,786,064 tx · 69 coins · PnL +$137.5k
    $15.19B
    fund +$53.9k
  10. 10
    0x0fd4…e0c7
    1,494,700 tx · 1 coin · PnL +$1.70M
    $15.10B
    fund +$29.4k
dex=xyz
Top XYZ Index Traders
Stocks/index-style xyz DEX — equity-correlated flow.
Top-10 vol
$220.65B
Top-10 trades
61,546,731
Top-10 PnL
+$26.20M
  1. 01
    0xecb6…2b00
    15,087,531 tx · 124 coins · PnL +$11.69M
    $32.93B
    fund +$1.10M
  2. 02
    0xc6ac…8e84
    1,050,263 tx · 1 coin · PnL +$4.91M
    $28.13B
    fund +$52.2k
  3. 03
    0xc926…98d3
    14,975,132 tx · 203 coins · PnL -$346.3k
    $27.10B
    fund +$150.4k
  4. 04
    0xce97…7e78
    6,595,418 tx · 11 coins · PnL +$212.1k
    $24.17B
    fund +$196.2k
  5. 05
    0x7700…4216
    9,665,300 tx · 30 coins · PnL +$1.61M
    $21.57B
    fund +$40.4k
  6. 06
    0x7b7f…dee2
    3,106,200 tx · 11 coins · PnL +$952.1k
    $21.36B
    fund +$12.0k
  7. 07
    0xfc66…ca06
    4,949,695 tx · 66 coins · PnL +$4.07M
    $19.08B
    fund +$1.17M
  8. 08
    0xe3b6…0acb
    836,428 tx · 1 coin · PnL +$1.26M
    $16.03B
    fund +$93.6k
  9. 09
    0xf910…0a2d
    3,786,064 tx · 69 coins · PnL +$137.5k
    $15.19B
    fund +$53.9k
  10. 10
    0x0fd4…e0c7
    1,494,700 tx · 1 coin · PnL +$1.70M
    $15.10B
    fund +$29.4k
dex=spot
Top Spot Traders
Spot market wallets — no leverage, no funding.
Top-10 vol
$220.65B
Top-10 trades
61,546,731
Top-10 PnL
+$26.20M
  1. 01
    0xecb6…2b00
    15,087,531 tx · 124 coins · PnL +$11.69M
    $32.93B
    fund +$1.10M
  2. 02
    0xc6ac…8e84
    1,050,263 tx · 1 coin · PnL +$4.91M
    $28.13B
    fund +$52.2k
  3. 03
    0xc926…98d3
    14,975,132 tx · 203 coins · PnL -$346.3k
    $27.10B
    fund +$150.4k
  4. 04
    0xce97…7e78
    6,595,418 tx · 11 coins · PnL +$212.1k
    $24.17B
    fund +$196.2k
  5. 05
    0x7700…4216
    9,665,300 tx · 30 coins · PnL +$1.61M
    $21.57B
    fund +$40.4k
  6. 06
    0x7b7f…dee2
    3,106,200 tx · 11 coins · PnL +$952.1k
    $21.36B
    fund +$12.0k
  7. 07
    0xfc66…ca06
    4,949,695 tx · 66 coins · PnL +$4.07M
    $19.08B
    fund +$1.17M
  8. 08
    0xe3b6…0acb
    836,428 tx · 1 coin · PnL +$1.26M
    $16.03B
    fund +$93.6k
  9. 09
    0xf910…0a2d
    3,786,064 tx · 69 coins · PnL +$137.5k
    $15.19B
    fund +$53.9k
  10. 10
    0x0fd4…e0c7
    1,494,700 tx · 1 coin · PnL +$1.70M
    $15.10B
    fund +$29.4k
// 10 · Open positions

Whale Position Book

Live open positions for 0x35d1…acb1 with per-market funding direction. Queried via /v1/hyperliquid/users/positions.

Funding rate convention
+ RATEShorts pay longs. Long holders receive funding; short holders pay. Signals long-side demand pressing mark above index.
− RATELongs pay shorts. Short holders receive funding; long holders pay. Signals short-side demand pressing mark below index.
Rates are reported per-hour. Annualized = hourly × 24 × 365.
Open positions
2
Longs / Shorts
1 / 1
Receiving funding
1
Paying funding
1
MarketSidePosition SizeFunding (1h)Funding (APR)DirectionUpdated
FARTCOINLONG4.20+0.00534%+46.74%RECEIVES ← shorts pay05-09 01:00
PUMPSHORT-4.00+0.00125%+10.95%PAYS → longs05-09 01:00
// 11 · Sample responses

How teams use it

Three patterns we see most often. Each uses a small subset of the endpoints — you can mix them as needed.

01 · BACKTEST

Replay perpetual OHLC

Replay historical bar-by-bar price action per market and stress-test perp strategies against real funding and liquidity events.

Sample response200 OK
[
  {
    "timestamp": "2026-05-07 14:00:00",
    "open": 68412.5,
    "high": 68702.1,
    "low": 68198,
    "close": 68631.4,
    "volume": 142308442.18,
    "trades": 38214,
    "buys": 21118,
    "sells": 17096,
    "unique_takers": 4218,
    "funding_rate": 0.0000091,
    "open_interest": 684120341.55,
    "market": {
      "dex": "hyperliquid",
      "symbol": "BTC-PERP",
      "asset_id": 0,
      "max_leverage": 50,
      "closed": false
    }
  }
]

02 · COPY TRADING

Stream user activity

Watch top traders from the user leaderboard and mirror entries, exits and liquidation events with block-level timing.

Sample response200 OK
[
  {
    "event_type": "trade",
    "timestamp": "2026-05-07 14:38:11",
    "block_num": 85014327,
    "tx_hash": "0xf190865afd395e2f4b8f2e5f8ceb2c05a86d94a73ea411e8a8a3fc649924c420",
    "user": "0x38e598961dd0456a7fb2e758bd433d3e59fb8a4a",
    "side": "long",
    "action": "open",
    "size": 28.1,
    "price": 68412.5,
    "notional": 1922391.25,
    "leverage": 25,
    "fee": 576.72,
    "liquidation": false,
    "market": {
      "dex": "hyperliquid",
      "symbol": "BTC-PERP",
      "asset_id": 0
    }
  }
]

03 · PORTFOLIO

Per-user positions & P&L

Build wallet dashboards and risk monitors that show what a user holds across every HyperLiquid market — with cost basis, leverage and liquidation price.

Sample response200 OK
[
  {
    "user": "0x38e598961dd0456a7fb2e758bd433d3e59fb8a4a",
    "market": {
      "dex": "hyperliquid",
      "symbol": "HYPE-PERP"
    },
    "side": "long",
    "size": 412000,
    "entry_price": 1.812,
    "mark_price": 2.184,
    "liq_price": 1.486,
    "leverage": 10,
    "margin_mode": "isolated",
    "margin_used": 74654.4,
    "unrealized_pnl": 153264,
    "realized_pnl": -21184.5,
    "funding_paid": -1284.18,
    "position_value": 899808,
    "updated_at": "2026-05-07 14:39:02"
  }
]

REST endpoints

See official docs: https://app.pinax.network/docs/perp-exchanges

DEXes

1 endpoint
GET/v1/hyperliquid/dexesList supported HyperLiquid + HyperCore perp dexes with backfill range and 24h notional.

Markets

6 endpoints
GET/v1/hyperliquid/marketsMarket lookup by symbol, asset_id, or dex. Discovery mode with sort / filter.
FREE
GET/v1/hyperliquid/markets/ohlcOHLCV + funding per market. Mark price in USD, USDC for volume and fees.
GET/v1/hyperliquid/markets/oiOpen-interest time-series with long/short split per market.
GET/v1/hyperliquid/markets/activityTrades, opens, closes and funding settlements in chronological order.
GET/v1/hyperliquid/markets/liquidationsLiquidation events with side, leverage, mark price and notional.
GET/v1/hyperliquid/markets/liquidations/ohlcBucketed liquidation OHLC — long-side and short-side notional aggregated per interval.

Users

3 endpoints
GET/v1/hyperliquid/usersUser discovery and lookup with volume / PNL / leverage / liquidation counts.
GET/v1/hyperliquid/users/positionsOpen positions with entry, mark, liq price and isolated/cross margin breakdown.
GET/v1/hyperliquid/users/activityPer-user trade, funding and liquidation feed across every market.

Vaults

2 endpoints
GET/v1/hyperliquid/vaultsHLP and community vaults with TVL, 24h PNL, leader address and follower count.
GET/v1/hyperliquid/vaults/depositorsDepositor leaderboard per vault with cost basis, equity and realized PNL.

Platform

1 endpoint
GET/v1/hyperliquid/platformPlatform-wide volume, open interest, fees, funding and liquidation aggregates.

How it works

Same pattern as the rest of the Pinax API — issue an API key, hit the endpoint, parse the JSON.

1

Request API credentials from Pinax

2

Pick the endpoint for your use case

3

Call it from your app, notebook, or MCP client

4

Ship your strategy, dashboard, or agent

Frequently Asked Questions

Same data, one endpoint.

Markets, OHLC, OI, liquidations, users, vaults — all under /v1/hyperliquid/*. Free tier starts at 100 req/s.

Join Our Newsletter

Signup today to learn about our beta programs for your chain.