Community Docs
  • 🏠Home
  • Getting Started
  • Introduction
    • What is Hyperliquid?
    • Hyperliquid Labs
    • Roadmap
      • 2025-26-03_Incident
  • Architecture
    • Overview
    • HyperBFT
      • API Servers
    • HyperCore
      • Dex
        • Clearinghouse
          • Margin Management
          • Liquidations
          • Funding
          • Fees
        • Order Book
        • Oracle
      • Vault
      • HIPs
        • Spot Deployments (HIP-1/HIP-2)
      • Bridge
    • HyperEVM
    • Hyperliquid.
      • Unit
  • Guide
    • User Guide
      • Onboarding
      • Spot Deployments
      • Airdrop
    • Builder Guide
      • HyperCore
        • Trading Bot
        • Builder Codes
          • Install Template
          • Update
        • Endpoints
          • Info
            • Spot
            • Perpetuals
          • Exchange
      • HyperEVM
        • EVM Basics
          • dApp Setup
        • Specificities
      • Node Operators
      • Historical Data
  • Ecosystem
    • The Hyper Liquidated
      • Community Map
    • Projects
      • Tools
      • HyperEVM
        • Felix
      • HyperCore
      • MemeCoin
Powered by GitBook
On this page
  1. Guide
  2. Builder Guide
  3. HyperCore
  4. Endpoints
  5. Info

Spot

PreviousInfoNextPerpetuals

Last updated 2 months ago

The Spot section of the /info endpoint provides details about L1 Spot markets on Hyperliquid. To make sense of the data structure, I have created the diagram below to visually represent the relationships between key objects.

🔗 For full API details:

📌 Understanding Asset IDs in the Spot API

Interpreting asset identifiers across the different API responses can be confusing. The diagram above helps clarify these relationships.

  • The "token" field in spotClearinghouseState (e.g., "token": 1105) corresponds to the index of that token ID in the "token" array of spotMeta. You can find more details about the token in this category of data.

  • Additionally, each asset is part of a trading pair, which is represented under universe.

🔹 Key Points

  • All universe indexes are numbers, except PURR/USDC, which is an exception.

  • The "name" field in universe is @{index}, but this index differs from the token index in spotMeta. Each trading pair has its own unique index within the universe.

  • The "name" field in tokens represents the coin (perp name) of the asset.

🔹 Spot Asset ID Calculation

For spot endpoints, the asset ID is derived as follows:

spot_asset_id = 10000 + spotInfo["index"]

Where spotInfo is the object containing the desired quote and base tokens.

Example: HYPE Token Asset IDs

Mainnet

Testnet

Token ID

150

1105

Spot ID

107

1035

This distinction is crucial when submitting orders or querying data.

Spot Endpoint Documentation