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.
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.
Get your own node endpoint todayStart 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"tokenDetails"to retrieve token details.tokenId(string, required) — The hexadecimal token identifier to query. This can be obtained from thespotMetaAndAssetCtxsendpoint.
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 circulationcirculatingSupply(string) — Current circulating supply available for tradingfutureEmissions(string) — Planned future token emissions
Technical Specifications
szDecimals(number) — Size decimals for trade sizing precisionweiDecimals(number) — Wei decimals for on-chain representation
Pricing Information
midPx(string) — Current mid price from order bookmarkPx(string) — Current mark price used for valuationprevDayPx(string) — Previous day’s closing price
Deployment Information
genesis(object/null) — Genesis block information if applicabledeployer(string/null) — Address of the token deployerdeployGas(string/null) — Gas used for token deploymentdeployTime(string/null) — ISO 8601 timestamp of deployment (e.g., “2024-06-05T10:50:59.434”)
Liquidity and Distribution
seededUsdc(string) — USDC seeded for initial liquiditynonCirculatingUserBalances(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
- Track detailed holdings and valuations
- Calculate market capitalizations using accurate supply data
- Monitor supply changes and dilution events
- Assess token liquidity through seeded USDC amounts
- Analyze price stability and volatility patterns
- Make informed trading decisions based on supply metrics
- 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:- Use the
spotMetaAndAssetCtxsendpoint to get all token metadata - Extract the
tokenIdfield from the desired token’s metadata - Use that
tokenIdin this endpoint for detailed information
Body
application/json
Response
200 - application/json
Successfully retrieved token details
Comprehensive token information including supply, pricing, and deployment data