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"
[
null,
{
"name": "test",
"fullName": "test dex",
"deployer": "0x5e89b26d8d66da9888c835c9bfcc2aa51813e152",
"oracleUpdater": null,
"feeRecipient": null,
"assetToStreamingOiCap": [["COIN1", "100000.0"], ["COIN2", "200000.0"]],
"assetToFundingMultiplier": [["COIN1", "1.0"], ["COIN2", "2.0"]]
}
]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"
Retrieve User's Active Asset Data
POST https://api.hyperliquid.xyz/info
Headers
Content-Type*
String
"application/json"
Request Body
type*
String
"activeAssetData"
user*
String
Address in 42-character hexadecimal format; e.g. 0x0000000000000000000000000000000000000000.
Retrieve Builder-Deployed Perp Market Limits
POST https://api.hyperliquid.xyz/info
Headers
Content-Type*
String
"application/json"
Request Body
type*
String
"perpDexLimits"
dex*
String
Perp dex name of builder-deployed dex market. The empty string is not allowed.
Get Perp Market Status
POST https://api.hyperliquid.xyz/info
Headers
Content-Type*
String
"application/json"
Request Body
type*
String
"perpDexStatus"
dex*
String
Perp dex name of builder-deployed dex market. The empty string represents the first perp dex.
Last updated