# hl_get_calls

> hyperliquid calls on a market

x analysts ranked by the track record of their calls on one hyperliquid market, and their recent calls.

- open without a key.
- REST: GET /v1/hyperliquid/markets/{coin}/calls
- 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_calls","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/calls'
```

## example answer

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

```
{
  "v": 2,
  "at": 1795377723341,
  "coin": "BTC",
  "calls": [
    {
      "r": null,
      "at": 1795376293000,
      "id": "2124588281350496613",
      "px": 60674,
      "tf": "1d",
      "dir": "long",
      "pct": null,
      "url": "https://x.com/ryukXBT/status/2124588281350496613",
      "best": null,
      "exit": null,
      "stop": null,
      "text": "(the trader's own text)",
      "entry": 58000,
      "image": "https://pbs.twimg.com/media/HXwNwwMbwAAb1tR.jpg",
      "worst": null,
      "approx": true,
      "closed": false,
      "handle": "ryukXBT",
      "status": "open",
      "target": 76000,
      "resolvedAt": null
    },
    {
      "r": null,
      "at": 1795376219000,
      "id": "2124587968790982729",
      "px": 60674,
      "tf": "1h",
      "dir": "short",
      "pct": null,
      "url": "https://x.com/XBTkaz/status/2124587968790982729",
      "best": null,
      "exit": null,
      "stop": null,
      "text": "(the trader's own text)",
      "entry": null,
      "image": "https://pbs.twimg.com/media/HXwMQrCbQAAk5vR.png",
      "worst": null,
      "approx": false,
      "closed": false,
      "handle": "XBTkaz",
      "status": "open",
      "target": 57200,
      "resolvedAt": null
    }
  ],
  "callsTotal": 120,
  "short": 138,
  "basePct": -0.00994,
  "analysts": [
    {
      "n": 5,
      "avgR": 1.89,
      "hits": 4,
      "name": "***BitElite*** S. V.",
      "wins": 5,
      "calls": 5,
      "score": 0.08326,
      "approx": 4,
      "avgPct": 0.08326,
      "closed": 0,
      "handle": "BitElite17",
      "lastAt": 1794228839000,
      "rCalls": 1,
      "expired": 1,
      "hitRate": 0.8,
      "stopped": 0,
      "resolved": 5,
      "followers": 28459
    },
    {
      "n": 9,
      "avgR": 1.61,
      "hits": 8,
      "name": "More Crypto Online",
      "wins": 9,
      "calls": 11,
      "score": 0.07948,
      "approx": 5,
      "avgPct": 0.07948,
      "closed": 0,
      "handle": "Morecryptoonl",
      "lastAt": 1795216965000,
      "rCalls": 6,
      "expired": 1,
      "hitRate": 0.889,
      "stopped": 0,
      "resolved": 9,
      "followers": 64629
    }
  ],
  "analystsTotal": 124,
  "minCalls": 5
}
```

## 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_market_read](https://copy.top/docs/tools/hl-get-market-read.md)
- [all docs](https://copy.top/docs.md)

---
html: https://copy.top/docs/tools/hl-get-calls · 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.
