Perpetuals
The section documents the info endpoints that are specific to perpetuals. See Rate limits section for rate limiting logic and weights.
Retrieve all perpetual dexs
POST
https://api.hyperliquid.xyz/info
Headers
Content-Type*
String
"application/json"
Request Body
type*
String
"perpDexs"
Retrieve perpetuals metadata (universe and margin tables)
POST
https://api.hyperliquid.xyz/info
Headers
Content-Type*
String
"application/json"
Request Body
type*
String
"meta"
dex
String
Perp dex name. Defaults to the empty string which represents the first perp dex.
Retrieve perpetuals asset contexts (includes mark price, current funding, open interest, etc.)
POST
https://api.hyperliquid.xyz/info
Headers
Content-Type*
String
"application/json"
Request Body
type*
String
"metaAndAssetCtxs"
Retrieve user's perpetuals account summary
POST
https://api.hyperliquid.xyz/info
See a user's open positions and margin summary for perpetuals trading
Headers
Content-Type*
"application/json"
Request Body
type*
String
"clearinghouseState"
user*
String
Onchain address in 42-character hexadecimal format; e.g. 0x0000000000000000000000000000000000000000.
dex
String
Perp dex name. Defaults to the empty string which represents the first perp dex.
Retrieve a user's funding history or non-funding ledger updates
POST
https://api.hyperliquid.xyz/info
Note: Non-funding ledger updates include deposits, transfers, and withdrawals.
Headers
Content-Type*
String
"application/json"
Request Body
type*
String
"userFunding" or "userNonFundingLedgerUpdates"
user*
String
Address in 42-character hexadecimal format; e.g. 0x0000000000000000000000000000000000000000.
startTime*
int
Start time in milliseconds, inclusive
endTime
int
End time in milliseconds, inclusive. Defaults to current time.
Retrieve historical funding rates
POST
https://api.hyperliquid.xyz/info
Headers
Content-Type*
String
"application/json"
Request Body
type*
String
"fundingHistory"
coin*
String
Coin, e.g. "ETH"
startTime*
int
Start time in milliseconds, inclusive
endTime
int
End time in milliseconds, inclusive. Defaults to current time.
Retrieve predicted funding rates for different venues
POST
https://api.hyperliquid.xyz/info
Headers
Content-Type*
String
"application/json"
Request Body
type*
String
"predictedFundings"
Query perps at open interest caps
POST
https://api.hyperliquid.xyz/info
Headers
Content-Type*
String
"application/json"
Request Body
type*
String
"perpsAtOpenInterestCap"
Retrieve information about the Perp Deploy Auction
POST
https://api.hyperliquid.xyz/info
Headers
Content-Type*
String
"application/json"
Request Body
type*
String
"perpDeployAuctionStatus"
Last updated