skills/aicoin-market/SKILL.md
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.
npx skillsauth add aicoincom/coinos-skills aicoin-marketInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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 是线上实时的接口菜单,永远准。先查它再调。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,别猜路径。
data 为空 / ok:false 就如实告诉用户,不要编解释、不要编价格。web_search / web_fetch / curl / 浏览器去拼。coin_key 还是 coin? 普通接口用 coin_key —— AiCoin 币种 slug,小写(bitcoin、ethereum);hyperliquid/* 接口用 coin —— 交易符号(BTC、HYPE)。每个参数照 catalog 里的 desc / example 填。content/newsflashes、content/articles 取 id;空投/项目详情先 airdrops、drop-radar/projects 取 project_id。ok:false + HTTP 403 = 当前套餐不覆盖这个接口,别重试,告诉用户去 https://www.aicoin.com/opendata 升级。200 + 空 data 是"此条件下没数据",不是出错。start_time / end_time),分页用 limit / offset。内置一个免费 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 | |------|------| | Hyperliquid 鲸鱼 / 聪明钱 / 链上大资金 | aicoin-hyperliquid | | 交易所下单 / 平仓 / 查余额 | aicoin-trading | | Freqtrade 策略 / 回测 / 部署 | aicoin-freqtrade | | 链上 DEX swap / 钱包 / token | aicoin-onchain |
data-ai
--- name: aicoin-trading description: "**CEX 中心化交易所**(Binance / OKX / Bybit / Bitget 等)的下单交易工具。严格规则:(1) 所有订单必须通过 node scripts/exchange.mjs create_order 执行,禁止写自定义代码下单 (2) create_order 分两步:第一次返回预览,展示给用户等确认,用户说确认后第二次加 confirmed=true 执行 (3) 禁止自动确认,禁止跳过预览 (4) 平仓必须用 close_position,禁止用 create_order 构建平仓单。Trigger 关键词: 'buy on okx', 'sell on binance', '在 OKX 买 BTC', '在 Binance 下单', '做多 BTC 永续', '杠杆做空 ETH', '平掉我的 SOL 仓位', 'CEX 下单', '现货买入', '合约开仓', '永续平仓', '止盈止损', 'long', 'short', 'leverage', '买', '卖', '下单
development
Use this skill for **on-chain DEX trading and wallet operations on EVM/Solana chains**: token swap quotes, swap execution, wallet portfolio/balance queries, gas estimation, transaction broadcasting, token search/info on Ethereum/Solana/Base/BSC/Arbitrum/Polygon etc. Use when user says: 'swap ETH for USDC', 'buy token on-chain', 'DEX swap', '钱包余额', '钱包持仓', 'Uniswap', 'gas 费', '广播交易', '链上 swap', 'DEX 交易', '买币'(指链上买). Powered by OKX Web3 DEX API. MUST run node scripts. **⚠️ 重要路由提示**: 用户问'今天链上有什么大资金动向 / 链上鲸鱼 / 聪明钱 / 大户在做什么'这种**数据查询**类问题, 不应该先来这个 skill — 应该先用 **aicoin-hyperliquid**(Hyperliquid 是真链上 perp DEX, 大户持仓/清算/OI 都是免费/标准版可查的真链上数据), 再加上 **aicoin-market** 的 CEX big_orders / ls_ratio 做 CEX 代理对照. 本 skill 的 OKX Web3 接口主要服务**交易动作**(swap/钱包余额),不是数据探查; 即使 token.mjs 有 trending/hot_tokens, 也要求用户配置 OKX Web3 API Key — 而上述两个数据查询路径无需此 key. For CEX trading (Binance/OKX spot/futures), use aicoin-trading. For CEX market data (funding rates, OI, liquidation), use aicoin-market.
development
Hyperliquid on-chain perpetuals analytics from AiCoin Open API v3 — the primary source for on-chain whale / smart-money / large-fund movement. Use this skill when the user asks about: Hyperliquid whale positions, HL liquidations, HL open interest, HL trader analytics, HL taker flow, HL funding history, AND generic on-chain whale activity — '链上大资金动向', '链上鲸鱼', '聪明钱', '大户在干嘛', 'on-chain whale', 'smart money', 'Hyperliquid大户', 'HL鲸鱼', 'HL持仓', 'HL清算', 'HL持仓量', 'HL交易员', 'HL 资金费率' — because HL is the deepest on-chain perp venue and AiCoin exposes its whale positions / events / liquidations / trader stats without needing any wallet key. For general crypto prices/news use aicoin-market; for DEX swaps / wallets use aicoin-onchain; for CEX trading use aicoin-trading; for Freqtrade use aicoin-freqtrade.
development
Use when user asks about Freqtrade — strategy creation, backtest, hyperopt, switching strategies / pairs / dry-run mode, querying live bot status / balance / open positions / 盈亏. Trigger words: 'write strategy', 'create strategy', 'backtest', 'switch strategy', 'switch to live', 'open positions', 'P&L', '写策略', '创建策略', '回测', '部署策略', '切策略', '切实盘', '当前持仓', '今天赚多少', '盈亏'. In CoinClaw containers (OpenClaw / Hermes / Claude Code) freqtrade is a supervisord-managed daemon on :8080 — this skill auto-detects engine + paths via lib/coinclaw-env.mjs and never spawns competing freqtrade processes. Outside CoinClaw it falls back to host mode (clone freqtrade + nohup). For prices/charts use aicoin-market. For exchange trading use aicoin-trading. For Hyperliquid use aicoin-hyperliquid.