allPerpMetas | Hyperliquid Info API

curl --request POST \
  --url https://hypercore.goldrushdata.com/info \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "<string>"
}
'

import requests

url = "https://hypercore.goldrushdata.com/info"

payload = { "type": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({type: '<string>'})
};

fetch('https://hypercore.goldrushdata.com/info', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://hypercore.goldrushdata.com/info",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'type' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://hypercore.goldrushdata.com/info"

	payload := strings.NewReader("{\n  \"type\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://hypercore.goldrushdata.com/info")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://hypercore.goldrushdata.com/info")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"type\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "[n]": {
    "universe": [
      {
        "name": "<string>",
        "szDecimals": 123,
        "maxLeverage": 123,
        "marginTableId": 123,
        "isDelisted": true
      }
    ],
    "marginTables": [
      {}
    ],
    "collateralToken": 123
  }
}

POST

info

allPerpMetas | Hyperliquid Info API

curl --request POST \
  --url https://hypercore.goldrushdata.com/info \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "<string>"
}
'

import requests

url = "https://hypercore.goldrushdata.com/info"

payload = { "type": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({type: '<string>'})
};

fetch('https://hypercore.goldrushdata.com/info', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://hypercore.goldrushdata.com/info",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'type' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://hypercore.goldrushdata.com/info"

	payload := strings.NewReader("{\n  \"type\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://hypercore.goldrushdata.com/info")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://hypercore.goldrushdata.com/info")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"type\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "[n]": {
    "universe": [
      {
        "name": "<string>",
        "szDecimals": 123,
        "maxLeverage": 123,
        "marginTableId": 123,
        "isDelisted": true
      }
    ],
    "marginTables": [
      {}
    ],
    "collateralToken": 123
  }
}

Credit Cost

1 per call

Processing

Realtime

The Hyperliquid info endpoint with type: "allPerpMetas" is used to fetch the perpetuals metadata — universe definitions and margin tables — for every perp DEX in a single request.

Estimate your monthly cost for this API using the Pricing Calculator.

GoldRush-native — not part of the original Hyperliquid API. It fans meta out across every perp DEX so you get the whole map in one call.
The response is an array: index 0 is the native Hyperliquid perp DEX; each later entry is a HIP-3 builder-deployed perp DEX, in the same order as perpDexs.
For a single DEX’s metadata, use meta with the dex field — this endpoint is the heavier, all-DEX equivalent.

Returns the full universe and margin tables across every perp DEX on HyperCore. Each element carries a DEX’s universe (its perp asset definitions), its marginTables (leverage-bracket tiers), and the collateralToken index.

Endpoint

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

Request

string

required

Always "allPerpMetas".

Example

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

const response = await fetch("https://hypercore.goldrushdata.com/info", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.GOLDRUSH_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    type: "allPerpMetas",
  }),
});

const allPerpMetas = await response.json();

import os, requests

response = requests.post(
    "https://hypercore.goldrushdata.com/info",
    headers={"Authorization": f"Bearer {os.environ['GOLDRUSH_API_KEY']}"},
    json={"type": "allPerpMetas"},
)

all_perp_metas = response.json()

Response

An array with one entry per perp DEX. Index 0 is the native Hyperliquid perp DEX; later entries are the HIP-3 builder-deployed perp DEXes in perpDexs order.

[
  {
    "universe": [
      { "szDecimals": 5, "name": "BTC", "maxLeverage": 40, "marginTableId": 56 },
      { "szDecimals": 4, "name": "ETH", "maxLeverage": 25, "marginTableId": 55 }
    ],
    "marginTables": [
      [50, { "description": "", "marginTiers": [{ "lowerBound": "0.0", "maxLeverage": 50 }] }]
    ],
    "collateralToken": 0
  }
]

Field descriptions

object

Perpetuals metadata for one perp DEX (index 0 = native Hyperliquid; later = HIP-3 DEXes).

Show properties

array<object>

The DEX’s perp asset definitions.

Show properties

string

Asset name (with the DEX prefix for builder-deployed perps, e.g. xyz:TSLA).

int

Number of decimals for the size field.

int

Maximum leverage for the asset.

int

Margin table id referenced in marginTables.

bool

Present and true if the asset is delisted.

array<[int, object]>

List of [marginTableId, marginTable] pairs for this DEX. Each marginTable has a description and a marginTiers array of { lowerBound, maxLeverage } tiers (decimal-string bounds).

int

Token index used as collateral for this DEX.

perpDeployAuctionStatus

fetch the current perp-deploy Dutch-auction status.

perpDexLimits

fetch the open-interest, position-size, and transfer limits for a HIP-3 perp DEX.

perpDexs

enumerate every HIP-3 builder-deployed perpetual DEX on HyperCore.

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.

See all Hyperliquid endpoints: Overview hub · Info API reference Last reviewed: 2026-07-30

Foundational API

Hyperliquid API

JSON-RPC

Service Keys

Ephemeral Keys

allPerpMetas | Hyperliquid Info API

Credit Cost

Processing

Endpoint

Request

Example

Response

Field descriptions

perpDeployAuctionStatus

perpDexLimits

perpDexs

meta

metaAndAssetCtxs

outcomeMeta

Credit Cost

Processing

​Endpoint

​Request

​Example

​Response

​Field descriptions

​Related endpoints

perpDeployAuctionStatus

perpDexLimits

perpDexs

meta

metaAndAssetCtxs

outcomeMeta

Endpoint

Request

Example

Response

Field descriptions

Related endpoints