SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场aicoin-market

aicoin-market

数据与分析

查看项目

更新于 10-15 14:26

技能介绍

AiCoin Market 是一个加密货币市场数据技能，数据来自 AiCoin Open API v3，覆盖 200 多家交易所的实时行情，包括价格、K 线、衍生品、资讯、信号、空投、国库持仓等。

用途 该技能用于在对话中获取加密货币市场数据。当用户询问币价、K 线、资金费率、持仓量、清算、资讯、空投、上市公司持币等信息时，可通过它调用 AiCoin 的接口获取真实数据。

主要能力

  • 行情数据：币价、涨跌幅、市值、净流入（coins/tickers）；单交易对实时行情（market/ticker）；K 线（market/klines）；某交易所全部交易对行情（market/tickers）；交易对列表（pairs）；热门赛道币（markets/hot-coins）。
  • 币种信息：搜索币种及跨交易所交易对（coins/search）；币种详情与简介（coins/detail）；全部币种与交易所（coins、markets）。
  • 衍生品数据：资金费率（derivatives/funding-rates，返回 8h OHLC 序列）；多空比（derivatives/long-short-ratio 及 summary）；合约持仓量排名（derivatives/open-interest/ranking）；清算地图与汇总（derivatives/liquidations/map、summary）。
  • 交易微观数据：大单（market/big-orders）；大单成交（market/aggregate-trades）；订单簿深度（market/orderbook/latest-depth）。
  • 内容资讯：资讯文章（content/articles）、快讯（content/newsflashes）、行业快讯（content/newsflashes/industry）、快讯搜索（content/newsflashes/search）；推特/X 最新与搜索（content/social/x/posts/latest、search）。
  • 空投与机构：空投项目（drop-radar/projects 及详情）；交易所空投与空投日历（airdrops、airdrops/calendar）；上市公司持币（treasuries/summary、entities）；灰度持仓（institutions/grayscale/holdings）。
  • 其他：加密概念股与全球股指（equities/crypto-exposure/quotes、macro/stock-indices）；指数如恐慌贪婪（indexes、indexes/ticker）；异动信号与预警（signals/changes、signals/alerts）；AI 选币推荐（coins/recommendations）。

使用方式 从 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 [分组] 查看线上实时接口菜单（共 183 个接口，按分组）。查看当前 key 可用接口运行 node scripts/aicoin.mjs key。

示例： node scripts/aicoin.mjs catalog node scripts/aicoin.mjs catalog derivatives node scripts/aicoin.mjs market/ticker '{"coin_key":"bitcoin","market":"binance"}'

API Key 内置一个免费 key，开箱即用，够查行情、K 线、币种、新闻。资金费率、大单、清算、HL 鲸鱼、国库等需要付费套餐。使用自己的 key 推荐 set-key 命令（会先验证再写入 .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）。环境变量名为 AICOIN_ACCESS_KEY_ID 与 AICOIN_ACCESS_SECRET。密钥只存在本地 .env，不上传服务器；CoinClaw 用户在 web UI 的 EnvSection 配置。

适用场景 适合需要加密货币行情、衍生品指标、市场资讯、空投与机构持仓等数据的查询场景，尤其适合在对话中快速获取跨交易所的实时市场信息。

限制与注意事项

  • 不编造数据：始终运行脚本获取真实数据；data 为空或 ok:false 时如实告知用户。
  • 加密数据只用该脚本，不使用 web_search / web_fetch / curl / 浏览器拼凑。
  • 参数命名：普通接口用 coin_key（AiCoin 币种 slug，小写，如 bitcoin、ethereum）；hyperliquid/* 接口用 coin（交易符号，如 BTC、HYPE）。
  • 详情接口的 id 需先从列表接口获取。
  • ok:false + HTTP 403 表示当前 key 无此接口权限，不要重试；先运行 key 命令核对 key_id 是否为专业版（key 应放在 ~/.coinos/.env）。200 + 空 data 表示此条件下无数据，不是出错。
  • 时间用 Unix 毫秒（start_time / end_time），分页用 limit / offset。
  • K 线取最新值只读 _timeseries.latest，并按 _timeseries.field 核对时间字段；时间距当前超过两个 K 线周期时只能标注“最新到某时”，不得称为“当前/实时”。不得用 head / tail / cut 截断 JSON 后猜数组顺序。
  • 只使用 scripts/aicoin.mjs；旧 market.mjs 等 v2 入口已停用。
  • 用用户的语言回复。
  • 不要把上游故障误判成 Key 失效：核心探测 401 才表示 Key 无效，403 是权限不覆盖，超时或 5xx 是接口/上游异常。
  • 故障接口不要连续重试；单次超时或 5xx 后立即降级并如实标注。
  • 指标先查覆盖：调 market/indicator-klines 前先调 market/indicator-pairs 确认覆盖；返回 200 空序列表示暂无覆盖，跳过该指标，不做本地计算，也不要重试。
  • 严格尊重 K 线周期：问“单日涨跌超过 8%”必须用 1d K 线；日线历史窗口不足时基于现有日线给出结论并明确样本范围。

跨 skill 参考：Hyperliquid 鲸鱼/聪明钱/链上大资金用 aicoin-hyperliquid；交易所下单/平仓/查余额用 aicoin-trading；Freqtrade 策略/回测/部署用 aicoin-freqtrade；链上 DEX swap/钱包/token 用 aicoin-onchain。