aicoin-hyperliquidlisted
Install: claude install-skill aicoincom/coinos-skills
# AiCoin Hyperliquid
Hyperliquid whale tracking and trader analytics from the [AiCoin Open API v3](https://www.aicoin.com/opendata).
> 从 SKILL.md 所在目录运行脚本。CoinClaw 三引擎容器(OpenClaw / Hermes / Claude Code)自动注入 skill 路径,`cd` 到 skill 目录即可。
## 怎么用
一个命令调所有接口:
```
node scripts/aicoin.mjs <接口> '<JSON 参数>'
```
`<接口>` 就是 `/api/v3/` 后面那段路径,HL 的都在 `hyperliquid/` 下。
- 返回**统一信封** `{ ok, data, error, meta }` —— **先看 `ok`**。`ok:false` 看 `error.code` / `error.message`。
- 不确定有哪些接口、参数怎么填 → `node scripts/aicoin.mjs catalog hyperliquid`。catalog 是线上实时菜单,永远准。
- 想知道当前 key 能用哪些接口 → `node scripts/aicoin.mjs key`。
```
node scripts/aicoin.mjs catalog hyperliquid # HL 全部接口 + 参数
node scripts/aicoin.mjs hyperliquid/ticker '{"coin":"BTC"}'
node scripts/aicoin.mjs hyperliquid/whales/open-positions '{"coin":"BTC"}'
```
## 常用接口速查
| 想查什么 | 接口 + 例子 |
|---|---|
| 全币种行情 / 单币行情 | `hyperliquid/tickers` / `hyperliquid/ticker '{"coin":"BTC"}'` |
| 大户当前持仓 | `hyperliquid/whales/open-positions '{"coin":"BTC","top_by":"position-value"}'` |
| 大户最新动作 | `hyperliquid/whales/latest-events '{"limit":20}'` |
| 大户多空方向 / 历史多空比 | `hyperliquid/whales/directions '{"coin":"BTC"}'` / `hyperliquid/whales/history-long-ratio` |
| 清算历史 / 统计 | `hyperliquid/liquidations/history '{"coin":"BTC","interval":"1d"}'` / `hyperliquid/liquidations/stat '{"coin":"BTC","interval":"1d"}'` —— 问"近 24h"务必传 `interval`,默认窗口很短会返回全 0 |
| 大额待清算仓位 | `hyperliquid/liquidations/top-positions '{"coin":"BTC","interval":"1d"}'` |
| 持仓