aicoin-market
⚠️ 运行脚本: 必须先 cd 到本 SKILL.md 所在目录再执行。示例:
cd ~/.openclaw/workspace/skills/aicoin-market && node scripts/market.mjs ...
AiCoin Market
Crypto market data toolkit powered by AiCoin Open API. Prices, K-lines, news, signals, whale orders, and more from 200+ exchanges.
Version: 1.0.0
Critical Rules
- NEVER fabricate data. Always run scripts. If data is empty or errors occur, say so directly — do NOT invent explanations.
- NEVER use curl, web_fetch, web_search, or browser for crypto/airdrop/project data. Always use these scripts.
- NEVER run
envorprintenv— leaks API secrets into logs. - Scripts auto-load
.env— never pass credentials inline. - Reply in the user's language. Chinese input = all-Chinese response (titles, headings, analysis).
- On 304/403 error — STOP, do NOT retry. This is a paid feature. Follow the Paid Feature Guide to help the user upgrade.
- 更换 API Key 只能用
update_key命令。 禁止直接编辑 .env、禁止用 gateway/edit 工具改 key。update_key会先验证 key 有效才写入。
Quick Reference
| Task | Command | Min Tier |
|---|---|---|
| Search coin dbKey | node scripts/coin.mjs search '{"search":"BTC"}' — 不确定 symbol 时先用这个查 dbKey |
免费版 |
| 空投查询 | node scripts/airdrop.mjs all — 查空投必用此命令，自动合并交易所空投+链上早期项目 |
基础版 |
| 项目深度分析 | node scripts/drop_radar.mjs detail '{"airdrop_id":"xxx"}' — 自动包含团队+X关注，不要用 web_search |
基础版 |
| 查币上了哪些交易所 | node scripts/coin.mjs search '{"search":"OPN"}' — 返回全部交易所交易对 |
免费版 |
| API Key Info | node scripts/coin.mjs api_key_info — When user asks about AiCoin API key (配置/安全/能不能下单), ALWAYS run this first. |
免费版 |
| Update API Key | node scripts/coin.mjs update_key '{"key_id":"xxx","secret":"xxx"}' — 更换 key 必须用此命令（自动验证+写入），禁止直接编辑 .env |
免费版 |
| BTC price | node scripts/coin.mjs coin_ticker '{"coin_list":"bitcoin"}' |
免费版 |
| K-line | node scripts/market.mjs kline '{"symbol":"btcusdt:okex","period":"3600","size":"100"}' |
免费版 |
| Funding rate | node scripts/coin.mjs funding_rate '{"symbol":"BTC"}' |
基础版 |
| Long/short ratio | node scripts/features.mjs ls_ratio |
基础版 |
| Whale orders | node scripts/features.mjs big_orders '{"symbol":"btcswapusdt:binance"}' |
标准版 |
| News flash | node scripts/news.mjs flash_list '{"language":"cn"}' |
基础版 |
| Trending coins | node scripts/market.mjs hot_coins '{"key":"defi"}' |
免费版 |
| Open interest | node scripts/coin.mjs open_interest '{"symbol":"BTC","interval":"15m"}' |
专业版 |
| Liquidation map | node scripts/coin.mjs liquidation_map '{"dbkey":"btcswapusdt:binance","cycle":"24h"}' |
高级版 |
Symbol Discovery: dbKey 格式不用猜。先用 search 查，再用返回的 dbKey 调其他接口：
node scripts/coin.mjs search '{"search":"BTC"}' # → dbKeys: ["btcswapusdt:binance", "btcusdt:okex", ...]
node scripts/coin.mjs search '{"search":"CL"}' # → dbKeys: ["clswapusdc:hyperliquid", ...]
node scripts/market.mjs kline '{"symbol":"从search拿到的dbKey","period":"3600"}'
常用币快捷方式： BTC, ETH, SOL, DOGE, XRP 在 coin.mjs 里自动解析，无需 search。其他币必须先 search。
中文俗称： 大饼=BTC, 姨太=ETH, 狗狗=DOGE, 瑞波=XRP, 索拉纳=SOL.
常用工作流
空投查询： 用户问空投/airdrop/优质项目 时，只需一条命令查全部数据：
node scripts/airdrop.mjs all — 自动同时查交易所空投 + 链上早期项目，合并返回。
项目深度分析： 用户问某项目详情/研报时，用 drop_radar.mjs detail（自动包含团队 + X关注数据）：
node scripts/drop_radar.mjs detail '{"airdrop_id":"xxx"}' — 返回项目详情 + 团队 + X关注列表。
如已发代币，再用 node scripts/coin.mjs search '{"search":"代币名"}' 查价格和交易对。
不要用 web_search 替代，数据都在脚本里。
查币上了哪些交易所： node scripts/coin.mjs search '{"search":"OPN"}' — 返回全部交易所的交易对（现货+合约），不要用其他接口拼凑。
推特/Twitter 讨论： 用户问推特/Twitter热点时，用 twitter.mjs latest 或 twitter.mjs search，不要用 newsflash 替代。
Free vs Paid Endpoints
Free (built-in key, no config needed): coin_ticker, kline, hot_coins, exchanges, pair_ticker, news_rss — only 6 endpoints.
基础版 ($29/mo) adds: coin_list, coin_config, funding_rate, trade_data, ticker, futures_interest, ls_ratio, nav, pair_by_market, pair_list, news_list, flash_list, twitter/latest, twitter/search, newsflash/search, newsflash/list
标准版 ($79/mo) adds: big_orders, agg_trades, grayscale_trust, gray_scale, signal_alert, signal_config, strategy_signal, change_signal, depth_latest, newsflash, news_detail, twitter/members, twitter/interaction_stats, newsflash/detail
高级版 ($299/mo) adds: liquidation_map, liquidation_history, liquidation, indicator_kline, indicator_pairs, index_list, index_price, index_info, depth_full, depth_grouped
专业版 ($699/mo) adds: ai_analysis, open_interest, estimated_liquidation, historical_depth, super_depth, stock_quotes, stock_top_gainer, stock_company, treasury_*, stock_market, signal_alert_list, exchange_listing
Full tier table: docs/api-tiers.md
Setup
Scripts work out of the box with a built-in free key (6 endpoints). For more endpoints, add your API key to .env:
AICOIN_ACCESS_KEY_ID=your-key
AICOIN_ACCESS_SECRET=your-secret
安全说明： AiCoin API Key 仅用于获取市场数据（行情、K线、新闻等），无法进行任何交易操作，也无法读取你在交易所的信息。如需交易功能，需单独到交易所申请交易 API Key（见 aicoin-trading skill）。所有密钥仅保存在本地设备 .env 文件中，不会上传到任何服务器。
.env is auto-loaded from: cwd → ~/.openclaw/workspace/.env → ~/.openclaw/.env
Scripts
All scripts: node scripts/<name>.mjs <action> [json-params]
scripts/coin.mjs — Coin Data
| Action | Description | Min Tier | Params |
|---|---|---|---|
search |
搜索币种，获取 dbKey。 不确定 symbol 格式时先用这个查。 | 免费版 | {"search":"BTC"} Optional: market, trade_type, page, page_size |
api_key_info |
AiCoin API Key status + security notice. Run when user asks about key config/safety. | 免费版 | None |
update_key |
更换 API Key（先验证再写入 .env）。禁止直接编辑 .env 更换 key。 | 免费版 | {"key_id":"xxx","secret":"xxx"} |
coin_ticker |
Real-time prices | 免费版 | {"coin_list":"bitcoin,ethereum"} |
coin_list |
List all coins | 基础版 | None |
coin_config |
Coin profile | 基础版 | {"coin_list":"bitcoin"} |
funding_rate |
Funding rate (BTC only, aggregated) | 基础版 | {"symbol":"BTC","interval":"8h"} Weighted: add "weighted":"true" (基础版). For per-exchange real-time rates, use aicoin-trading: node scripts/exchange.mjs funding_rate '{"exchange":"binance","symbol":"BTC/USDT:USDT"}' |
trade_data |
Trade data | 基础版 | {"symbol":"btcswapusdt:okcoinfutures"} |
ai_analysis |
AI analysis & prediction | 专业版 | {"coin_keys":"[\"bitcoin\"]","language":"CN"} |
open_interest |
Open interest | 专业版 | {"symbol":"BTC","interval":"15m"} Coin-margined: add "margin_type":"coin" |
liquidation_map |
Liquidation heatmap | 高级版 | {"symbol":"btcswapusdt:binance","cycle":"24h"} |
liquidation_history |
Liquidation history | 高级版 | {"symbol":"btcswapusdt:binance","interval":"1m"} |
estimated_liquidation |
Estimated liquidation | 专业版 | {"symbol":"btcswapusdt:binance","cycle":"24h"} |
historical_depth |
Historical depth | 专业版 | {"symbol":"btcswapusdt:okcoinfutures"} |
super_depth |
Large order depth >$10k | 专业版 | {"symbol":"btcswapusdt:okcoinfutures"} |
scripts/market.mjs — Market Data
| Action | Description | Min Tier | Params |
|---|---|---|---|
kline |
Standard K-line | 免费版 | {"symbol":"btcusdt:okex","period":"3600","size":"100"} period: 900/3600/14400/86400 |
hot_coins |
Trending coins | 免费版 | {"key":"defi"} key: gamefi/anonymous/market/web/newcoin/stable/defi |
exchanges |
Exchange list | 免费版 | None |
ticker |
Exchange tickers | 基础版 | {"market_list":"okex,binance"} |
futures_interest |
Futures OI ranking | 基础版 | {"language":"cn"} |
depth_latest |
Real-time depth | 标准版 | {"symbol":"btcswapusdt:binance"} |
indicator_kline |
Indicator K-line | 高级版 | {"symbol":"btcswapusdt:binance","indicator_key":"fundflow","period":"3600"} |
indicator_pairs |
Indicator pairs | 高级版 | {"indicator_key":"fundflow"} |
index_list |
Index list | 高级版 | None |
index_price |
Index price | 高级版 | {"key":"i:diniw:ice"} |
index_info |
Index details | 高级版 | {"key":"i:diniw:ice"} |
depth_full |
Full order book | 高级版 | {"symbol":"btcswapusdt:binance"} |
depth_grouped |
Grouped depth | 高级版 | {"symbol":"btcswapusdt:binance","groupSize":"100"} |
stock_quotes |
Stock quotes | 专业版 | {"tickers":"i:mstr:nasdaq"} |
stock_top_gainer |
Top gainers | 专业版 | {"us_stock":"true"} |
stock_company |
Company details | 专业版 | {"symbol":"i:mstr:nasdaq"} |
treasury_entities |
Holding entities | 专业版 | {"coin":"BTC"} |
treasury_history |
Transaction history | 专业版 | {"coin":"BTC"} |
treasury_accumulated |
Accumulated holdings | 专业版 | {"coin":"BTC"} |
treasury_latest_entities |
Latest entities | 专业版 | {"coin":"BTC"} |
treasury_latest_history |
Latest history | 专业版 | {"coin":"BTC"} |
treasury_summary |
Holdings overview | 专业版 | {"coin":"BTC"} |
scripts/features.mjs — Features & Signals
| Action | Description | Min Tier | Params |
|---|---|---|---|
pair_ticker |
Pair ticker | 免费版 | {"key_list":"btcusdt:okex,btcusdt:huobipro"} |
ls_ratio |
Long/short ratio | 基础版 | None |
nav |
Market navigation | 基础版 | {"language":"cn"} |
pair_by_market |
Pairs by exchange | 基础版 | {"market":"binance"} |
pair_list |
Pair list | 基础版 | {"market":"binance","currency":"USDT"} |
grayscale_trust |
Grayscale trust | 标准版 | None |
gray_scale |
Grayscale holdings | 标准版 | {"coins":"btc,eth"} |
signal_alert |
Signal alerts | 标准版 | None |
signal_config |
Alert config | 标准版 | {"language":"cn"} |
strategy_signal |
Strategy signal | 标准版 | {"signal_key":"depth_win_one"} |
change_signal |
Anomaly signal | 标准版 | {"type":"1"} |
big_orders |
Whale orders | 标准版 | {"symbol":"btcswapusdt:binance"} |
agg_trades |
Aggregated large trades | 标准版 | {"symbol":"btcswapusdt:binance"} |
liquidation |
Liquidation data | 高级版 | {"type":"1","coinKey":"bitcoin"} |
signal_alert_list |
Alert list | 专业版 | None |
stock_market |
Crypto stocks | 专业版 | None |
delete_signal |
Delete alert | 专业版 | {"id":"xxx"} |
scripts/news.mjs — News & Content
| Action | Description | Min Tier | Params |
|---|---|---|---|
news_rss |
RSS news feed | 免费版 | {"page":"1"} |
news_list |
News list | 基础版 | {"page":"1","page_size":"20"} |
flash_list |
Industry flash news | 基础版 | {"language":"cn"} |
newsflash |
AiCoin flash news | 标准版 | {"language":"cn"} |
news_detail |
News detail | 标准版 | {"id":"xxx"} |
exchange_listing |
Exchange listing announcements | 专业版 | {"memberIds":"477,1509"} |
scripts/twitter.mjs — Twitter/X Crypto Tweets
| Action | Description | Min Tier | Params |
|---|---|---|---|
latest |
Latest crypto tweets | 基础版 | {"language":"cn","page_size":"20"} |
search |
Search tweets | 基础版 | {"keyword":"bitcoin","language":"cn","page_size":"20"} |
members |
Search KOL/users | 标准版 | {"keyword":"elon","page":"1","page_size":"20"} |
interaction_stats |
Tweet engagement stats | 标准版 | {"flash_ids":"123,456,789"} |
scripts/newsflash.mjs — Newsflash (OpenData)
| Action | Description | Min Tier | Params |
|---|---|---|---|
search |
Search newsflash | 基础版 | {"keyword":"bitcoin","page":"1","page_size":"20"} |
list |
Newsflash list with filters | 基础版 | {"page_size":"20","language":"cn"} |
detail |
Newsflash full content | 标准版 | {"flash_id":"123456"} |
scripts/airdrop.mjs — Airdrop (OpenData)
| Action | Description | Min Tier | Params |
|---|---|---|---|
all |
综合查询（推荐） — 同时查交易所空投+链上早期项目，合并返回 | 基础版 | {"page_size":"20"} Optional: status, keyword, lan |
list |
Airdrop projects list (multi-source) | 基础版 | {"source":"all","status":"ongoing","page":"1","page_size":"20","exchange":"binance"} |
detail |
Airdrop detail (hodler/xlaunch) | 标准版 | {"type":"hodler","token":"SIGN"} |
banner |
Hot airdrop banners | 基础版 | {"limit":"5"} |
exchanges |
Available exchanges and activity types | 基础版 | {"lan":"cn"} |
calendar |
Airdrop calendar (year+month required) | 标准版 | {"year":"2026","month":"3"} |
Source options for list: all(default), hodler, xlaunch, earncoin, alpha, bitget_launchpool, bitget_poolx
scripts/drop_radar.mjs — Drop Radar (OpenData)
| Action | Description | Min Tier | Params |
|---|---|---|---|
list |
Project list with filters | 基础版 | {"page":"1","page_size":"20","status":"CONFIRMED","keyword":"airdrop"} |
detail |
Project detail（自动包含团队+X关注） | 基础版 | {"airdrop_id":"xxx"} |
widgets |
Statistics overview | 基础版 | {"lan":"cn"} |
filters |
Available filter options | 基础版 | {"lan":"cn"} |
events |
Project event calendar | 标准版 | {"airdrop_id":"xxx"} |
team |
Project team members | 标准版 | {"airdrop_id":"xxx"} |
x_following |
Project X following list | 标准版 | {"airdrop_id":"xxx"} |
status_changes |
Recent status changes | 标准版 | {"days":"7","page":"1","page_size":"20"} |
tweets |
Search project tweets | 标准版 | {"keywords":"bitcoin,airdrop","page_size":"20"} |
Cross-Skill References
| Need | Use |
|---|---|
| Exchange trading (buy/sell/balance) | aicoin-trading |
| Freqtrade strategies/backtest/deploy | aicoin-freqtrade |
| Hyperliquid whale tracking | aicoin-hyperliquid |
Common Errors
errorCode 304 / HTTP 403— Paid feature. Script output includes upgrade link and instructions. Show them to user. Do NOT retry.Invalid symbol— Check format: AiCoin usesbtcusdt:okex, notBTC/USDTRate limit exceeded— Wait 1-2s between requests; use batch queries