Skip to main content
POST
spotMeta | Hyperliquid Info API

Credit Cost

1 per call

Processing

Realtime
The Hyperliquid info endpoint with type: "spotMeta" is used to fetch the spot universe metadata and full token configuration without live market context.
Estimate your monthly cost for this API using the Pricing Calculator.
  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "spotMeta"}.
  • Use spotMetaAndAssetCtxs when you also need live per-pair mark price, mid, and day volume.
  • For the perpetuals equivalent, use meta.
Returns the static metadata for the entire Hyperliquid spot market: the list of trading pairs (universe) and the full token registry (tokens) with each token’s decimals, on-chain identifier, and linked HyperEVM contract. Carries no live market data, so it is cheap to cache and changes only when new tokens or pairs are listed.

Endpoint

Request

string
default:"spotMeta"
required
Always "spotMeta".

Example

Response

A single JSON object with two arrays: tokens (the token registry) and universe (the tradeable pairs that reference those tokens by index).

tokens[]

string
Token symbol - e.g. "USDC", "PURR".
int
Number of decimals used for order size precision.
int
Number of decimals in the token’s native wei representation.
int
Token index. universe[].tokens references tokens by this value.
string
Hyperliquid on-chain token identifier.
boolean
Whether the token is a canonical (core) Hyperliquid token.
object | null
Linked HyperEVM contract, or null if the token is not bridged. Carries address and evm_extra_wei_decimals (the wei-decimal offset between the spot token and its EVM representation).
string | null
Human-readable token name, or null when not set.
string
Share of trading fees routed to the token deployer (decimal string).

universe[]

string
Pair symbol - e.g. "PURR/USDC". Non-canonical pairs use the @<index> form (e.g. "@1").
array<int>
Two-element [base, quote] array of token indices into tokens.
int
Pair index. Used as the spot asset identifier in other endpoints and streams.
boolean
Whether the pair is a canonical Hyperliquid market.

spotMetaAndAssetCtxs

fetch the spot universe metadata, token configuration, and live market data in a single call.

batchSpotClearinghouseState

fetch spot account balances for up to 50 wallets in a single request.

meta

fetch the perpetuals universe metadata without live market context.

metaAndAssetCtxs

fetch the full Hyperliquid perpetuals market universe with live per-asset trading context.
Last reviewed: 2026-06-13