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"`

# CoinAnk OpenAPI Skill

> AI Agent 可读的 CoinAnk 开放接口调用技能。覆盖加密货币市场的 K 线、ETF、持仓、多空比、资金费率、爆仓、订单流等 18 大类、59 个接口，全部经过实测验证可用。

---

## 目录

- [快速开始](#快速开始)
- [认证与请求规范](#认证与请求规范)
- [⚠️ 关键注意事项](#️-关键注意事项)
- [接口总览](#接口总览)
- [接口详情](#接口详情)
  - [1. K线](#1-k线)
  - [2. ETF](#2-etf)
  - [3. HyperLiquid 鲸鱼](#3-hyperliquid-鲸鱼)
  - [4. 净多头和净空头](#4-净多头和净空头)
  - [5. 大额订单](#5-大额订单)
  - [6. 币种和交易对](#6-币种和交易对)
  - [7. 多空比](#7-多空比)
  - [8. 市价单统计指标](#8-市价单统计指标)
  - [9. 新闻快讯](#9-新闻快讯)
  - [10. 指标数据](#10-指标数据)
  - [11. 未平仓合约](#11-未平仓合约)
  - [12. 热门排行](#12-热门排行)
  - [13. 爆仓数据](#13-爆仓数据)
  - [14. 订单本](#14-订单本)
  - [15. 资金流](#15-资金流)
  - [16. 订单流](#16-订单流)
  - [17. 资金费率](#17-资金费率)
  - [18. RSI 选币器](#18-rsi-选币器)
- [枚举值速查](#枚举值速查)

---

## 快速开始

```bash
# 1. 设置 API Key（在 header 中传入）
APIKEY="your_api_key_here"

# 2. 生成当前毫秒级时间戳（macOS / Linux 通用）
NOW=$(python3 -c "import time; print(int(time.time()*1000))")

# 3. 示例：查询 BTC K线
curl -s -H "apikey: $APIKEY" \
  "https://open-api.coinank.com/api/kline/lists?symbol=BTCUSDT&exchange=Binance&endTime=$NOW&size=10&interval=1h&productType=SWAP"
```

---

## 认证与请求规范

| 项目 | 说明 |
|------|------|
| **Base URL** | `https://open-api.coinank.com` |
| **认证方式** | HTTP Header：`apikey: <your_api_key>` |
| **请求方法** | 全部为 `GET` |
| **响应格式** | `application/json` |
| **成功标志** | `{"success": true, "code": "1", "data": ...}` |

### 标准响应结构

```json
{
  "success": true,
  "code": "1",
  "data": [ ... ]
}
```

### 错误码说明

| code | 含义 |
|------|------|
| `1` | 成功 |
| `-3` | API Key 无效或认证失败 |
| `-7` | 超出允许访问的时间范围（endTime 参数错误） |
| `0` | 系统错误（参数缺失或服务端异常） |

---

## ⚠️ 关键注意事项

### 1. 时间戳必须是毫秒级且为当前...