coinank-openapi

# 权限声明 # 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"` ### endTime 必须是当前毫秒时间戳 ```bash # ✅ 正确 NOW=$(python3 -c "import time; print(int(time.time()*1000))") # ❌ 错误：macOS 不支持 %3N NOW=$(date +%s%3N) ``` ### 不要传多余参数 部分接口不接受 `endTime` 或 `size`（如清算热力图 `getLiqHeatMap`），多传会导致返回空数据。**严格按 OpenAPI 定义中列出的参数传参，不要自行添加。** ### 聚合接口 exchanges 参数 `getAggCvd`、`getAggBuySellCount`、`getAggBuySellValue`、`getAggBuySellVolume` 等接口的 `exchanges` 参数**必须传入**。传空字符串 `exchanges=` 表示聚合所有交易所。 ### interval 各接口不同 不同接口支持的 interval 值不同，以各 `.json` 文件中参数的 `description` 字段为准： | 接口类型 | interval 值 | |---------|---...