Skip to content
Alchemy Logo

Perpetual metadata and asset contexts

This API is in private preview. Target October 2026; timing is subject to change.

Returns perpetual metadata and aligned live market contexts; use it to read the current oracle price alongside mark and mid prices.

Coming with HyperCore. This read is documented but is not yet callable.

POST /{apiKey}/info

ParameterTypeRequiredDescription
typestringYesSelects metaAndAssetCtxs.
dexstringNoPerpetual DEX name; omit for the first perpetual DEX.
{
  "type": "metaAndAssetCtxs",
  "dex": ""
}

FieldTypeDescription
[0]objectMetadata object at tuple index 0.
[0].universe[]arrayOrdered perpetual market definitions aligned to context entries.
[0].universe[].namestringPerpetual market symbol, for example BTC.
[0].universe[].szDecimalsintegerNumber of decimal places accepted for order sizes.
[0].universe[].maxLeverageintegerMaximum leverage permitted for the market.
[0].marginTablesarrayLeverage-tier definitions referenced by marginTableId.
[0].collateralTokenintegerSpot-token index used as collateral.
[1]arrayAligned asset-context array at tuple index 1.
[1][].dayNtlVlmstringRolling 24-hour notional trading volume.
[1][].fundingstringCurrent funding rate for the market.
[1][].impactPxsarray | nullEstimated prices for market-impact calculations on each side, or null when unavailable.
[1][].markPxstringCurrent mark price used for margin and unrealized PnL.
[1][].midPxstring | nullCurrent midpoint between the best bid and ask, or null without both sides.
[1][].openIntereststringTotal open position size, as a decimal string.
[1][].oraclePxstringCurrent external oracle price used by the market.
[1][].premiumstring | nullMark-price premium relative to the oracle price, or null when unavailable.
[1][].prevDayPxstringMarket price approximately 24 hours earlier.

[
  {
    "universe": [{ "name": "BTC", "szDecimals": 5, "maxLeverage": 50 }],
    "marginTables": [],
    "collateralToken": 0
  },
  [
    {
      "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"
    }
  ]
]
Was this page helpful?