metaAndAssetCtxs - HyperCore Info Endpoint
Get Hyperliquid perpetual metadata with live asset contexts (funding, open interest, mark, oracle and mid prices, 24h volume) for the default perp DEX or a HIP-3 builder DEX.
Hyperliquid RPC endpoint: endpoint URLs, plans and pricing.
Get the perpetual market metadata and one live asset context per market in a single request. The response uses the public Hyperliquid API shape: [meta, assetCtxs].
Authenticate by including your Dwellir API key in the URL path: https://api-hyperliquid-mainnet-info.n.dwellir.com/YOUR_API_KEY/info.
When to Use This Endpoint
- Market dashboards: Show funding, open interest, mark price and 24h volume for every perp in one call.
- Funding monitors: Read the current funding rate of each market.
- HIP-3 markets: Read the same data for a builder-deployed perp DEX, such as
xyz.
A raw Hyperliquid node does not serve this type. Dwellir builds the response from node data, so it does not count against the public API's rate limits. Each request is billed as one response.
Select a DEX
| Request | Response |
|---|---|
{"type":"metaAndAssetCtxs"} | Default perp DEX |
{"type":"metaAndAssetCtxs","dex":""} | Default perp DEX |
{"type":"metaAndAssetCtxs","dex":"xyz"} | The HIP-3 DEX xyz |
The dex value is case-sensitive. Use a name exactly as perpDexs lists it. Every DEX the node lists is served. A name the node does not list returns HTTP 400 {"error":"unknown dex"}. The public API answers 500 null in that case.
HIP-3 dex requests need Hyperliquid L1 gateway 1.14.0 or later. An earlier version answers HTTP 400 for any non-empty dex.
With a HIP-3 dex, meta is that DEX's meta response. Its universe names carry the <dex>: prefix, such as xyz:NVDA, and it includes marginTables and collateralToken. assetCtxs has one context per universe entry of that DEX.
For spot markets, spotMetaAndAssetCtxs returns [spotMeta, spotAssetCtxs] and ignores dex, as the public API does.
curl -X POST "https://api-hyperliquid-mainnet-info.n.dwellir.com/YOUR_API_KEY/info" \
-H "content-type: application/json" \
-d '{
"type": "metaAndAssetCtxs"
}'Response
meta is the same object that meta returns. assetCtxs has one context per meta.universe entry, in universe order. Match a context to its market by index.
A delisted perp carries "funding":"0.0" and "openInterest":"0.0", and its premium, midPx and impactPxs are null. A listed perp can also have null premium and impactPxs when impact prices are unavailable, and null midPx when its book is not two-sided.
Availability
The endpoint answers HTTP 503 {"error":"asset contexts not ready"} while it warms up after a restart, or while one of its inputs is stale. A HIP-3 DEX that the node lists but that is not ready yet gets the same 503. A HIP-3 DEX never delays the default DEX's response. Retry a 503 with backoff.
Related Endpoints
- meta: Perpetual market metadata only
- perpDexs: All deployed perpetual DEXs and their names
- activeAssetData: Leverage and trade limits for one user and coin
- StreamActiveAssetCtx: Stream the context of one perp over gRPC
Access real-time Hyperliquid market data with Dwellir's HyperCore Info Endpoint. Get your API key →