Coinos-skills aicoin-hyperliquid

This skill should be used when the user asks about Hyperliquid whale positions, Hyperliquid liquidations, Hyperliquid open interest, Hyperliquid trader analytics, Hyperliquid taker data, smart money on Hyperliquid, or any Hyperliquid-specific query. Use when user says: 'Hyperliquid whales', 'HL whale positions', 'HL liquidations', 'HL open interest', 'HL trader', 'smart money', 'Hyperliquid大户', 'HL鲸鱼', 'HL持仓', 'HL清算', 'HL持仓量', 'HL交易员'. For general crypto prices/news, use aicoin-market. For exchange trading, use aicoin-trading. For Freqtrade, use aicoin-freqtrade.

install

source · Clone the upstream repo

git clone https://github.com/aicoincom/coinos-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/aicoincom/coinos-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/aicoin-hyperliquid" ~/.claude/skills/aicoincom-coinos-skills-aicoin-hyperliquid && rm -rf "$T"

manifest: skills/aicoin-hyperliquid/SKILL.md

source content

⚠️ 运行脚本: 必须先 cd 到本 SKILL.md 所在目录再执行。示例:
cd ~/.openclaw/workspace/skills/aicoin-hyperliquid && node scripts/hl-market.mjs ...

AiCoin Hyperliquid

Hyperliquid whale tracking and analytics powered by AiCoin Open API.

Version: 1.0.0

Critical Rules

NEVER fabricate data. Always run scripts to fetch real-time data.
NEVER use curl, web_fetch, or browser. Always use these scripts.
NEVER run
env
or
printenv
— leaks API secrets.
Scripts auto-load
.env
— never pass credentials inline.
On 304/403 error — STOP, do NOT retry. Guide user to upgrade (see Paid Feature Guide at bottom).

Setup

Hyperliquid Registration (AiCoin Referral): If user needs to register on Hyperliquid, use AiCoin referral link: https://app.hyperliquid.xyz/join/AICOIN88 (邀请码: AICOIN88, 返4%手续费).

Scripts work out of the box with a built-in free key (tickers + info only). For whale/trader/OI data, add your API key to

.env

AICOIN_ACCESS_KEY_ID=your-key-id
AICOIN_ACCESS_SECRET=your-secret

Get at https://www.aicoin.com/opendata. See Paid Feature Guide for tier details.

安全说明： AiCoin API Key 仅用于获取 Hyperliquid 链上分析数据，无法进行任何交易操作。如需在 Hyperliquid 上交易，需单独配置钱包私钥（见 aicoin-trading skill）。所有密钥仅保存在本地设备

.env

文件中，不会上传到任何服务器。

.env

auto-loaded from: cwd →

~/.openclaw/workspace/.env

→

~/.openclaw/.env

Quick Reference

Task	Command	Min Tier
All tickers	`node scripts/hl-market.mjs tickers`	免费版
BTC ticker	`node scripts/hl-market.mjs ticker '{"coin":"BTC"}'`	免费版
Whale positions	`node scripts/hl-market.mjs whale_positions '{"coin":"BTC"}'`	标准版
Whale events	`node scripts/hl-market.mjs whale_events '{"coin":"BTC"}'`	标准版
Liquidation history	`node scripts/hl-market.mjs liq_history '{"coin":"BTC"}'`	标准版
OI summary	`node scripts/hl-market.mjs oi_summary`	高级版
Trader stats	`node scripts/hl-trader.mjs trader_stats '{"address":"0x...","period":"30"}'`	标准版
Smart money	`node scripts/hl-trader.mjs smart_find`	标准版
Top open orders	`node scripts/hl-trader.mjs top_open '{"coin":"BTC"}'`	基础版

Scripts

scripts/hl-market.mjs — Market Data

Tickers

Action	Description	Min Tier	Params
`tickers`	All tickers	免费版	None
`ticker`	Single coin	免费版	`{"coin":"BTC"}`

Whales

Action	Description	Min Tier	Params
`whale_positions`	Whale positions	标准版	`{"coin":"BTC","dir":"long","topBy":"position-value","take":"10"}` dir: long/short; topBy: position-value/margin-balance/create-time/profit/loss; take: max 200. Optional: `npnlSide` (profit/loss), `frSide` (profit/loss)
`whale_events`	Whale events	标准版	`{"coin":"BTC","limit":"10"}` limit: max 100
`whale_directions`	Long/short direction	标准版	`{"coin":"BTC"}`
`whale_history_ratio`	Historical long ratio	标准版	`{"interval":"1h","limit":"50"}` interval: 10m/1h/4h/1d; limit: max 200

Liquidations

Action	Description	Min Tier	Params
`liq_history`	Liquidation history	标准版	`{"coin":"BTC","interval":"15m","limit":"20"}` interval: 1m~60d; limit: max 100
`liq_stats`	Liquidation stats	标准版	`{"coin":"BTC","interval":"15m"}` interval: 1s~60d
`liq_stats_by_coin`	Stats by coin	标准版	`{"interval":"15m"}` interval: 1s~60d
`liq_top_positions`	Large liquidations	标准版	`{"coin":"BTC","interval":"1d"}`

Open Interest & Orderbook

Action	Description	Min Tier	Params
`oi_summary`	OI overview	高级版	None
`oi_top_coins`	OI ranking	高级版	`{"limit":"10","interval":"3d"}` interval: 15m~180d
`oi_history`	OI history	专业版	`{"coin":"BTC","interval":"4h"}`
`orderbook_history`	Orderbook history summaries	高级版	`{"coin":"BTC","interval":"1d"}` interval: 1h~180d

Taker

Action Description Min Tier Params

taker_delta

Taker delta

高级版

{"coin":"BTC"}

taker_klines

Taker K-lines

标准版

{"coin":"BTC","interval":"4h"}

Optional:

startTime

endTime

(ms),

limit

(max 2000)

scripts/hl-trader.mjs — Trader Analytics

Trader Stats

Action	Description	Min Tier	Params
`trader_stats`	Trader statistics	标准版	`{"address":"0x...","period":"30"}`
`best_trades`	Best trades	标准版	`{"address":"0x...","period":"30"}`
`performance`	Performance by coin	标准版	`{"address":"0x...","period":"30"}`
`completed_trades`	Completed trades	标准版	`{"address":"0x...","coin":"BTC"}`
`accounts`	Batch accounts	标准版	`{"addresses":"[\"0x...\"]"}`
`statistics`	Batch statistics	标准版	`{"addresses":"[\"0x...\"]"}`

Fills

Action	Description	Min Tier	Params
`fills`	Address fills	标准版	`{"address":"0x..."}`
`fills_by_oid`	By order ID	标准版	`{"oid":"xxx"}`
`fills_by_twapid`	By TWAP ID	标准版	`{"twapid":"xxx"}`
`fills_by_builder`	Builder fills	标准版	`{"builder":"0x..."}` Optional: `coin` , `limit` (max 2000), `minVal`
`top_trades`	Large trades	基础版	`{"coin":"BTC","interval":"1d"}`

Orders

Action	Description	Min Tier	Params
`orders_latest`	Latest orders	标准版	`{"address":"0x..."}`
`order_by_oid`	By order ID	标准版	`{"oid":"xxx"}`
`filled_orders`	Filled orders	标准版	`{"address":"0x..."}`
`filled_by_oid`	Filled by ID	标准版	`{"oid":"xxx"}`
`top_open`	Large open orders	基础版	`{"coin":"BTC","minVal":"100000"}`
`active_stats`	Active stats	基础版	`{"coin":"BTC","whaleThreshold":"500000"}`
`twap_states`	TWAP states	标准版	`{"address":"0x..."}` Optional: `coin` , `limit` (max 100)

Positions

Action	Description	Min Tier	Params
`current_pos_history`	Current position history	标准版	`{"address":"0x...","coin":"BTC"}`
`completed_pos_history`	Closed position history	标准版	`{"address":"0x...","coin":"BTC"}`
`completed_trades_by_time`	Completed trades by time	标准版	`{"address":"0x...","Coin":"BTC","endTimeFrom":1771891200000,"endTimeTo":1772064000000}` Optional: `pageNum` , `pageSize`
`current_pnl`	Current PnL	标准版	`{"address":"0x...","coin":"BTC","interval":"1h"}` Optional: `limit` (max 1000)
`completed_pnl`	Closed PnL	标准版	`{"address":"0x...","coin":"BTC","interval":"1h"}` Optional: `limit` (max 1000)
`current_executions`	Current executions	标准版	`{"address":"0x...","coin":"BTC","interval":"1h"}` Optional: `limit` (max 1000)
`completed_executions`	Closed executions	标准版	`{"address":"0x...","coin":"BTC","interval":"1h"}` Optional: `limit` (max 1000)

Portfolio

Action	Description	Min Tier	Params
`portfolio`	Account curve	标准版	`{"address":"0x...","window":"week"}`
`pnls`	PnL curve	标准版	`{"address":"0x...","period":"30"}`
`max_drawdown`	Max drawdown	标准版	`{"address":"0x...","days":"30"}`
`net_flow`	Net flow	标准版	`{"address":"0x...","days":"30"}`

Batch Endpoints

Action	Description	Min Tier	Params
`batch_pnls`	Batch PNL curves	标准版	`{"addresses":"[\"0x...\"]","period":7}` Optional: `scope` (all/perp)
`batch_addr_stat`	Batch address stats	标准版	`{"addresses":"[\"0x...\"]","period":7}`
`batch_clearinghouse_state`	Batch clearinghouse state	标准版	`{"addresses":"[\"0x...\"]"}` Optional: `dex`
`batch_spot_clearinghouse_state`	Batch spot state	标准版	`{"addresses":"[\"0x...\"]"}`
`batch_max_drawdown`	Batch max drawdown	标准版	`{"addresses":"[\"0x...\"]","days":7}` Optional: `scope`
`batch_net_flow`	Batch net flow	标准版	`{"addresses":"[\"0x...\"]","days":7}`

Advanced

Action	Description	Min Tier	Params
`info`	Info API	免费版	`{"type":"metaAndAssetCtxs"}`
`smart_find`	Smart money discovery	标准版	`{}`
`discover`	Trader discovery	高级版	`{}`
`discover_history`	Historical discovery	高级版	`{"pageNum":1,"pageSize":20,"period":7}` Optional: `startTime` , `time` , `sort` , `coins` , `selects` , `filters`

Cross-Skill References

Need	Use
Prices, K-lines, news	aicoin-market
Exchange trading (buy/sell), including Hyperliquid orders	aicoin-trading
Freqtrade strategies/backtest	aicoin-freqtrade

Common Errors

```
errorCode 304 / HTTP 403
```
— Paid feature. See Paid Feature Guide below.
```
Invalid coin
```
— Use uppercase:
```
BTC
```
,
```
ETH
```
,
```
SOL
```
```
Address format
```
— Must be full
```
0x...
```
Ethereum address
```
Rate limit exceeded
```
— Wait 1-2s between requests

Paid Feature Guide

When a script returns 304 or 403: Do NOT retry. Tell the user:

This feature needs a paid AiCoin API subscription.
Get API key at https://www.aicoin.com/opendata

Tier	Price	HL Features
免费版	$0	Tickers, info only
基础版	$29/mo	+ Top trades, top open orders, active stats
标准版	$79/mo	+ Whales, liquidations, trader analytics, taker K-lines
高级版	$299/mo	+ OI summary/top, taker delta, trader discover
专业版	$699/mo	+ OI history

Add to

.env

AICOIN_ACCESS_KEY_ID=xxx

AICOIN_ACCESS_SECRET=xxx

Scripts auto-load

.env

from cwd,

~/.openclaw/workspace/.env

, or

~/.openclaw/.env

MUST tell the user: AiCoin API Key 仅用于获取 Hyperliquid 链上分析数据，无法进行任何交易操作。如需在 Hyperliquid 上交易，需要单独配置钱包私钥（见 aicoin-trading skill）。所有密钥仅保存在你的本地设备
```
.env
```
文件中，不会上传到任何服务器。