🇺🇸English
⚠️ 运行脚本: 所有node scripts/... 命令必须以本 SKILL.md 所在目录为 workdir。
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"}' |
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","min_usd":"1000000"} |
whale_events | Whale events | 标准版 | {"coin":"BTC"} |
whale_directions | Long/short direction | 标准版 | {"coin":"BTC"} |
Liquidations
| Action | Description | Min Tier | Params |
|---|
liq_history | Liquidation history | 标准版 | {"coin":"BTC"} |
liq_stats | Liquidation stats | 标准版 | None |
liq_stats_by_coin | Stats by coin | 标准版 | {"coin":"BTC"} |
liq_top_positions |
Open Interest
| Action | Description | Min Tier | Params |
|---|
oi_summary | OI overview | 高级版 | None |
oi_top_coins | OI ranking | 高级版 | {"limit":"10"} |
oi_history | OI history | 专业版 | {"coin":"BTC","interval":"4h"} |
Taker
| Action | Description | Min Tier | Params |
|---|
taker_delta | Taker delta | 高级版 | {"coin":"BTC"} |
taker_klines | Taker K-lines | 标准版 | {"coin":"BTC","interval":"4h"} |
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"} |
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"} |
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..."} |
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"} |
current_pnl | Current PnL | 标准版 | {"address":"0x...","coin":"BTC","interval":"1h"} |
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"} |
高级版
| Action | Description | Min Tier | Params |
|---|
info | Info API | 免费版 | {"type":"metaAndAssetCtxs"} |
smart_find | Smart money discovery | 标准版 | {} |
discover | Trader discovery | 高级版 | {} |
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, SOLAddress format — Must be full 0x... Ethereum addressRate 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 文件中，不会上传到任何服务器。
Weekly Installs
23
Repository
aicoincom/coinos-skills
GitHub Stars
3
First Seen
5 days ago
Security Audits
Gen Agent Trust HubPassSocketFailSnykWarn
Installed on
gemini-cli23
github-copilot23
codex23
amp23
cline23
kimi-cli23
