> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.
# metaAndAssetCtxs | Hyperliquid info
> The info endpoint with type: "metaAndAssetCtxs" retrieves comprehensive asset contexts for perpetuals trading on the Hyperliquid exchange.
You can only use this endpoint on the official Hyperliquid public API. It is not available through Chainstack, as the open-source node implementation does not support it yet. See [Hyperliquid methods](/docs/hyperliquid-methods) for the full availability breakdown.
The `info` endpoint with `type: "metaAndAssetCtxs"` retrieves comprehensive asset contexts for perpetuals trading on the Hyperliquid exchange. This endpoint provides both universe metadata defining available assets and real-time market data including mark prices, funding rates, open interest, volume metrics, and price impact information for all perpetual contracts.
## Parameters
### Request body
* `type` (string, required) — The request type. Must be `"metaAndAssetCtxs"` to retrieve asset contexts.
## Response
The response is an array containing two elements: universe metadata and asset contexts. This structure provides both static asset definitions and dynamic market data for all perpetual contracts.
### Response structure
The response contains exactly two elements:
1. **Universe metadata** — Static asset definitions and trading parameters
2. **Asset contexts** — Real-time market data for each asset
### Universe metadata structure
The first element contains the `universe` array with asset definitions:
**Asset identification:**
* `name` — Asset symbol (e.g., "BTC", "ETH", "AVAX")
* Corresponds to the perpetual contract identifier
**Trading parameters:**
* `szDecimals` — Number of decimal places for size precision
* `maxLeverage` — Maximum leverage allowed for this asset
* `onlyIsolated` — Boolean indicating if asset requires isolated margin mode
**Precision and constraints:**
* Size decimals determine minimum order size increments
* Max leverage sets risk management limits
* Isolated margin requirement affects trading strategies
### Asset contexts structure
The second element is an array of market data objects, one for each asset in the universe:
**Price information:**
* `markPx` — Current mark price used for margin calculations
* `midPx` — Mid price between best bid and ask
* `oraclePx` — Oracle price from external price feeds
* `prevDayPx` — Price from 24 hours ago for daily change calculation
**Market depth and impact:**
* `impactPxs` — Array of two impact prices \[buy impact, sell impact]
* Shows expected price impact for market orders
* Useful for assessing market liquidity and slippage
**Funding and premium:**
* `funding` — Current funding rate for the perpetual contract
* `premium` — Premium of mark price over oracle price
* Indicates market sentiment and arbitrage opportunities
**Volume and interest:**
* `dayNtlVlm` — Daily notional volume traded
* `openInterest` — Total open interest across all positions
* Measures market activity and participation
### Data interpretation
**Price relationships:**
* Mark price vs oracle price indicates market premium/discount
* Mid price vs mark price shows funding impact
* Impact prices indicate market depth and liquidity
**Market health indicators:**
* High volume with stable prices indicates healthy liquidity
* Large premium suggests strong directional bias
* High open interest indicates active participation
**Trading insights:**
* Funding rates affect carry costs for positions
* Impact prices help estimate execution costs
* Volume patterns indicate market activity cycles
## Market analysis insights
### Liquidity assessment
**Market depth analysis:**
* Impact prices reveal available liquidity at different levels
* Tight spreads between impact prices indicate deep markets
* Wide spreads suggest lower liquidity or higher volatility
**Volume analysis:**
* Daily notional volume shows market activity levels
* Compare volume across assets to identify active markets
* Volume trends indicate changing market interest
### Funding rate analysis
**Carry cost calculation:**
* Funding rates determine the cost of holding positions
* Positive funding means longs pay shorts
* Negative funding means shorts pay longs
**Market sentiment:**
* Persistent positive funding indicates bullish sentiment
* Persistent negative funding indicates bearish sentiment
* Funding rate changes signal sentiment shifts
### Price discovery insights
**Oracle vs mark price:**
* Premium indicates market's view vs external prices
* Persistent premiums suggest strong directional bias
* Premium convergence indicates arbitrage efficiency
**Price impact assessment:**
* Impact prices help estimate execution costs
* Compare impact across assets for relative liquidity
* Use for optimal order sizing and execution strategies
### Risk management applications
**Leverage constraints:**
* Max leverage varies by asset based on volatility and liquidity
* Isolated margin requirements for certain assets
* Use constraints for position sizing and risk management
**Volatility indicators:**
* Price changes from previous day show daily volatility
* Premium volatility indicates market uncertainty
* Impact price spreads reflect intraday volatility
## Example request
```shell Shell theme={"system"}
curl -X POST \
-H "Content-Type: application/json" \
-d '{"type": "metaAndAssetCtxs"}' \
https://api.hyperliquid.xyz/info
```
```python Python (hyperliquid-python-sdk) theme={"system"}
from hyperliquid.info import Info
from hyperliquid.utils import constants
info = Info(constants.MAINNET_API_URL, skip_ws=True)
# Posts {"type": "metaAndAssetCtxs"} to /info
meta_and_asset_ctxs = info.meta_and_asset_ctxs()
print(meta_and_asset_ctxs)
```
```typescript TypeScript (@nktkas/hyperliquid) theme={"system"}
import { HttpTransport, InfoClient } from "@nktkas/hyperliquid";
const transport = new HttpTransport();
const info = new InfoClient({ transport });
// Posts {"type": "metaAndAssetCtxs"} to /info
const metaAndAssetCtxs = await info.metaAndAssetCtxs();
console.log(metaAndAssetCtxs);
```
## Example response
```json theme={"system"}
[
{
"universe": [
{
"name": "BTC",
"szDecimals": 5,
"maxLeverage": 50
},
{
"name": "ETH",
"szDecimals": 4,
"maxLeverage": 50
},
{
"name": "HPOS",
"szDecimals": 0,
"maxLeverage": 3,
"onlyIsolated": true
}
]
},
[
{
"dayNtlVlm": "1169046.29406",
"funding": "0.0000125",
"impactPxs": [
"14.3047",
"14.3444"
],
"markPx": "14.3161",
"midPx": "14.314",
"openInterest": "688.11",
"oraclePx": "14.32",
"premium": "0.00031774",
"prevDayPx": "15.322"
},
{
"dayNtlVlm": "1426126.295175",
"funding": "0.0000125",
"impactPxs": [
"6.0386",
"6.0562"
],
"markPx": "6.0436",
"midPx": "6.0431",
"openInterest": "1882.55",
"oraclePx": "6.0457",
"premium": "0.00028119",
"prevDayPx": "6.3611"
}
]
]
```
## Use cases
The `info` endpoint with `type: "metaAndAssetCtxs"` is essential for applications that need to:
* **Trading platform development**: Build trading interfaces with real-time market data
* **Market making**: Develop market making strategies using price and liquidity data
* **Risk management**: Implement risk controls based on leverage limits and market conditions
* **Portfolio management**: Manage multi-asset portfolios with comprehensive market context
* **Price discovery**: Analyze price relationships and arbitrage opportunities
* **Liquidity analysis**: Assess market liquidity and execution costs across assets
* **Funding rate strategies**: Develop strategies based on funding rate patterns
* **Market surveillance**: Monitor market conditions and detect anomalies
* **Academic research**: Study perpetual futures markets and price discovery mechanisms
* **Algorithmic trading**: Build automated trading systems with market context
* **Order management**: Optimize order execution based on impact prices and liquidity
* **Market data feeds**: Provide real-time market data to trading applications
* **Analytics platforms**: Build comprehensive market analysis and reporting tools
* **Educational tools**: Create educational content about perpetual futures markets
* **Compliance monitoring**: Monitor market conditions for regulatory compliance
* **Arbitrage detection**: Identify arbitrage opportunities between mark and oracle prices
* **Volatility analysis**: Analyze market volatility patterns across different assets
* **Liquidity provision**: Optimize liquidity provision strategies based on market depth
* **Cross-asset analysis**: Compare market conditions across different perpetual contracts
* **Market timing**: Time market entries and exits based on funding and premium data
* **Position sizing**: Optimize position sizes based on leverage limits and market impact
* **Execution algorithms**: Develop sophisticated execution algorithms using market context
* **Market microstructure research**: Study the microstructure of perpetual futures markets
* **Trading strategy backtesting**: Use historical contexts for strategy development and testing
* **Client advisory**: Provide market insights and trading recommendations to clients
This endpoint provides comprehensive market intelligence, enabling sophisticated trading, risk management, and analysis applications for perpetual futures markets on the Hyperliquid platform.
## OpenAPI
````yaml openapi/hyperliquid_node_api/hypercore_info/info_meta_and_asset_ctxs.json post /info
openapi: 3.0.0
info:
title: Hyperliquid Node API
version: 1.0.0
description: This is an API for interacting with Chainstack Hyperliquid node.
servers:
- url: https://api.hyperliquid.xyz
security: []
paths:
/info:
post:
tags:
- hyperliquid operations
summary: info (metaAndAssetCtxs)
description: >-
Retrieve comprehensive asset contexts for perpetuals trading, including
universe metadata and real-time market data such as mark prices, funding
rates, open interest, and volume metrics.
operationId: infoMetaAndAssetCtxs
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- type
properties:
type:
type: string
enum:
- metaAndAssetCtxs
default: metaAndAssetCtxs
description: >-
The request type. Must be 'metaAndAssetCtxs' to retrieve
asset contexts.
example:
type: metaAndAssetCtxs
responses:
'200':
description: Successful response with asset contexts data
content:
application/json:
schema:
type: array
description: Array containing universe metadata and asset contexts
example:
- universe:
- name: BTC
szDecimals: 5
maxLeverage: 50
- name: ETH
szDecimals: 4
maxLeverage: 50
- name: HPOS
szDecimals: 0
maxLeverage: 3
onlyIsolated: true
- - dayNtlVlm: '1169046.29406'
funding: '0.0000125'
impactPxs:
- '14.3047'
- '14.3444'
markPx: '14.3161'
midPx: '14.314'
openInterest: '688.11'
oraclePx: '14.32'
premium: '0.00031774'
prevDayPx: '15.322'
- dayNtlVlm: '1426126.295175'
funding: '0.0000125'
impactPxs:
- '6.0386'
- '6.0562'
markPx: '6.0436'
midPx: '6.0431'
openInterest: '1882.55'
oraclePx: '6.0457'
premium: '0.00028119'
prevDayPx: '6.3611'
- dayNtlVlm: '809774.565507'
funding: '0.0000125'
impactPxs:
- '8.4505'
- '8.4722'
markPx: '8.4542'
midPx: '8.4557'
openInterest: '2912.05'
oraclePx: '8.4585'
premium: '0.00033694'
prevDayPx: '8.8097'
````