> ## Documentation Index
> Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# spotMeta | Hyperliquid Info API
> Hyperliquid spotMeta: fetch the spot universe metadata and full token configuration without live market context.
1 per call
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](/pricing-calculator?endpoint=%2Fapi-reference%2Fhyperliquid-info%2Fspot-meta).
* 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
```
POST https://hypercore.goldrushdata.com/info
Authorization: Bearer
Content-Type: application/json
```
## Request
Always `"spotMeta"`.
### Example
```bash cURL theme={null}
curl -X POST https://hypercore.goldrushdata.com/info \
-H "Authorization: Bearer $GOLDRUSH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "spotMeta"
}'
```
```typescript TypeScript theme={null}
const response = await fetch("https://hypercore.goldrushdata.com/info", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.GOLDRUSH_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
type: "spotMeta",
}),
});
const spotMeta = await response.json();
```
```python Python theme={null}
import os, requests
response = requests.post(
"https://hypercore.goldrushdata.com/info",
headers={"Authorization": f"Bearer {os.environ['GOLDRUSH_API_KEY']}"},
json={"type": "spotMeta"},
)
spot_meta = response.json()
```
## Response
A single JSON object with two arrays: `tokens` (the token registry) and `universe` (the tradeable pairs that reference those tokens by index).
```json theme={null}
{
"tokens": [
{
"name": "USDC",
"szDecimals": 8,
"weiDecimals": 8,
"index": 0,
"tokenId": "0x6d1e7cde53ba9467b783cb7c530ce054",
"isCanonical": true,
"evmContract": {
"address": "0x6b9e773128f453f5c2c60935ee2de2cbc5390a24",
"evm_extra_wei_decimals": -2
},
"fullName": null,
"deployerTradingFeeShare": "0.0"
},
{
"name": "PURR",
"szDecimals": 0,
"weiDecimals": 5,
"index": 1,
"tokenId": "0xc1fb593aeffbeb02f85e0308e9956a90",
"isCanonical": true,
"evmContract": null,
"fullName": null,
"deployerTradingFeeShare": "0.0"
}
],
"universe": [
{ "tokens": [1, 0], "name": "PURR/USDC", "index": 0, "isCanonical": true }
]
}
```
### `tokens[]`
Token symbol - e.g. `"USDC"`, `"PURR"`.
Number of decimals used for order size precision.
Number of decimals in the token's native wei representation.
Token index. `universe[].tokens` references tokens by this value.
Hyperliquid on-chain token identifier.
Whether the token is a canonical (core) Hyperliquid token.
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).
Human-readable token name, or `null` when not set.
Share of trading fees routed to the token deployer (decimal string).
### `universe[]`
Pair symbol - e.g. `"PURR/USDC"`. Non-canonical pairs use the `@` form (e.g. `"@1"`).
Two-element `[base, quote]` array of token indices into `tokens`.
Pair index. Used as the spot asset identifier in other endpoints and streams.
Whether the pair is a canonical Hyperliquid market.
## Related endpoints
fetch the spot universe metadata, token configuration, and live market data in a single call.
fetch spot account balances for up to 50 wallets in a single request.
fetch the perpetuals universe metadata without live market context.
fetch the full Hyperliquid perpetuals market universe with live per-asset trading context.
*Last reviewed: 2026-06-13*