Skip to content
Alchemy Logo

Perpetual metadata

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

Returns perpetual market definitions and margin tiers for a selected DEX.

Available now. This read is served at the interim endpoint today.

POST /{apiKey}/info

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

FieldTypeDescription
universe[]arrayOrdered perpetual market definitions; index aligns with asset contexts.
universe[].namestringPerpetual market symbol, for example BTC.
universe[].szDecimalsintegerNumber of decimal places accepted for order sizes.
universe[].maxLeverageintegerMaximum leverage permitted for the market.
universe[].marginTableIdintegerIdentifier of the leverage-tier table used by this market.
universe[].onlyIsolatedbooleanWhether the market permits isolated margin only.
universe[].isDelistedbooleanWhether trading has been delisted for the market.
universe[].marginModecross | isolatedAllowed margin mode: cross or isolated.
marginTablesarrayLeverage-tier definitions referenced by marginTableId.
marginTables[][0]integerMargin-table identifier referenced by market definitions.
marginTables[][1].descriptionstringHuman-readable description of this margin table.
marginTables[][1].marginTiers[]arrayNotional thresholds and their maximum leverage limits.
marginTables[][1].marginTiers[].lowerBoundstringMinimum notional at which this margin tier applies.
marginTables[][1].marginTiers[].maxLeverageintegerMaximum leverage allowed within this notional tier.

{
  "universe": [{ "name": "BTC", "szDecimals": 5, "maxLeverage": 50 }],
  "marginTables": [
    [
      50,
      {
        "description": "",
        "marginTiers": [{ "lowerBound": "0.0", "maxLeverage": 50 }]
      }
    ]
  ]
}
Was this page helpful?