什么是 Coinank OpenAPI 技能？

Coinank OpenAPI 技能为 AI 智能体访问高保真加密货币市场数据提供了一个强大的接口。通过利用 Openclaw 技能，开发者可以直接将清算数据、多空比和资金费率等机构级见解集成到自动化工作流中。该技能针对性能进行了优化，采用按需加载策略，根据特定用户需求选择性解析 OpenAPI 定义。

该技能专为现代金融开发者打造，确保智能体拥有最新的市场背景。它弥合了原始金融 API 与 AI 驱动决策之间的差距，使其成为在 Openclaw 技能生态系统内构建交易助手或市场监控机器人的基石。

下载入口:https://github.com/openclaw/skills/tree/main/skills/annata/coinank-openapi

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Coinank OpenAPI 技能 应用场景

• 跟踪各交易所的实时加密货币清算和市场波动。
• 分析历史和当前资金费率，以识别市场情绪变化。
• 监控多空比变化以预测潜在价格走势。
• 使用实时数据点自动生成每日或每小时市场摘要报告。
• 为特定的市场深度或成交量里程碑构建自定义警报。

1. 身份验证：技能首先确认环境中 COINANK_API_KEY 的可用性。
2. 上下文发现：读取本地 README 并扫描引用目录以映射可用的 OpenAPI 端点。
3. 精准加载：根据用户请求，选择特定的 JSON 定义文件以最小化内存开销。
4. 动态模式解析：从 OpenAPI 规范中提取必要的路径、参数和请求体要求。
5. 自动化请求构建：技能生成指向 Coinank 基础 URL 的 curl 命令，并将 API 密钥注入标头。
6. 智能时间戳：如果未提供结束时间，它会自动计算并传递当前毫秒时间戳以确保数据准确性。
7. 执行与错误处理：执行请求，验证结果并返回给智能体，同时记录任何失败的详细日志。

Coinank OpenAPI 技能 配置指南

要在 Openclaw 技能设置中激活此功能，您必须配置 API 凭据。从 Coinank 主页获取 API 密钥并将其设置为环境变量：

export COINANK_API_KEY="your_secret_api_key"

确保该技能具有读取存储 OpenAPI JSON 规范的 references/ 文件夹的文件系统权限。

Coinank OpenAPI 技能 数据架构与分类体系

该技能通过结构化引用系统管理数据，以确保与各种 Openclaw 技能工作流的兼容性：

name: coinank-openapi
description: call coinank openapi to get data
metadata:
  {
    "openclaw":
      {
        "homepage": "https://coinank.com",
        "requires": { "env": ["COINANK_API_KEY"] },
        "primaryEnv": "COINANK_API_KEY",
      },
  }

权限声明

SECURITY MANIFEST:

- Allowed to read: {baseDir}/README.md, {baseDir}/references/*.json

- Allowed to make network requests to: https://open-api.coinank.com

工作流 (按需加载模式)

当用户提出请求时，请严格执行以下步骤：

1. 检查API密钥：首先检查环境变量 COINANK_API_KEY 是否存在。如果不存在，提示用户设置API密钥。
2. 阅读README：仔细阅读README.md
3. 目录索引：扫描 {baseDir}/references/ 目录下的所有文件名，确定哪些 OpenAPI 定义文件与用户需求相关。
4. 精准读取：仅读取选定的 .json 文件，分析其 paths、parameters 和 requestBody。其中paths内是一个对象,对象的key就是path
5. 构造请求：使用 curl 执行请求。
   • Base URL: 统一使用 https://open-api.coinank.com（或从 JSON 的 servers 字段提取）。
   • Auth: 从环境变量 COINANK_API_KEY 中获取 apikey 注入 Header。
   • 如果参数有endTime,尽量传入最新的毫秒级时间戳
   • OpenAPI文档内的时间戳都是示例.如果用户没有指定时间,请使用最新的时间和毫秒级时间戳

注意事项

• 禁止全量加载：除非用户请求涉及多个领域，否则禁止同时读取多个 JSON 文件。
• 参数校验：在发起请求前，必须根据 OpenAPI 定义验证必填参数是否齐全。
• 错误处理：当请求失败时，向用户显示友好的提示信息，并记录详细的错误日志。
• API密钥配置：用户需要自行设置环境变量 COINANK_API_KEY，例如：export COINANK_API_KEY="your_api_key"