Docs
Search⌘ K
  • Home
  • About The Graph
  • Supported Networks
  • Protocol Contracts
  • Subgraphs
    • Substreams
      • Token API
        • Hypergraph
          • AI Suite
            • Indexing
              • Graph Horizon
                • Resources
                  Token API > Hyperliquid Market Endpoints

                  Market Lookup

                  GET/v1/hyperliquid/markets

                  Returns the latest snapshot per market: last trade price, 24h change versus the prior-day close, 24h volume (split by side), trade and unique-user counts, and the most recent open interest and funding rate observed at the last funding snapshot.

                  Filters compose additively — pass coin, dex, base_token, and/or quote_token to narrow the scope. A mismatched combination (e.g. coin=cash:TSLA&dex=xyz) returns empty. Omit all for a full listing sorted by 24h volume.

                  base_token and quote_token are spot-discovery filters: ?base_token=HYPE returns every spot pair where HYPE sits on the base side (HYPE/USDC, HYPE/USDT0, …). Use the coin from the result as the identifier on the rest of the /v1/hyperliquid/* endpoints.

                  Query Parameters

                  ParameterDescriptionValue
                  coin
                  string

                  Hyperliquid coin identifier. Core perps have no prefix (BTC, HYPE); spot pairs use @N (@107); builder DEXs prefix the symbol with the DEX name (xyz:SILVER).

                    dex
                    string

                    DEX identifier. perps for core perps, spot for @N spot pairs, or a builder DEX name (e.g. xyz, cash). New builder DEXs are added on Hyperliquid permissionlessly — call /v1/hyperliquid/dexes for the live set.

                      base_token
                      string

                      Spot token symbol (e.g. HYPE, USDC). Use to discover all spot pairs with this token on a given side via /v1/hyperliquid/markets?base_token=... or ?quote_token=....

                        quote_token
                        string

                        Spot token symbol (e.g. HYPE, USDC). Use to discover all spot pairs with this token on a given side via /v1/hyperliquid/markets?base_token=... or ?quote_token=....

                          limit
                          integer

                          Number of items* returned in a single request.
                          *Plan restricted.

                          • Default value: 10
                          • Minimum value: 1
                          • Maximum value: 1000
                          page
                          integer

                          Page number to fetch.
                          Empty data array signifies end of results.

                          • Default value: 1
                          • Minimum value: 1
                          • Maximum value: 767465558638

                          Potential Responses

                          StatusDescription
                          200

                          Successful Response

                          400

                          Client side error

                          401

                          Authentication failed

                          403

                          Forbidden

                          404

                          Not found

                          500

                          Server side error

                          ⁠Edit on GitHub⁠

                          Market LiquidationsMarket OHLCV
                          Test this endpoint

                          1curl --request GET \2  --url 'https://token-api.thegraph.com/v1/hyperliquid/markets?coin=BTC&limit=10&page=1'

                          1{2  "data": [3    {4      "coin": "BTC",5      "market_name": "BTC",6      "dex": "perps",7      "base_token": null,8      "quote_token": null,9      "price": 75944,10      "price_24h": 76765,11      "price_24h_change": -0.010695,12      "volume_24h": 2322418448.58,13      "buy_volume_24h": 1106113114.59,14      "sell_volume_24h": 1216305333.99,15      "trades_24h": 454294,16      "unique_users_24h": 4581,17      "open_interest": 27608.56,18      "funding_rate": 0.0000037749,19      "funding_snapshot_time": "2026-04-28 15:00:00"20    },21    {22      "coin": "@107",23      "market_name": "HYPE/USDC",24      "dex": "spot",25      "base_token": "HYPE",26      "quote_token": "USDC",27      "price": 22.41,28      "price_24h": 22.85,29      "price_24h_change": -0.01926,30      "volume_24h": 18452113.47,31      "buy_volume_24h": 9071010.97,32      "sell_volume_24h": 9381102.5,33      "trades_24h": 28412,34      "unique_users_24h": 1267,35      "open_interest": null,36      "funding_rate": null,37      "funding_snapshot_time": null38    }39  ]40}
                          The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service