⚠️ 运行脚本: 必须先 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 env or printenv — 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 uses btcusdt:okex, not BTC/USDT
Rate limit exceeded — Wait 1-2s between requests; use batch queries

aicoin-market

Safety Notice

Copy this and send it to your AI assistant to learn