> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# meta | Hyperliquid info

> The info endpoint with type: "meta" retrieves perpetuals metadata including universe and margin tables for the Hyperliquid exchange.

<Info>
  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](/docs/hyperliquid-methods) for the full availability breakdown.
</Info>

The `info` endpoint with `type: "meta"` retrieves perpetuals metadata including universe and margin tables for the Hyperliquid exchange. This endpoint provides essential information about available trading pairs, their decimal precision, maximum leverage, and margin tier configurations.

## Parameters

### Request body

* `type` (string, required) — The request type. Must be `"meta"` to retrieve perpetuals metadata.
* `dex` (string, optional) — Perp dex name. Defaults to the empty string which represents the first perp dex.

## Response

The response contains two main sections:

### Universe

An array of perpetual assets with their trading parameters:

* `name` (string) — The asset name (e.g., "BTC", "ETH").
* `szDecimals` (integer) — Number of decimal places for size precision.
* `maxLeverage` (integer) — Maximum leverage allowed for this asset.
* `onlyIsolated` (boolean, optional) — Whether the asset can only be traded in isolated margin mode.
* `isDelisted` (boolean, optional) — Whether the asset is delisted and no longer available for trading.

### Margin tables

An array of margin tier configurations, where each entry is a tuple containing:

1. **Margin table ID** (integer) — Unique identifier for the margin table.
2. **Margin table object** containing:
   * `description` (string) — Description of the margin table.
   * `marginTiers` (array) — Array of margin tiers with:
     * `lowerBound` (string) — Lower bound of the tier in USD.
     * `maxLeverage` (integer) — Maximum leverage allowed for this tier.

## Example request

<CodeGroup>
  ```shell Shell theme={"system"}
  curl -X POST \
    -H "Content-Type: application/json" \
    -d '{"type": "meta"}' \
    https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info
  ```

  ```python Python (hyperliquid-python-sdk) theme={"system"}
  from hyperliquid.info import Info

  # Point the SDK at your Chainstack endpoint; skip_ws avoids opening a websocket.
  info = Info("YOUR_CHAINSTACK_ENDPOINT", skip_ws=True)

  # Posts {"type": "meta"} to /info.
  meta = info.meta()
  print(meta)
  ```

  ```typescript TypeScript (@nktkas/hyperliquid) theme={"system"}
  import { HttpTransport, InfoClient } from "@nktkas/hyperliquid";

  // apiUrl points the transport at your Chainstack endpoint.
  const transport = new HttpTransport({ apiUrl: "YOUR_CHAINSTACK_ENDPOINT" });
  const info = new InfoClient({ transport });

  // Posts {"type": "meta"} to /info.
  const meta = await info.meta();
  console.log(meta);
  ```
</CodeGroup>

<Note>
  **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](https://console.chainstack.com/). The curl above uses a shared public endpoint for quick checks only; do not use it in production.
</Note>

## Example response

```json theme={"system"}
{
  "universe": [
    {
      "name": "BTC",
      "szDecimals": 5,
      "maxLeverage": 50
    },
    {
      "name": "ETH",
      "szDecimals": 4,
      "maxLeverage": 50
    },
    {
      "name": "HPOS",
      "szDecimals": 0,
      "maxLeverage": 3,
      "onlyIsolated": true
    },
    {
      "name": "LOOM",
      "szDecimals": 1,
      "maxLeverage": 3,
      "onlyIsolated": true,
      "isDelisted": true
    }
  ],
  "marginTables": [
    [
      50,
      {
        "description": "",
        "marginTiers": [
          {
            "lowerBound": "0.0",
            "maxLeverage": 50
          }
        ]
      }
    ],
    [
      51,
      {
        "description": "tiered 10x",
        "marginTiers": [
          {
            "lowerBound": "0.0",
            "maxLeverage": 10
          },
          {
            "lowerBound": "3000000.0",
            "maxLeverage": 5
          }
        ]
      }
    ]
  ]
}
```

## Use case

The `info` endpoint with `type: "meta"` is essential for trading applications that need to:

* Display available trading pairs and their specifications
* Validate trade sizes according to decimal precision requirements
* Implement dynamic leverage limits based on position size
* Determine which assets require isolated margin mode
* Filter out delisted assets from trading interfaces

This metadata is typically cached and refreshed periodically to ensure trading applications have up-to-date information about exchange parameters.


## OpenAPI

````yaml openapi/hyperliquid_node_api/hypercore_info/info_meta.json post /4f8d8f4040bdacd1577bff8058438274/info
openapi: 3.0.0
info:
  title: Hyperliquid Node API
  version: 1.0.0
  description: This is an API for interacting with Chainstack Hyperliquid node.
servers:
  - url: https://hyperliquid-mainnet.core.chainstack.com
security: []
paths:
  /4f8d8f4040bdacd1577bff8058438274/info:
    post:
      tags:
        - hyperliquid operations
      summary: info (meta)
      operationId: infoMeta
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  type: string
                  default: meta
                  enum:
                    - meta
                dex:
                  type: string
                  default: ''
              required:
                - type
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object

````