SKILL.md
$2d
node scripts/aicoin.mjs catalog # 看全部 183 个接口（按分组）
node scripts/aicoin.mjs catalog derivatives # 看 derivatives 分组每个接口的参数
node scripts/aicoin.mjs market/ticker '{"coin_key":"bitcoin","market":"binance"}'常用接口速查
想查什么
接口 + 例子
币价 / 涨跌 / 市值 / 净流入
coins/tickers '{"coin_key":"bitcoin,ethereum"}' —— degree_24h_usd / degree_7day_usd 是 24h / 7 天涨跌幅(%)
单交易对实时行情
market/ticker '{"coin_key":"bitcoin","market":"binance"}'
K 线
market/klines '{"coin_key":"bitcoin","market":"binance","interval":"1h","limit":100}'
搜币种 / 查某币在哪些交易所
coins/search '{"query":"PEPE"}' —— 每条结果带 db_keys，列出该币跨交易所的全部交易对
币种详情 / 简介
coins/detail '{"coin_key":"bitcoin"}'
全部币种 / 全部交易所
coins '{"limit":100}' ／ markets
某交易所全部交易对行情
market/tickers '{"market":"binance"}'
交易对列表
pairs '{"market":"binance"}'
热门赛道币
markets/hot-coins '{"tab_key":"defi"}'
资金费率
derivatives/funding-rates '{"coin_key":"bitcoin","market":"binance"}' —— 返回 8h OHLC 序列，close 是当期结算费率（小数，×100 得百分比）
多空比
单交易对历史序列 derivatives/long-short-ratio '{"coin_key":"bitcoin","market":"binance"}'；全市场当前汇总 derivatives/long-short-ratio/summary（不分币种，别当成某个币的）
合约持仓量排名
derivatives/open-interest/ranking
清算地图 / 清算汇总
derivatives/liquidations/map '{"coin_key":"bitcoin","market":"binance","window":"24h"}' ／ derivatives/liquidations/summary
大单 / 大单成交
market/big-orders '{"coin_key":"bitcoin","market":"binance"}' ／ market/aggregate-trades '{"coin_key":"bitcoin","market":"binance"}'
订单簿深度
market/orderbook/latest-depth '{"coin_key":"bitcoin","market":"binance"}'
资讯文章 / 快讯
content/articles ／ content/newsflashes ／ 行业 content/newsflashes/industry
搜快讯
content/newsflashes/search '{"query":"bitcoin"}'
推特/X
content/social/x/posts/latest ／ 搜 content/social/x/posts/search '{"query":"bitcoin"}'
空投项目（有哪些值得做）
drop-radar/projects —— 项目最全；详情 drop-radar/projects/detail '{"project_id":"..."}'
交易所空投 / 空投日历
airdrops '{"source":"all"}'（交易所活动，可能为空）／ airdrops/calendar '{"year":2026,"month":5}'
上市公司持币（国库）
treasuries/summary '{"coin_key":"bitcoin"}' ／ 实体 treasuries/entities '{"coin_key":"bitcoin"}'
灰度持仓
institutions/grayscale/holdings
加密概念股 / 全球股指
equities/crypto-exposure/quotes ／ macro/stock-indices
指数（恐慌贪婪等）
indexes ／ indexes/ticker '{"index_key":"i:fgi:alternative"}'
异动信号 / 预警
signals/changes ／ signals/alerts
AI 选币推荐
coins/recommendations '{"coin_keys":["bitcoin"]}'
其他接口都在 catalog 里 —— 查不到想要的就先跑 catalog，别猜路径。
几条要记住的
- 不编数据。 永远跑脚本拿真实数据。
data为空 /ok:false就如实告诉用户，不要编解释、不要编价格。
- 加密数据只用这个脚本，不要用
web_search/web_fetch/curl/ 浏览器去拼。
- **
coin_key还是coin？** 普通接口用coin_key—— AiCoin 币种 slug，小写（bitcoin、ethereum）；hyperliquid/*接口用coin—— 交易符号（BTC、HYPE）。每个参数照catalog里的desc/example填。
- 详情接口的 id 先从列表接口拿：快讯/文章详情先
content/newsflashes、content/articles取 id；空投/项目详情先airdrops、drop-radar/projects取project_id。
- **
ok:false+ HTTP 403 = 当前套餐不覆盖这个接口，别重试**，告诉用户去 https://www.aicoin.com/opendata 升级。200+ 空data是"此条件下没数据"，不是出错。
- 时间用 Unix 毫秒（
start_time/end_time），分页用limit/offset。
- 用用户的语言回复（中文提问就全程中文）。
API Key
内置一个免费 key，开箱即用，够查行情、K 线、币种、新闻这些。资金费率、大单、清算、HL 鲸鱼、国库等需要付费套餐 —— 某接口返回 403 就是套餐不够。
用自己的 key —— 推荐 set-key 命令（会先验证再写入 .env，禁止手编 .env）：
node scripts/aicoin.mjs set-key <key_id> <secret>
# 或直接把 AiCoin 后台 JSON 整段喂进来，脚本认字段名：
node scripts/aicoin.mjs set-key '{"api_key":"<id>","access_key":"<secret>"}'⚠️ AiCoin 后台字段名反直觉：JSON 里的 api_key 其实是公开 ID（对应 AICOIN_ACCESS_KEY_ID），access_key 才是 SECRET（对应 AICOIN_ACCESS_SECRET）。脚本帮你按这个映射存，不用人脑反向。
环境变量名（写 .env 或 export 用）：
AICOIN_ACCESS_KEY_ID=... # = AiCoin 后台的 api_key
AICOIN_ACCESS_SECRET=... # = AiCoin 后台的 access_key安全说明：AiCoin API Key 只用于获取市场数据，无法交易、无法读取你在交易所的任何信息。所有密钥只存在本地 .env，不上传任何服务器。CoinClaw 用户在 web UI 的 EnvSection 里配置。
跨 skill
需求
用哪个 skill
Hyperliquid 鲸鱼 / 聪明钱 / 链上大资金
aicoin-hyperliquid
交易所下单 / 平仓 / 查余额
aicoin-trading
Freqtrade 策略 / 回测 / 部署
aicoin-freqtrade
链上 DEX swap / 钱包 / token
aicoin-onchain