Hyperliquid Perp Trade Token Data
Provides real-time perpetual contract data for tokens on the Hyperliquid exchange. It returns live market prices, liquidity metrics, funding rates, and technical indicators to assist trading analysis.
Endpoint
GET https://api.dapplooker.com/v1/hl-perp-trade
💡 Pro Tips
Use this endpoint to track real-time perp market data like price, funding rate, and open interest for any token on Hyperliquid.
Built-in indicators (RSI, OBV, ATR, MACD, VWAP) help with quick technical analysis and spotting momentum shifts.
14-day OBV is great for gauging recent buy/sell pressure and confirming trend strength.
Great for comparing perps vs. spot trends to catch early trading signals.
This endpoint is x402 payment–enabled, opening access for all users — simply pay and use without needing an API key.
Authentication
This endpoint supports two authentication methods:
Method
Description
API Key
Provide your Loky API key using the api_key parameter for authenticated access.
x402 Payment Protocol
If api_key is not provided, the request automatically uses the x402 protocol for on-chain payment verification.
For seamless integration, user can follow the x402 Quickstart Guide for Buyers.
Query Parameters
Parameter name
Type
Mandatory
Description
api_key
string
No
Your unique API key used for authentication
token_ticker
string
Yes
Ticker symbol of the token (e.g., ETH)
Sample Request
# With Token Ticker
curl --location 'https://api.dapplooker.com/v1/hl-perp-trade?api_key=<API_KEY>&token_ticker=eth'Sample Response
{
"success": true,
"data": {
"symbol": "ETH/USDC:USDC",
"base": "ETH",
"quote": "USDC",
"mark_price": 4497.9,
"mid_price": 4497.85,
"price_change_24h": -124.2,
"price_change_percent_24h": -2.6872065601,
"bid_ask_spread": 0.1,
"bid_ask_spread_percentage_mark": 0.00222325974344391,
"bid_liquidity_0_25_percentage": 14878337.51224,
"ask_liquidity_0_25_percentage": 15286966.75474,
"total_liquidity_0_25_percentage": 30165304.26698,
"order_book_imbalance_percentage": -0.0133297449983543,
"open_interest": {
"usd_value": 3728304320.92932,
"change_percentage_1h": -1.04,
"change_percentage_6h": 0.47,
"change_percentage_24h": 5.69
},
"funding_rate": {
"current_value": 0.0000125,
"next": 0.0000125,
"trajectory": [0.0000125, 0.0000125, 0.0000125, 0.0000125]
},
"obv": {
"1h": 128905.9304,
"4h": 314119.7738,
"1d": 1080978.0376
},
"rsi": {
"15m": 42.9760665973,
"1h": 21.9929542023,
"4h": 43.2866316404
},
"atr": {
"15m": 14.3785714286,
"1h": 26.7285714286,
"4h": 65.0857142857,
"percentage_15m": 0.32,
"percentage_1h": 0.59,
"percentage_4h": 1.45
},
"swing": {
"high_4h": 4637.5,
"low_4h": 4489.5
},
"adx": {
"1h": 23.15,
"4h": 14.84
},
"macd_line_slope": {
"15m": {
"macd_line": -5.4088805216943,
"signal_line": -3.99002320317883,
"histogram": -1.41885731851547
},
"1h": {
"macd_line": -22.4973640944672,
"signal_line": -16.8357496872249,
"histogram": -5.6616144072423
},
"4h": {
"macd_line": -18.4810722690236,
"signal_line": -21.3642324144121,
"histogram": 2.88316014538858
}
},
"vwap": {
"1m": 4543.471238,
"5m": 4543.312768,
"15m": 4542.940152,
"1h": 4543.463474,
"4h": 4527.074638,
"1d": 4453.423779
},
"ema": {
"20_distance_percentage": -0.98,
"200_distance_percentage": -0.37
},
"bollinger": {
"band_width": 3.3236,
"upper_band": 4628.972568,
"lower_band": 4477.637432,
"middle_band": 4553.305
}
}
}Response Fields Explanation
symbol(string): Trading pair symbol for the perpetual contract (e.g., ETH/USDC:USDC).base(string): The base token of the trading pair (e.g., ETH).quote(string): The quote token of the trading pair (e.g., USDC).mark_price(number): The latest fair value price used for liquidation and funding calculations.mid_price(number): The mid-point between the current highest bid and lowest ask.price_change_24h(number): Absolute price change over the last 24 hours.price_change_percent_24h(number): Percentage price change over the last 24 hours.bid_ask_spread(number): The difference between the highest bid and lowest ask.bid_ask_spread_percentage_mark(number): Spread as a percentage of the mark price.bid_liquidity_0_25_percentage(number): Total bid-side liquidity within ±0.25% of mark price.ask_liquidity_0_25_percentage(number): Total ask-side liquidity within ±0.25% of mark price.total_liquidity_0_25_percentage(number): Combined bid + ask liquidity within ±0.25% of mark price.order_book_imbalance_percentage(number): Imbalance ratio between bid and ask liquidity.open_interest(object): Current open positions in the contract.usd_value (number): Total USD value of open interest.
change_percentage_1h / 6h / 24h (number): Percentage change in open interest over time.
funding_rate(object): Funding rate details for perpetuals.current_value (number): Current funding rate.
next (number): Projected next funding rate.
trajectory (array): Forecast of upcoming funding rate values.
obv(object): On-balance volume values for 14 days.15m / 1h / 4h (number): OBV readings across multiple timeframes.
rsi(object): Relative Strength Index values.15m / 1h / 4h (number): RSI readings across multiple timeframes.
atr(object): Average True Range (volatility indicator).15m / 1h / 4h (number): ATR values for different timeframes.
percentage_15m / 1h / 4h (number): ATR expressed as percentage of price.
swing(object): Recent price swing points.high_4h (number): Highest price in last 4 hours.
low_4h (number): Lowest price in last 4 hours.
adx(object): Average Directional Index values for trend strength.1h / 4h (number): ADX readings across timeframes.
macd_line_slope(object): MACD trend indicator data.15m / 1h / 4h (object): Includes
macd_line,signal_line, andhistogram.
vwap(object): Volume-Weighted Average Price across intervals (1m, 5m, 15m, 1h, 4h, 1d).ema(object): Exponential Moving Average distances.20_distance_percentage / 200_distance_percentage (number): Price distance from EMA(20) and EMA(200).
bollinger(object): Bollinger Bands data.band_width (number): Width between upper and lower bands.
upper_band / lower_band / middle_band (number): Bollinger Band levels.
Last updated
Was this helpful?