aicoin-market

name	aicoin-market
description	This skill should be used when the user asks about crypto prices, market data, K-line charts, funding rates, open interest, long/short ratios, whale orders, liquidation data, crypto news, newsflash, Twitter crypto tweets, trending coins, airdrops, drop radar, airdrop research, project analysis, exchange listings, stock quotes, treasury holdings, or any crypto market query. Also use when user asks about configuring or checking AiCoin API key. Use when user says: 'BTC price', 'check price', 'show K-line', 'funding rate', 'open interest', 'whale orders', 'long/short ratio', 'crypto news', 'newsflash', 'ETF', '监管', '政策', 'trending coins', 'airdrop', 'drop radar', '查行情', '看价格', '大饼多少钱', 'K线', '资金费率', '多空比', '鲸鱼单', '新闻', '快讯', '新闻快讯', '热门币', '空投', '空投项目', '空投机会', '空投研报', '项目分析', '项目详情', '上了哪些交易所', '推特', 'Twitter', 'liquidation map', '配置AiCoin key', 'AiCoin API key', 'AiCoin key安全吗'. Covers 200+ exchanges with real-time data. MUST run node scripts to fetch real data. NEVER generate fake prices or hallucinate market data. NEVER use web_search/web_fetch for airdrop, project, news, or Twitter data — always use airdrop.mjs, drop_radar.mjs, news.mjs, newsflash.mjs, or twitter.mjs scripts. IMPORTANT — AiCoin API Key: When user asks about AiCoin API key (配置/检查/安全/能不能交易), run `node scripts/coin.mjs api_key_info` FIRST, show the security_notice to user. For exchange trading (buy/sell/balance), use aicoin-trading instead. For Freqtrade strategies/backtest, use aicoin-freqtrade. For Hyperliquid whale analytics, use aicoin-hyperliquid.
metadata	{"openclaw":{"primaryEnv":"AICOIN_ACCESS_KEY_ID","requires":{"bins":"[Truncated]"},"homepage":"https://www.aicoin.com/opendata","source":"https://github.com/aicoincom/coinos-skills","license":"MIT"}}

⚠️ 运行脚本: 必须先 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

1. NEVER fabricate data. Always run scripts. If data is empty or errors occur, say so directly — do NOT invent explanations.
2. NEVER use curl, web_fetch, web_search, or browser for crypto/airdrop/project data. Always use these scripts.
3. NEVER run env or printenv — leaks API secrets into logs.
4. Scripts auto-load .env — never pass credentials inline.
5. Reply in the user's language. Chinese input = all-Chinese response (titles, headings, analysis).
6. On 304/403 error — STOP, do NOT retry. This is a paid feature. Follow the Paid Feature Guide to help the user upgrade.
7. 更换 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

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"}

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"} Optional: open_time, since
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

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

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