> ## 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.

# tokenDetails | Hyperliquid info

> The info endpoint with type: "tokenDetails" retrieves comprehensive information about a specific token on the Hyperliquid exchange.

<Info>
  You can only use this endpoint on the official Hyperliquid public API. It is not available through Chainstack, as the open-source node implementation does not support it yet. See [Hyperliquid methods](/docs/hyperliquid-methods) for the full availability breakdown.
</Info>

The `info` endpoint with `type: "tokenDetails"` retrieves comprehensive information about a specific token on the Hyperliquid exchange. This endpoint provides detailed supply metrics, pricing data, deployment information, and circulation details for in-depth token analysis and portfolio management.

## Example request

<CodeGroup>
  ```shell cURL theme={"system"}
  curl -X POST https://api.hyperliquid.xyz/info \
    -H "Content-Type: application/json" \
    -d '{
      "type": "tokenDetails",
      "tokenId": "0x6d1e7cde53ba9467b783cb7c530ce054"
    }'
  ```

  ```python hyperliquid-python-sdk theme={"system"}
  from hyperliquid.info import Info
  from hyperliquid.utils import constants

  # tokenDetails has no dedicated method in hyperliquid-python-sdk,
  # so post the request body directly through the underlying client.
  info = Info(constants.MAINNET_API_URL, skip_ws=True)

  token_details = info.post(
      "/info",
      {
          "type": "tokenDetails",
          "tokenId": "0x6d1e7cde53ba9467b783cb7c530ce054",
      },
  )

  print(token_details)
  ```

  ```typescript @nktkas/hyperliquid theme={"system"}
  import * as hl from "@nktkas/hyperliquid";

  const transport = new hl.HttpTransport();
  const client = new hl.InfoClient({ transport });

  const tokenDetails = await client.tokenDetails({
    tokenId: "0x6d1e7cde53ba9467b783cb7c530ce054",
  });

  console.log(tokenDetails);
  ```
</CodeGroup>

## Parameters

### Request body

* `type` (string, required) — The request type. Must be `"tokenDetails"` to retrieve token details.
* `tokenId` (string, required) — The hexadecimal token identifier to query. This can be obtained from the `spotMetaAndAssetCtxs` endpoint.

## Response

The response returns a detailed object with comprehensive token information:

### Token Identity

* `name` (string) — Token symbol/ticker (e.g., "USDC", "PURR", "HYPE")

### Supply Metrics

* `maxSupply` (string) — Maximum possible token supply (may be unlimited)
* `totalSupply` (string) — Current total token supply in circulation
* `circulatingSupply` (string) — Current circulating supply available for trading
* `futureEmissions` (string) — Planned future token emissions

### Technical Specifications

* `szDecimals` (number) — Size decimals for trade sizing precision
* `weiDecimals` (number) — Wei decimals for on-chain representation

### Pricing Information

* `midPx` (string) — Current mid price from order book
* `markPx` (string) — Current mark price used for valuation
* `prevDayPx` (string) — Previous day's closing price

### Deployment Information

* `genesis` (object/null) — Genesis block information if applicable
* `deployer` (string/null) — Address of the token deployer
* `deployGas` (string/null) — Gas used for token deployment
* `deployTime` (string/null) — ISO 8601 timestamp of deployment (e.g., "2024-06-05T10:50:59.434")

### Liquidity and Distribution

* `seededUsdc` (string) — USDC seeded for initial liquidity
* `nonCirculatingUserBalances` (array) — Non-circulating balances held by users

### Use Cases

**Token Analysis**

* Analyze token supply distribution and circulation metrics
* Monitor price performance and historical data
* Evaluate tokenomics and emission schedules

**Portfolio Management**

* Track detailed holdings and valuations
* Calculate market capitalizations using accurate supply data
* Monitor supply changes and dilution events

**Trading and Investment**

* Assess token liquidity through seeded USDC amounts
* Analyze price stability and volatility patterns
* Make informed trading decisions based on supply metrics

**Development and Integration**

* Configure applications with proper decimal handling
* Implement token-specific logic based on deployment details
* Build analytics dashboards with comprehensive token data

### Key Features

* **Complete supply breakdown** — Max, total, and circulating supply with future emissions
* **Real-time pricing** — Current mid and mark prices with historical reference
* **Deployment transparency** — Creator information and deployment metadata
* **Circulation analysis** — Detailed breakdown of non-circulating balances
* **Technical precision** — Exact decimal specifications for accurate calculations

### Notes

* Token IDs are unique hexadecimal identifiers obtained from market metadata
* Circulating supply may differ from total supply due to locked or vested tokens
* Mark prices are used for official valuations and may differ from mid prices
* Deployment information may be null for canonical or pre-existing tokens
* Future emissions indicate planned token releases that will increase total supply
* Non-circulating balances represent tokens held but not available for trading

### Finding Token IDs

To obtain token IDs for use with this endpoint:

1. Use the `spotMetaAndAssetCtxs` endpoint to get all token metadata
2. Extract the `tokenId` field from the desired token's metadata
3. Use that `tokenId` in this endpoint for detailed information


## OpenAPI

````yaml openapi/hyperliquid_node_api/hypercore_info/info_token_details.json post /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://api.hyperliquid.xyz
security: []
paths:
  /info:
    post:
      tags:
        - hyperliquid operations
      summary: info (tokenDetails)
      description: >-
        Retrieve comprehensive details for a specific token including supply
        metrics, pricing data, deployment information, and circulation details
        on the Hyperliquid exchange.
      operationId: infoTokenDetails
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - type
                - tokenId
              properties:
                type:
                  type: string
                  default: tokenDetails
                  description: The request type for token details
                tokenId:
                  type: string
                  default: '0x6d1e7cde53ba9467b783cb7c530ce054'
                  description: The hexadecimal token identifier to retrieve details for
              example:
                type: tokenDetails
                tokenId: '0x6d1e7cde53ba9467b783cb7c530ce054'
      responses:
        '200':
          description: Successfully retrieved token details
          content:
            application/json:
              schema:
                type: object
                description: >-
                  Comprehensive token information including supply, pricing, and
                  deployment data
              example:
                name: USDC
                maxSupply: '1000000000000.0'
                totalSupply: '4352925534.7421636581'
                circulatingSupply: '4352925534.7421636581'
                szDecimals: 8
                weiDecimals: 0
                midPx: '1.0'
                markPx: '1.0'
                prevDayPx: '1.0'
                genesis: null
                deployer: null
                deployGas: null
                deployTime: null
                seededUsdc: '0.0'
                nonCirculatingUserBalances: []
                futureEmissions: '0.0'

````