| name | aicoin-hyperliquid |
| description | 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. |
| metadata | {"openclaw":{"primaryEnv":"AICOIN_ACCESS_KEY_ID","requires":{"bins":["node"]},"homepage":"https://www.aicoin.com/opendata","source":"https://github.com/aicoincom/coinos-skills","license":"MIT"}} |
โ ๏ธ ่ฟ่ก่ๆฌ: ๅฟ
้กปๅ
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 ๆไปถไธญ๏ผไธไผไธไผ ๅฐไปปไฝๆๅกๅจใ