技能使用指南

get-crypto-price（获取加密货币价格并计算ATH/ATL技能Skill）Skill 是什么？如何下载安装？

get-crypto-price 技能通过 CoinGecko、Binance、Coinbase 公共 API 获取加密货币当前价与 90 天历史行情，并直接计算 1 天、1 周、1 个月的 ATH 与 ATL。内含 curl 与 Node.js 示例、时间戳与分页注意事项及竞品对比，帮开发者快速搭建行情取数与极值计算流程，点击了解安装与使用方式。

获取加密货币价格并计算ATH/ATL技能Skillget-crypto-price
8 个章节 约 15 分钟阅读 AI 智能生成

获取加密货币价格并计算ATH/ATL技能Skill：用几家公共 API 快速算出任意币种的阶段高低点

  • 它是什么：一个专注于「取价 + 算窗口极值」的技能，串起 CoinGecko、Binance、Coinbase 三家公共 API，帮你拿到当前价与至少 90 天历史行情，并直接算出 1 天、1 周、1 个月的 ATH（最高价）与 ATL（最低价）。
  • 解决什么痛点：不用再在三个交易所文档之间来回翻，也不用纠结时间戳是毫秒还是秒、OHLC 该取 high 还是 close、1000 条限制怎么分页。
  • 怎么用：既可以粘贴 curl 命令自己跑，也可以直接对 AI 说一句「算一下比特币最近一周的最高最低价」，由技能代为组织请求与聚合逻辑。
  • 适合谁：加密行情研究者、量化脚本开发者、行情简报写作者、需要做接口联调的交易所对接工程师。
  • 一句话结论：它不是一个行情终端，而是一套「可复用、可验证、可写进代码」的取价与极值计算范式。

该技能叫什么？如何下载安装 AI 技能提升开发效率？

这个技能的中文名是获取加密货币价格并计算ATH/ATL技能Skill，英文名为 get-crypto-price，技能 ID 为 13119。

它要解决的核心问题是：加密货币价格数据分散在不同交易所与聚合平台手里，各自的接口风格、字段命名、时间戳单位、分页规则都不一样。想算一个「最近 7 天最高价」这样看似简单的指标，实际上要做四件事——选数据源、处理时间戳、过滤窗口、取极值。这个技能把这四步固化成了一套可复用的流程，并给出了 CoinGecko、Binance、Coinbase 三个数据源的现成调用方式。

关于安装：技能详情中没有提供具体的安装命令、下载地址或安装包信息，因此这里只描述通用思路，具体入口与命令请以官方说明为准。

  1. 确认安装前提：你需要一个支持技能（Skill）机制的 AI 客户端或开发环境，并具备基本的命令行或浏览器环境，用于直接访问公共 API。
  2. 导入技能：在技能市场、技能库或本地技能目录中，按技能 ID 13119 或英文名 get-crypto-price 检索并添加该技能，具体操作路径以官方说明为准。
  3. 验证是否生效：安装后向 AI 提出一个可证伪的问题，例如「用 CoinGecko 的公开接口，告诉我比特币当前的美元价格，并说明你实际请求的 URL」。如果回复中出现了符合规范的请求路径与字段说明，说明技能已被正确加载；若只是泛泛而谈而没有具体接口信息，则可能未生效，需要重新检查技能是否启用。
  4. 做一次端到端小验证：让它拉取 90 天历史并输出 1 天窗口的 ATH/ATL。能稳定返回数值与时间口径说明，即视为可用。

这种「一键接入 + 公共 API + 可验证输出」的方式，本质上是把散落在各处的接口知识沉淀为一个技能，开发者不必每次从零查文档，效率提升体现在重复劳动被消除。

该技能的主要功能和特点

  • 多源取价：同时覆盖 CoinGecko（聚合平台，适合简单历史区间）、Binance（交易所级 K 线与实时报价）、Coinbase（现货价格与蜡烛图），可根据精度与稳定性择优使用。
  • 90 天历史覆盖：明确指出要获取至少 3 个月的过去价格行为，用 days=90 参数或 K 线分页的方式把时间跨度补满。
  • 窗口极值计算：内置 1 天、1 周、1 个月三种常见时间窗口的 ATH/ATL 计算逻辑，直接输出数值结果。
  • OHLC 与采样点双模式：如果数据源是蜡烛图，用 high 作为 ATH 候选、low 作为 ATL 候选；如果只有采样价格，则用采样值的最大值与最小值。
  • 跨语言可落地：给出的 Node.js 示例可直接复制进脚本，curl 示例可直接在终端验证，不依赖特定框架。
  • 工程细节提醒：明确提示时间戳单位统一（毫秒或秒）、符号规范（Binance 用 BTCUSDT，CoinGecko 用 bitcoin）、尊重速率限制并缓存响应。
  • 可扩展的报告输出：详情中提到可以配合 generate-report 技能，把取价结果生成为 Markdown 或 PDF 格式的格式化报告，并附上源 URL。

与「打开网页手动查价」相比，它强在可编程、可复现、可批量化；与「自己从零写脚本」相比，它强在已经把接口坑位标注清楚。

如何使用该技能？

以下步骤按照技能详情中的实际数据结构组织，示例可直接参考。

第一步：明确标的与计价货币 先用规范符号确定目标。聚合平台用币种 ID（如 bitcoin、ethereum），交易所用交易对（如 BTCUSDT、BTC-USD）。符号写错是最常见的失败原因。

第二步：获取当前价格 CoinGecko 方式：

curl "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd"

Binance 方式：

curl "https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT"

Coinbase 现货方式：

curl "https://api.coinbase.com/v2/prices/BTC-USD/spot"

第三步：拉取历史数据 CoinGecko 的 market_chart 接口一次可取 90 天，返回 prices 数组，格式为 [timestamp_ms, price]：

curl "https://api.coingecko.com/api/v3/coins/bitcoin/market_chart?vs_currency=usd&days=90"

如果需要更细粒度或交易所原始数据，用 Binance 的 klines：

curl "https://api.binance.com/api/v3/klines?symbol=BTCUSDT&interval=1d&limit=1000"

每行结构为 [openTime, open, high, low, close, ...]，openTime 为毫秒。注意单次 limit 最多 1000 条，覆盖 90 天小时级数据需要约 2160 行，必须按 startTime 分页取两次，或改用 4 小时间隔。

第四步：计算窗口极值 以 CoinGecko 采样点为例，核心逻辑是三步：确定窗口起点（当前时间减去窗口秒数）、过滤时间戳大于等于起点的点、取最大值与最小值：

const sinceMs = Date.now() - 24 * 3600 * 1000; // 1 天窗口
const windowPrices = points.filter(([ts]) => ts >= sinceMs).map(([, p]) => p);
const ath = windowPrices.length ? Math.max(...windowPrices) : null;
const atl = windowPrices.length ? Math.min(...windowPrices) : null;

若数据源是 OHLC 蜡烛图，则改为对 high 取最大值、对 low 取最小值。把 24 * 3600 * 1000 换成 7 天或 30 天对应的毫秒数，即可批量得到三组结果。

第五步：组织输出 轻量场景直接在对话中输出「币种 + 窗口 + ATH + ATL + 数据源 URL」；正式场景调用 generate-report 技能，生成 Markdown 或 PDF 报告，并保留源链接以便复核。

第六步：注意事项 时间统一用 UTC 与毫秒；对重复查询做缓存；控制请求频率以尊重交易所速率限制。

同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
get-crypto-price（本技能） 取价 + 窗口极值计算的技能化方案 三源取价、90 天历史、1d/1w/1m ATH/ATL 计算、规范化提示 需支持技能机制的 AI 环境，会基础命令行即可 快速分析、脚本原型、行情简报、接口联调参考 优势：开箱即得方法论与示例代码，坑位已标注；不足：不托管数据、不做持久化存储，重度依赖公共 API 可用性
直接调用 CoinGecko 官网/接口 单一数据源自助查询 当前价、历史曲线、市值等 零安装，浏览器或 curl 即可 偶发性的单币种查价 优势：无需任何环境；不足：无极值计算能力，原子指标要自己算，符号体系与交易所不通用
行情终端类产品（如 TradingView 一类图表工具） 可视化行情分析平台 图表、技术指标、画线、告警 需注册账号，学习成本中等 主观技术分析、盯盘 优势：可视化直观、指标丰富；不足：批量取数与程序化聚合不便，难以嵌入自动化流程，历史数据导出受限
自建脚本 + 交易所 K 线接口 完全自主的工程方案 任意币种、任意窗口、可落库 需具备编程与运维能力，处理分页与限流 生产级数据管道、量化回测 优势：可控性最高、可定制；不足：开发与维护成本高，时间戳与分页等细节容易出错
商业行情聚合 API 付费级数据服务 高覆盖币种、稳定 SLA、统一字段 需申请密钥，可能有费用，以官方说明为准 商业产品内嵌行情 优势：稳定、字段统一；不足：存在成本与配额约束，小规模需求性价比不高

结论：本技能的定位介于「手动查价」与「自建管道」之间，用最低成本把方法论一次性讲清楚，适合做快速验证与原型；当需求上升到生产级稳定性时，再向自建或商业 API 迁移。

该技能的典型应用场景与实际体验情况

场景一：量化研究者的快速验证 角色是策略研究员，痛点是「想验证一个假设，却要花半天搭数据管道」。使用方式是让技能拉取 90 天数据并输出 1d/1w/1m 三组极值，先确认「近一个月最大回撤区间」这类特征的量级是否值得深入。实际体验：上手几乎没有门槛，CoinGecko 一条 curl 就能看到数据形态；需要注意的是 CoinGecko 返回的是采样点（通常每小时），对分钟级策略不够细，此时应切到 Binance 或 Coinbase 的 K 线接口。

场景二：行情简报与内容生产 角色是加密内容创作者或投研运营，痛点是每周简报都要手动翻网页抄数字，容易出错。使用方式是先让技能输出当前价、24 小时与 7 天变化、以及对应窗口的 ATH/ATL，再调用 generate-report 技能生成 Markdown 或 PDF，并附上源 URL。实际体验：流程顺畅，报告可复核性是最大亮点——每个数字都能追到具体接口。注意事项是简报必须标注数据截取时间，因为行情实时变动。

场景三：交易所对接与接口联调 角色是后端或数据工程师，痛点是各家接口的返回结构差异大——Binance 的 K 线是数组的数组，Coinbase 的蜡烛图是 [time, low, high, open, close, volume]，字段顺序完全不同。使用方式是把技能给出的示例当成对照表，逐一验证自己的解析逻辑。实际体验：字段顺序这类细节极容易写错，技能里明确列出 Coinbase 是 low 在前、high 在后，能省掉大量 debug 时间。注意事项是必须遵守速率限制，生产环境要加缓存。

场景四：持仓监控与风险提示 角色是个人投资者或小型基金运营，痛点是「想快速知道自己关注的币种是否处于阶段高位或低位」。使用方式是用固定的提示词模板批量询问若干个币种的一周 ATH/ATL，与当前价对比判断位置。实际体验：响应直观，能秒级给出结论；但要注意这是一种统计位置判断，不等于投资建议，且极值对数据源和粒度敏感，不同粒度可能得到略有差异的结果。

该技能能为用户带来的价值

第一，砍掉重复的技术调研成本。 原本需要分别阅读 CoinGecko、Binance、Coinbase 三家的接口文档，理解 market_chart 与 klines 的返回结构差异，再处理时间戳单位与分页限制，这是一段以小时计的工作。技能把这些知识压缩成一份最小指南，把「查文档」变成「读一遍就能动手」。

第二，降低从想法到结果的链路长度。 计算 ATH/ATL 的逻辑本身不复杂，但重复实现率极高。技能给出了过滤 + 取极值的三行核心代码，以及 OHLC 与采样点两种数据形态下的正确取舍方式，让开发者不必在「该用 high 还是 close」这种细节上反复试错。

第三，提升结果可信度。 每个数字都能追溯到具体接口与请求参数。详情中特别强调报告中包含源 URL，这在投研与合规场景中是刚性要求——可复核的数字才是有价值的数字。

第四，可复用带来的长期价值。 无论是个人脚本、周报模板还是团队内部的行情组件，这套「取数—过滤—聚合—出报告」的范式可以一直沿用。随着需求升级，只需替换数据源或增加窗口粒度，而不用推翻重来。

常见问题 FAQ

Q1：这个技能怎么安装？需要付费吗？ 技能详情中未提供具体安装命令与定价信息。通用做法是在支持技能机制的 AI 环境中按技能 ID 13119 或英文名 get-crypto-price 检索并添加，具体入口与是否收费请以官方说明为准。技能本身调用的是 CoinGecko、Binance、Coinbase 的公共接口，这些接口的免费额度与限流规则同样以其官方文档为准。

Q2：为什么我算出来的最高价和别人不一样？ 通常有三个原因。一是数据源不同：CoinGecko 是采样点（一般每小时），Binance 是交易所 K 线，Coinbase 又是另一套成交数据，粒度与撮合范围都不一样。二是粒度不同：算 1 天窗口时，小时级甚至分钟级数据会比日线更精确，日线的 high 只是当日极值。三是符号或计价货币不同，BTCUSDT 和 BTC-USD 是两个市场。建议固定数据源与粒度后再做横向比较。

Q3：90 天小时级数据取不全怎么办？ Binance 的 klines 接口单次 limit 上限是 1000 条，90 天小时级约需 2160 条。解决办法有两个：按毫秒时间戳用 startTime 循环分页请求两次以上，或者直接把间隔放宽到 4 小时，用较少数据覆盖同样时长。技能详情中明确提示了这一点。

Q4：这个技能适合谁用？不适合谁？ 适合加密行情研究者、需要快速验证数据的开发者、写行情简报的运营，以及做接口联调的工程师。不太适合需要毫秒级撮合数据的高频策略，也不适合需要持久化存储与稳定 SLA 的商业级产品——这两类需求应当转向自建数据管道或商业行情 API。

Q5：它和图表工具、商业行情 API 该怎么选？ 看三点。如果只是偶尔看一眼价格，图表工具更直观；如果要做程序化批量计算且预算有限，本技能的性价比最高；如果产品对稳定性、币种覆盖和字段统一有硬性要求，再考虑商业 API。实践中常见路径是先用本技能做原型验证，确认需求成立后再迁移到更重的方案。