aicoin-market

AiCoin Market

AiCoin Open API v3 による暗号資産市場データ — 200 以上の取引所の価格、K ライン、デリバティブ、ニュース、シグナル、エアドロップ、トレジャリーなど。

スクリプトは SKILL.md があるディレクトリから実行してください。CoinClaw の三エンジンコンテナ（OpenClaw / Hermes / Claude Code）がスキルのパスを自動で注入するため、スキルのディレクトリに cd するだけで実行できます。

使い方

1 つのコマンドですべてのインターフェースを呼び出せます。

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 は 24 時間／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"}' —— 8 時間ごとの 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"}'
Twitter/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"}'
Grayscale の保有状況	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. K 线取最新值只读 _timeseries.latest，并按 _timeseries.field 核对时间字段（通常是 time / timestamp）。时间距当前超过两个 K 线周期时只能标注“最新到某时”，禁止称为“当前/实时”。不得用 head / tail / cut 截断 JSON 后猜数组顺序。
8. 只使用 scripts/aicoin.mjs。旧 market.mjs 等 v2 入口已停用；收到 legacy_entrypoint_retired 必须按返回提示迁移，不能绕过或从残留脚本取数。
9. 用用户的语言回复（中文提问就全程中文）。
10. 不要把上游故障误判成 Key 失效。 node scripts/aicoin.mjs key 只用基础行情探测判断 Key：核心探测 401 才表示 Key 无效，403 是权限不覆盖，超时或 5xx 是接口/上游异常。可选接口失败时，已成功的行情和 K 线仍可继续用于回答。
11. 故障接口不要连续重试。 单次请求超时或 5xx 后立即降级并如实标注；资金费率、深度、指标属于可选增强数据，不能因为它们失败就声称“所有数据都查不到”。
12. 指标先查覆盖。 调 market/indicator-klines 前先调 market/indicator-pairs 确认交易对和指标有覆盖。两者返回 200 空序列时表示暂无覆盖，跳过该指标，不做本地计算，也不要重试。
13. 严格尊重 K 线周期。 用户问“单日涨跌超过 8%”时必须使用 1d K 线；不能拿 3d K 线替代“单日”。若日线历史窗口不足，就基于现有日线给出结论并明确样本范围。

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