# hl_get_markets

> hyperliquid markets

live hyperliquid markets (crypto perps and hip-3: stocks, indices, commodities, fx): mark price, 24h change, 24h volume, open interest, hourly funding, max leverage. optional category; sorted by 24h volume.

- open without a key.
- REST: GET /v1/hyperliquid/markets
- about 20 calls a minute without a key, 60 with a key.
- read-only.

## parameters

| name | type | required | what it does |
| --- | --- | --- | --- |
| category | string | no | e.g. crypto, stocks, indices, commodities, fx |
| limit | integer | no | default 20. from 1 to 50 |

## call it over MCP

```
curl -s https://copy.top/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"hl_get_markets","arguments":{"limit":10}}}'
```

the answer is in result.content[0].text, as a JSON string. an MCP client (Claude, Cursor, an agent framework) does this for you: ask in plain words and it picks the tool.

## call it over REST

```
curl -s 'https://copy.top/v1/hyperliquid/markets?limit=10'
```

## example answer

a real answer from 2026-11-22, shortened: lists cut to two items.

```
{
  "total": 302,
  "categories": [
    "crypto",
    "indices"
  ],
  "markets": [
    {
      "coin": "BTC",
      "dex": "",
      "symbol": "BTC",
      "name": null,
      "category": "crypto",
      "assetId": 0,
      "maxLeverage": 40,
      "marginMode": "cross",
      "szDecimals": 5,
      "markPx": 60931,
      "midPx": 60931.5,
      "oraclePx": 60958.7,
      "prevDayPx": 60452,
      "change24h": 0.007923641897704004,
      "dayNtlVlm": 3341482355.51907,
      "openInterestUsd": 2326045085.36868,
      "fundingHourly": 0.0000125,
      "growthMode": false,
      "feeScale": null
    },
    {
      "coin": "ETH",
      "dex": "",
      "symbol": "ETH",
      "name": null,
      "category": "crypto",
      "assetId": 1,
      "maxLeverage": 25,
      "marginMode": "cross",
      "szDecimals": 4,
      "markPx": 1719.7,
      "midPx": 1719.75,
      "oraclePx": 1720.72,
      "prevDayPx": 1687.6,
      "change24h": 0.019021095046219516,
      "dayNtlVlm": 529536677.3311198,
      "openInterestUsd": 1057884952.9142,
      "fundingHourly": -0.0000027407,
      "growthMode": false,
      "feeScale": null
    }
  ]
}
```

## related

- [hl_get_traders](https://copy.top/docs/tools/hl-get-traders.md)
- [hl_get_trader](https://copy.top/docs/tools/hl-get-trader.md)
- [hl_get_market_read](https://copy.top/docs/tools/hl-get-market-read.md)
- [hl_get_calls](https://copy.top/docs/tools/hl-get-calls.md)
- [all docs](https://copy.top/docs.md)

---
html: https://copy.top/docs/tools/hl-get-markets · all docs: https://copy.top/docs.md · copy.top is independent: not affiliated with fomo, pump.fun or Hyperliquid. the API is read-only: nothing here places an order. figures are data, not advice. trading crypto is risky and past performance does not predict results.
