aicoin-market

name	aicoin-market
description	Crypto market data from AiCoin Open API v3 — 200+ exchanges, real-time. Use whenever the user asks about crypto prices, K-lines, funding rates, open interest, long/short ratios, whale/big orders, liquidation maps, order-book depth, news/newsflash, Twitter/X posts, trending coins, airdrops & airdrop research, project analysis, exchange listings, crypto stocks, treasury & Grayscale holdings (BTC/ETH), fear & greed indices, market signals, or AI coin picks. Triggers: 'BTC price', '查行情', '看价格', '大饼多少钱', 'K线', '资金费率', '多空比', '持仓量', '鲸鱼单', '大单', '清算', 'liquidation map', '深度', '快讯', '推特', '热门币', 'trending', '空投', '空投研报', '项目分析', '上了哪些交易所', 'ETF', '监管', '灰度', '国库', '上市公司持币', '恐慌贪婪指数'. ALWAYS run the script for real data — NEVER invent prices or use web_search/web_fetch/browser for crypto data. Use aicoin-hyperliquid for HL whale/trader analytics, aicoin-trading for CEX orders, aicoin-freqtrade for bots, aicoin-onchain for DEX swaps.
metadata	{"openclaw":{"primaryEnv":"AICOIN_ACCESS_KEY_ID","requires":{"bins":["node"]},"homepage":"https://www.aicoin.com/opendata","source":"https://github.com/aicoincom/coinos-skills","license":"MIT"}}
required_environment_variables	[{"name":"AICOIN_ACCESS_KEY_ID","optional":true,"prompt":"AiCoin Open API access key ID(可选;不填用内置免费 key,有速率限制)","help":"https://www.aicoin.com/opendata"},{"name":"AICOIN_ACCESS_SECRET","optional":true,"prompt":"AiCoin Open API access secret","help":"https://www.aicoin.com/opendata"}]

AiCoin Market

Crypto market data from the AiCoin Open API v3 — prices, K-lines, derivatives, news, signals, airdrops, treasuries and more across 200+ exchanges.

从 SKILL.md 所在目录运行脚本。CoinClaw 三引擎容器（OpenClaw / Hermes / Claude Code）自动注入 skill 路径，cd 到 skill 目录即可。

怎么用

一个命令调所有接口：

node scripts/aicoin.mjs <接口> '<JSON 参数>'

<接口> 就是 /api/v3/ 后面那段路径，例如 market/ticker、coins/tickers。

• 返回统一信封 { ok, data, error, meta } —— 先看 ok。ok:false 时看 error.code / error.message，里面写清楚了哪里错。
• 不确定有哪些接口、参数怎么填 → node scripts/aicoin.mjs catalog [分组]。catalog 是线上实时的接口菜单，永远准。先查它再调。
• 想知道当前 key 能用哪些接口 → node scripts/aicoin.mjs key。

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，别猜路径。

几条要记住的

1. 不编数据。 永远跑脚本拿真实数据。data 为空 / ok:false 就如实告诉用户，不要编解释、不要编价格。
2. 加密数据只用这个脚本，不要用 web_search / web_fetch / curl / 浏览器去拼。
3. coin_key 还是 coin？ 普通接口用 coin_key —— AiCoin 币种 slug，小写（bitcoin、ethereum）；hyperliquid/* 接口用 coin —— 交易符号（BTC、HYPE）。每个参数照 catalog 里的 desc / example 填。
4. 详情接口的 id 先从列表接口拿：快讯/文章详情先 content/newsflashes、content/articles 取 id；空投/项目详情先 airdrops、drop-radar/projects 取 project_id。
5. ok:false + HTTP 403 = 当前 key 无此接口权限，别重试。先别断言"套餐不够"：本地 host 常见坑是脚本 fallback 到了免费/旧 key —— 先 node scripts/aicoin.mjs key 看 key_id 是不是用户的专业版(key 应在 ~/.coinos/.env)。确属套餐不足，再告诉用户去 https://www.aicoin.com/opendata 升级。200 + 空 data 是"此条件下没数据"，不是出错。
6. 时间用 Unix 毫秒（start_time / end_time），分页用 limit / offset。
7. 用用户的语言回复（中文提问就全程中文）。

API Key

内置一个免费 key，开箱即用，够查行情、K 线、币种、新闻这些。资金费率、大单、清算、HL 鲸鱼、国库等需要付费套餐。收到 403 先 node scripts/aicoin.mjs key 核对 key_id 是不是用户的专业版(key 应放 ~/.coinos/.env),确认没加载错 key 再判断是否真套餐不够 —— 把"key 没加载对"误报成"接口要付费"会让付费用户暴怒。

用自己的 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