# hl_get_market_read

> hyperliquid market read: funding, open interest, what top traders hold

copy.top's read of one major hyperliquid market: technicals (rsi, emas, trend), funding vs its history and other venues, premium, open interest changes, what the top 300 traders hold and their latest moves, nearby liquidations, fear and greed.

- open without a key.
- REST: GET /v1/hyperliquid/markets/{coin}
- a heavier read: about 6 calls a minute without a key, 30 with a key.
- read-only.

## parameters

| name | type | required | what it does |
| --- | --- | --- | --- |
| coin | string | yes | e.g. BTC, ETH, SOL |

## 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_market_read","arguments":{"coin":"BTC"}}}'
```

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/BTC'
```

## example answer

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

```
{
  "coin": "BTC",
  "at": 1795384618884,
  "px": 60907,
  "ta": {
    "tf": {
      "1h": {
        "rsi": 58.1,
        "rating": {
          "score": 0.336,
          "label": "buy",
          "ma": 0.4,
          "osc": 0.273
        }
      },
      "4h": {
        "rsi": 47.6,
        "rating": {
          "score": -0.133,
          "label": "sell",
          "ma": -0.267,
          "osc": 0
        }
      },
      "1d": {
        "rsi": 22.5,
        "rating": {
          "score": -0.218,
          "label": "sell",
          "ma": -0.8,
          "osc": 0.364
        },
        "rsiWeekAgo": 19.6
      }
    },
    "ema": {
      "d20": 68555.6,
      "d50": 73952.8,
      "d200": 75264.7
    },
    "trend": "down",
    "rangeDay": 0.0497,
    "chg": {
      "h24": 0.00753,
      "d7": -0.0646,
      "d30": -0.25182
    }
  },
  "funding": {
    "hourly": 0.0000125,
    "yearly": 0.1095,
    "base": 0.0000125,
    "state": "neutral",
    "multiple": null,
    "avg7d": 0.000005635,
    "pct90d": 65,
    "venues": [
      {
        "venue": "binance",
        "hourly": 0.0000043575,
        "yearly": 0.03817
      },
      {
        "venue": "bybit",
        "hourly": 4.588e-7,
        "yearly": 0.00402
      }
    ]
  },
  "premium": -0.000476,
  "oi": {
    "usd": 2325103186,
    "coins": 38174.646,
    "chg1h": null,
    "chg4h": null,
    "chg24h": null,
    "since": 1795382457716,
    "reading": null,
    "readingHours": null,
    "readingDOi": null,
    "readingDPx": null,
    "strong": false
  },
  "crowd": {
    "traders": 300,
    "withPos": 120,
    "long": {
      "n": 36,
      "usd": 18910416,
      "entry": 61009.1,
      "upnl": -25084
    },
    "short": {
      "n": 84,
      "usd": 127531614,
      "entry": 64251.2,
      "upnl": 6932850
    },
    "top": [
      {
        "address": "0x04889bbfa46fcf754ba06b1ca6d3e83265dcd87d",
        "name": null,
        "side": "short",
        "usd": 39005757,
        "entry": 60554.3,
        "liqPx": 64883,
        "upnl": -251313,
        "lev": 12
      },
      {
        "address": "0x8455193b0490ad091819000b01cd9bb833ac974b",
        "name": null,
        "side": "short",
        "usd": 18057426,
        "entry": 60705.2,
        "liqPx": 63284.2,
        "upnl": -70740,
        "lev": 40
      }
    ],
    "topTotal": 10,
    "updatedAt": 1795384539112,
    "moves": [
      {
        "t": 1795383841040,
        "address": "0x838d8e13ec1010e7851b3dc333699db885f2520c",
        "name": null,
        "side": "long",
        "action": "close",
        "usd": 451758,
        "px": 60983
      },
      {
        "t": 1795383269932,
        "address": "0xdb11e58a8f42448847d1dca2988f433a0e6f1d9a",
        "name": null,
        "side": "short",
        "action": "add",
        "usd": 182756,
        "px": 60918.8
      }
    ],
    "movesTotal": 254
  },
  "liq": {
    "accounts": 1800,
    "holders": 296,
    "step": 0.005,
    "buckets": [
      {
        "lo": 51770.9,
        "hi": 52075.5,
        "longUsd": 3658806,
        "shortUsd": 0
      },
      {
        "lo": 52684.6,
        "hi": 52989.1,
        "longUsd": 17755280,
        "shortUsd": 0
      }
    ],
    "bucketsTotal": 17,
    "near": {
      "long": {
        "usd": 17755280,
        "lo": 52684.6,
        "hi": 52989.1
      },
      "short": {
        "usd": 39005757,
        "lo": 64866,
        "hi": 65170.5
      }
    },
    "updatedAt": 1795384628384
  },
  "fg": {
    "value": 18,
    "label": "extreme_fear",
    "asOf": 1795219200000,
    "weekAgo": 20,
    "parts": [
      {
        "key": "momentum",
        "value": 1,
        "weight": 0.308
      },
      {
        "key": "volatility",
        "value": 24,
        "weight": 0.231
      }
    ],
    "history": [
      [
        1792713600000,
        44
      ],
      [
        1792800000000,
        40
      ]
    ],
    "historyTotal": 30
  }
}
```

## 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_markets](https://copy.top/docs/tools/hl-get-markets.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-market-read · 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.
