perpDexStatus | Hyperliquid info

The info endpoint with type: “perpDexStatus” retrieves the current status of a specific perp DEX on Hyperliquid, including total net deposits.

POST /4f8d8f4040bdacd1577bff8058438274/info

info (perpDexStatus)

cURL

curl --request POST \
  --url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "perpDexStatus",
  "dex": "xyz"
}
'

import requests

url = "https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info"

payload = {
    "type": "perpDexStatus",
    "dex": "xyz"
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({type: 'perpDexStatus', dex: 'xyz'})
};

fetch('https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/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://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/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' => 'perpDexStatus',
    'dex' => 'xyz'
  ]),
  CURLOPT_HTTPHEADER => [
    "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://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info"

	payload := strings.NewReader("{\n  \"type\": \"perpDexStatus\",\n  \"dex\": \"xyz\"\n}")

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

	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://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"perpDexStatus\",\n  \"dex\": \"xyz\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"type\": \"perpDexStatus\",\n  \"dex\": \"xyz\"\n}"

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

200

{}

This method is available on Chainstack. Not all Hyperliquid methods are available on Chainstack, as the open-source node implementation does not support them yet — see Hyperliquid methods for the full availability breakdown.

The info endpoint with type: "perpDexStatus" retrieves the current status of a specific perp DEX on Hyperliquid, including total net deposits.

Get your own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

Request body

• type (string, required) — The request type. Must be "perpDexStatus".
• dex (string, required) — Perp DEX name.

Response

The response is an object containing:

• totalNetDeposit (string) — Total net deposits in the perp DEX.

Example request

Shell

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"type": "perpDexStatus", "dex": "xyz"}' \
  https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info

from hyperliquid.info import Info

info = Info("YOUR_CHAINSTACK_ENDPOINT", skip_ws=True)

# The SDK has no dedicated perpDexStatus helper, so post the request directly.
result = info.post("/info", {"type": "perpDexStatus", "dex": "xyz"})
print(result)

import { HttpTransport, InfoClient } from "@nktkas/hyperliquid";

const transport = new HttpTransport({ apiUrl: "YOUR_CHAINSTACK_ENDPOINT" });
const info = new InfoClient({ transport });

const result = await info.perpDexStatus({ dex: "xyz" });
console.log(result);

Use your own endpoint in your code. The code examples use a placeholder Chainstack endpoint (YOUR_CHAINSTACK_ENDPOINT) — replace it with your own Hyperliquid node endpoint from the Chainstack console. The curl above uses a shared public endpoint for quick checks only; do not use it in production.

Example response

{
  "totalNetDeposit": "212751280.0536639988"
}

Use case

The info endpoint with type: "perpDexStatus" is useful for:

• Monitoring the total value locked in a perp DEX
• Building analytics dashboards that track DEX growth
• Comparing deposit levels across different perp DEXes

Body

application/json

type · enum<string> · default: perpDexStatus · required

Request type

Available options: perpDexStatus

dex · string · default: xyz · required

Perp DEX name

Response

200 - application/json

Status of the specified perp DEX

The response is of type object.