Skip to main content
POST
/
info
meta | Hyperliquid Info API
curl --request POST \
  --url https://hypercore.goldrushdata.com/info \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "<string>",
  "dex": "<string>"
}
'
{
  "universe": [
    {
      "name": "<string>",
      "szDecimals": 123,
      "maxLeverage": 123,
      "marginTableId": 123,
      "onlyIsolated": true,
      "isDelisted": true
    }
  ],
  "marginTables": [
    [
      {}
    ]
  ],
  "collateralToken": 123
}

Credit Cost

1 per call

Processing

Realtime
The Hyperliquid info endpoint with type: "meta" is used to fetch the perpetuals universe metadata without live market context.
  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "meta"}.
  • Use metaAndAssetCtxs when you also need live per-asset mark price, funding, open interest, and day volume.
  • The optional dex field takes a perp DEX name. It defaults to the empty string which represents the first perp DEX.
  • For the spot equivalent, use spotMeta.
Returns the static metadata for the entire Hyperliquid perpetuals universe: every coin’s symbol, size-decimal precision, maximum leverage, and the margin-tier table it references. Unlike metaAndAssetCtxs, this payload carries no live market data, so it is cheap to cache and changes only when listings or margin parameters change.

​
Endpoint

POST https://hypercore.goldrushdata.com/info
Authorization: Bearer <GOLDRUSH_API_KEY>
Content-Type: application/json

​
Request

​
type
string
default:"meta"
required
Always "meta".
​
dex
string
HIP-3 builder DEX identifier. Empty string (default) returns the canonical Hyperliquid perp universe. Pass a builder code (e.g. "xyz") to query a HIP-3 deployer’s universe.

​
Example

curl -X POST https://hypercore.goldrushdata.com/info \
  -H "Authorization: Bearer $GOLDRUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "meta",
    "dex": ""
  }'

​
Response

A single JSON object describing the perp universe, the margin-tier tables it references, and the collateral token. 
{
  "universe": [
    { "name": "BTC", "szDecimals": 5, "maxLeverage": 40, "marginTableId": 56 },
    { "name": "ETH", "szDecimals": 4, "maxLeverage": 25, "marginTableId": 55 },
    { "name": "MATIC", "szDecimals": 1, "maxLeverage": 20, "marginTableId": 20, "isDelisted": true }
  ],
  "marginTables": [
    [
      50,
      {
        "description": "",
        "marginTiers": [
          { "lowerBound": "0.0", "maxLeverage": 50 }
        ]
      }
    ]
  ],
  "collateralToken": 0
}

​
Field descriptions

​
universe
array<object>
Array of perp asset metadata.
​
marginTables
array<array>
Margin-tier tables, each a [id, table] tuple. id matches a universe[].marginTableId; table holds a description and a marginTiers array of {lowerBound, maxLeverage} steps describing how max leverage decreases as position notional grows.
​
collateralToken
int
Token index of the collateral asset backing the perp universe (USDC is 0).

metaAndAssetCtxs

fetch the full Hyperliquid perpetuals market universe with live per-asset trading context.

outcomeMeta

enumerate all active HIP-4 binary outcome markets on HyperCore.

spotMeta

fetch the spot universe metadata and full token configuration without live market context.

spotMetaAndAssetCtxs

fetch the spot universe metadata, token configuration, and live market data in a single call.
Last reviewed: 2026-06-13