Back to Details

aicoin-hyperliquid

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

CoinOS Hyperliquid

CoinOS Hyperliquid

Hyperliquid whale tracking and analytics powered by AiCoin Open API.
Version: 1.0.0
基于AiCoin Open API打造的Hyperliquid大户追踪与分析工具。
版本： 1.0.0

Critical Rules

重要规则

  1. NEVER fabricate data. Always run scripts to fetch real-time data.
  2. NEVER use curl, web_fetch, or browser. Always use these scripts.
  3. NEVER run 
    env
    or 
    printenv
     — leaks API secrets.
  4. Scripts auto-load 
    .env
     — never pass credentials inline.
  5. On 304/403 error — STOP, do NOT retry. Guide user to upgrade (see Paid Feature Guide at bottom).
  1. 绝对不要编造数据。 始终运行脚本来获取实时数据。
  2. 绝对不要使用curl、web_fetch或浏览器。 始终使用指定脚本。
  3. 绝对不要运行
    env
    或
    printenv
    命令     —— 会泄露API密钥。
  4. 脚本会自动加载
    .env
    文件     —— 永远不要直接在行内传递凭证。
  5. 遇到304/403错误时立即停止，不要重试。 引导用户升级套餐（参考底部的付费功能指南）。

Setup

配置步骤

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.
.env
auto-loaded from: cwd → 
~/.openclaw/workspace/.env
→ 
~/.openclaw/.env
.
脚本内置免费密钥可直接使用（仅支持行情与基础信息查询）。如需查询大户/交易员/OI数据，请将你的API密钥添加到
.env
文件：
AICOIN_ACCESS_KEY_ID=your-key-id
AICOIN_ACCESS_SECRET=your-secret
可在https://www.aicoin.com/opendata 获取API密钥，查看付费功能指南了解套餐层级详情。
.env
文件会按以下路径自动加载：当前工作目录 → 
~/.openclaw/workspace/.env
→ 
~/.openclaw/.env
。

Quick Reference

快速参考

TaskCommandMin Tier
All tickers
node scripts/hl-market.mjs tickers
Free
BTC ticker
node scripts/hl-market.mjs ticker '{"coin":"BTC"}'
Free
Whale positions
node scripts/hl-market.mjs whale_positions '{"coin":"BTC"}'
Standard
Whale events
node scripts/hl-market.mjs whale_events '{"coin":"BTC"}'
Standard
Liquidation history
node scripts/hl-market.mjs liq_history '{"coin":"BTC"}'
Standard
OI summary
node scripts/hl-market.mjs oi_summary
Advanced
Trader stats
node scripts/hl-trader.mjs trader_stats '{"address":"0x...","period":"30"}'
Standard
Smart money
node scripts/hl-trader.mjs smart_find
Standard
Top open orders
node scripts/hl-trader.mjs top_open '{"coin":"BTC"}'
Basic
任务命令最低套餐
所有交易对行情
node scripts/hl-market.mjs tickers
免费
BTC单交易对行情
node scripts/hl-market.mjs ticker '{"coin":"BTC"}'
免费
大户持仓
node scripts/hl-market.mjs whale_positions '{"coin":"BTC"}'
标准
大户动态
node scripts/hl-market.mjs whale_events '{"coin":"BTC"}'
标准
清算历史
node scripts/hl-market.mjs liq_history '{"coin":"BTC"}'
标准
OI汇总
node scripts/hl-market.mjs oi_summary
高级
交易员统计
node scripts/hl-trader.mjs trader_stats '{"address":"0x...","period":"30"}'
标准
聪明资金
node scripts/hl-trader.mjs smart_find
标准
大额挂单
node scripts/hl-trader.mjs top_open '{"coin":"BTC"}'
基础

Scripts

脚本说明

scripts/hl-market.mjs — Market Data

scripts/hl-market.mjs — 市场数据

Tickers

行情

ActionDescriptionMin TierParams
tickers
All tickersFreeNone
ticker
Single coinFree
{"coin":"BTC"}
操作描述最低套餐参数
tickers
所有交易对行情免费无
ticker
单币种行情免费
{"coin":"BTC"}

Whales

大户

ActionDescriptionMin TierParams
whale_positions
Whale positionsStd
{"coin":"BTC","min_usd":"1000000"}
whale_events
Whale eventsStd
{"coin":"BTC"}
whale_directions
Long/short directionStd
{"coin":"BTC"}
whale_history_ratio
Historical long ratioStd
{"coin":"BTC"}
操作描述最低套餐参数
whale_positions
大户持仓标准
{"coin":"BTC","min_usd":"1000000"}
whale_events
大户动态标准
{"coin":"BTC"}
whale_directions
多空方向标准
{"coin":"BTC"}
whale_history_ratio
历史多头占比标准
{"coin":"BTC"}

Liquidations

清算

ActionDescriptionMin TierParams
liq_history
Liquidation historyStd
{"coin":"BTC"}
liq_stats
Liquidation statsStdNone
liq_stats_by_coin
Stats by coinStd
{"coin":"BTC"}
liq_top_positions
Large liquidationsStd
{"coin":"BTC","interval":"1d"}
操作描述最低套餐参数
liq_history
清算历史标准
{"coin":"BTC"}
liq_stats
清算统计标准无
liq_stats_by_coin
分币种清算统计标准
{"coin":"BTC"}
liq_top_positions
大额清算标准
{"coin":"BTC","interval":"1d"}

Open Interest

持仓量（OI）

ActionDescriptionMin TierParams
oi_summary
OI overviewAdvNone
oi_top_coins
OI rankingAdv
{"limit":"10"}
oi_history
OI historyPro
{"coin":"BTC","interval":"4h"}
操作描述最低套餐参数
oi_summary
OI概览高级无
oi_top_coins
OI排名高级
{"limit":"10"}
oi_history
OI历史专业
{"coin":"BTC","interval":"4h"}

Taker

吃单

ActionDescriptionMin TierParams
taker_delta
Taker deltaAdv
{"coin":"BTC"}
taker_klines
Taker K-linesStd
{"coin":"BTC","interval":"4h"}
操作描述最低套餐参数
taker_delta
吃单delta高级
{"coin":"BTC"}
taker_klines
吃单K线标准
{"coin":"BTC","interval":"4h"}

scripts/hl-trader.mjs — Trader Analytics

scripts/hl-trader.mjs — 交易员分析

Trader Stats

交易员统计

ActionDescriptionMin TierParams
trader_stats
Trader statisticsStd
{"address":"0x...","period":"30"}
best_trades
Best tradesStd
{"address":"0x...","period":"30"}
performance
Performance by coinStd
{"address":"0x...","period":"30"}
completed_trades
Completed tradesStd
{"address":"0x...","coin":"BTC"}
accounts
Batch accountsStd
{"addresses":"[\"0x...\"]"}
statistics
Batch statisticsStd
{"addresses":"[\"0x...\"]"}
操作描述最低套餐参数
trader_stats
交易员统计数据标准
{"address":"0x...","period":"30"}
best_trades
最优交易标准
{"address":"0x...","period":"30"}
performance
分币种收益表现标准
{"address":"0x...","period":"30"}
completed_trades
已完成交易标准
{"address":"0x...","coin":"BTC"}
accounts
批量账户查询标准
{"addresses":"[\"0x...\"]"}
statistics
批量统计查询标准
{"addresses":"[\"0x...\"]"}

Fills

成交记录

ActionDescriptionMin TierParams
fills
Address fillsStd
{"address":"0x..."}
fills_by_oid
By order IDStd
{"oid":"xxx"}
fills_by_twapid
By TWAP IDStd
{"twapid":"xxx"}
top_trades
Large tradesBasic
{"coin":"BTC","interval":"1d"}
操作描述最低套餐参数
fills
地址成交记录标准
{"address":"0x..."}
fills_by_oid
按订单ID查询成交标准
{"oid":"xxx"}
fills_by_twapid
按TWAP ID查询成交标准
{"twapid":"xxx"}
top_trades
大额交易基础
{"coin":"BTC","interval":"1d"}

Orders

订单

ActionDescriptionMin TierParams
orders_latest
Latest ordersStd
{"address":"0x..."}
order_by_oid
By order IDStd
{"oid":"xxx"}
filled_orders
Filled ordersStd
{"address":"0x..."}
filled_by_oid
Filled by IDStd
{"oid":"xxx"}
top_open
Large open ordersBasic
{"coin":"BTC","min_val":"100000"}
active_stats
Active statsBasic
{"coin":"BTC"}
twap_states
TWAP statesStd
{"address":"0x..."}
操作描述最低套餐参数
orders_latest
最新订单标准
{"address":"0x..."}
order_by_oid
按订单ID查询标准
{"oid":"xxx"}
filled_orders
已成交订单标准
{"address":"0x..."}
filled_by_oid
按ID查询已成交订单标准
{"oid":"xxx"}
top_open
大额挂单基础
{"coin":"BTC","min_val":"100000"}
active_stats
活跃订单统计基础
{"coin":"BTC"}
twap_states
TWAP状态标准
{"address":"0x..."}

Positions

持仓

ActionDescriptionMin TierParams
current_pos_history
Current position historyStd
{"address":"0x...","coin":"BTC"}
completed_pos_history
Closed position historyStd
{"address":"0x...","coin":"BTC"}
current_pnl
Current PnLStd
{"address":"0x...","coin":"BTC","interval":"1h"}
completed_pnl
Closed PnLStd
{"address":"0x...","coin":"BTC","interval":"1h"}
current_executions
Current executionsStd
{"address":"0x...","coin":"BTC","interval":"1h"}
completed_executions
Closed executionsStd
{"address":"0x...","coin":"BTC","interval":"1h"}
操作描述最低套餐参数
current_pos_history
当前持仓历史标准
{"address":"0x...","coin":"BTC"}
completed_pos_history
已平仓历史标准
{"address":"0x...","coin":"BTC"}
current_pnl
当前持仓盈亏标准
{"address":"0x...","coin":"BTC","interval":"1h"}
completed_pnl
已平仓盈亏标准
{"address":"0x...","coin":"BTC","interval":"1h"}
current_executions
当前持仓成交记录标准
{"address":"0x...","coin":"BTC","interval":"1h"}
completed_executions
已平仓成交记录标准
{"address":"0x...","coin":"BTC","interval":"1h"}

Portfolio

资产组合

ActionDescriptionMin TierParams
portfolio
Account curveStd
{"address":"0x...","window":"week"}
pnls
PnL curveStd
{"address":"0x...","period":"30"}
max_drawdown
Max drawdownStd
{"address":"0x...","days":"30"}
net_flow
Net flowStd
{"address":"0x...","days":"30"}
操作描述最低套餐参数
portfolio
账户净值曲线标准
{"address":"0x...","window":"week"}
pnls
盈亏曲线标准
{"address":"0x...","period":"30"}
max_drawdown
最大回撤标准
{"address":"0x...","days":"30"}
net_flow
资金净流入标准
{"address":"0x...","days":"30"}

Advanced

高级功能

ActionDescriptionMin TierParams
info
Info APIFree
{"type":"metaAndAssetCtxs"}
smart_find
Smart money discoveryStd
{}
discover
Trader discoveryAdv
{}
操作描述最低套餐参数
info
基础信息API免费
{"type":"metaAndAssetCtxs"}
smart_find
聪明资金发现标准
{}
discover
优质交易员发现高级
{}

Cross-Skill References

跨技能参考

NeedUse
Prices, K-lines, newsaicoin-market
Exchange trading (buy/sell), including Hyperliquid ordersaicoin-trading
Freqtrade strategies/backtestaicoin-freqtrade
需求使用技能
价格、K线、新闻aicoin-market
交易所交易（买/卖），包括Hyperliquid订单aicoin-trading
Freqtrade策略/回测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
  • errorCode 304 / HTTP 403
    —— 付费功能，参考下方付费功能指南。
  • Invalid coin
    —— 请使用大写币种名，例如
    BTC
    、
    ETH
    、
    SOL
  • Address format
    —— 必须是完整的
    0x...
    格式以太坊地址
  • Rate limit exceeded
    —— 请求间隔请等待1-2秒

Paid Feature Guide

付费功能指南

When a script returns 304 or 403: Do NOT retry. Tell the user:
  1. This feature needs a paid AiCoin API subscription.
  2. Get API key at https://www.aicoin.com/opendata
TierPriceHL Features
Free$0Tickers, info only
Basic$29/mo+ Top trades, top open orders, active stats
Standard$79/mo+ Whales, liquidations, trader analytics, taker K-lines
Advanced$299/mo+ OI summary/top, taker delta, trader discover
Professional$699/mo+ OI history
  1. Add to 
    .env
    : 
    AICOIN_ACCESS_KEY_ID=xxx
    / 
    AICOIN_ACCESS_SECRET=xxx
  2. Scripts auto-load 
    .env
    from cwd, 
    ~/.openclaw/workspace/.env
    , or 
    ~/.openclaw/.env
    .
当脚本返回304或403错误时：不要重试。 告知用户以下内容：
  1. 该功能需要订阅付费版AiCoin API。
  2. 可在https://www.aicoin.com/opendata 获取API密钥
套餐价格HL功能权限
免费$0仅支持行情、基础信息查询
基础$29/月额外支持大额交易、大额挂单、活跃订单统计
标准$79/月额外支持大户数据、清算数据、交易员分析、吃单K线
高级$299/月额外支持OI汇总/排名、吃单delta、优质交易员发现
专业$699/月额外支持OI历史数据
  1. 将密钥添加到
    .env
    文件：
    AICOIN_ACCESS_KEY_ID=xxx
    / 
    AICOIN_ACCESS_SECRET=xxx
  2. 脚本会自动从当前工作目录、
    ~/.openclaw/workspace/.env
    或
    ~/.openclaw/.env
    路径加载
    .env
    文件。