CoinAnk OpenAPI Skill
> AI Agent 的加密衍生品数据引擎_
Endpoints OKX Plugin Store REST License
OKX Plugin package files: skills/coinank-openapi · Cursor / Grok Bot Agent Plugin: root plugin.json
什么是 CoinAnk OpenAPI Skill?
一句话查数据。18 大类衍生品指标,尽在掌握。
CoinAnk OpenAPI Skill 是一个开放的 AI Agent 数据技能,任何 Agent、大语言模型或应用均可直接调用(同时已上架 OKX Plugin Store),为其提供完整的加密货币衍生品市场数据能力。覆盖 K 线、ETF、持仓、多空比、资金费率、爆仓、订单流、鲸鱼动向等 18 大类、80 个实时数据接口,全部经过实测验证可用,并支持 CoinAnk API Key 直连 与 Agent Payments Protocol 或 x402 按次支付 两种访问模式。
- 全部 80 个接口经过实测验证
- 所有请求均为 GET,简洁高效
- 支持 API Key 直连 与 Agent Payments Protocol 或 x402 按次付费
数据覆盖
行情与价格
| 分类 | 接口数 | API等级 |
|---|---|---|
| K 线 | 1 | API1 |
| ETF | 5 | API1 |
| 币种和交易对 | 5 | API1 |
| 指标数据 | 11 | API1 |
| 新闻快讯 | 2 | API2 |
衍生品深度
| 分类 | 接口数 | API等级 |
|---|---|---|
| 未平仓合约 | 7 | API1 |
| 资金费率 | 7 | API1 |
| 多空比 | 6 | API1 |
| 爆仓数据 | 8 | API1 |
| RSI 选币器 | 1 | API2 |
机构级数据
| 分类 | 接口数 | API等级 |
|---|---|---|
| 大额订单 | 2 | API3 |
| 市价单统计 | 8 | API3 |
| 订单本 | 3 | API3 |
| 资金流 | 2 | API3 |
| 订单流 | 1 | API3 |
| 净多头/净空头 | 1 | API3 |
链上与鲸鱼
| 分类 | 接口数 | API等级 |
|---|---|---|
| HyperLiquid 鲸鱼 | 2 | API2 |
| 热门排行 | 8 | API2 |
合计:18 大类 · 80 个接口
快速开始
首次使用时,请直接按下面两种方式选择:
- 如果你有 CoinAnk API 会员,请提供
COINANK_API_KEY - 如果你没有 CoinAnk API 会员,也可以直接使用 Agent Payments Protocol 或 x402 进行单次调用与支付
# 1. 安装或更新 OKX Plugin Store package
git clone https://github.com/coinank/coinank-openapi-skill.git
Cursor / Grok Bot Marketplace(本地测试)
本仓库根目录 plugin.json 符合 Agent Plugins 规范,可直接作为 Cursor / Grok Bot Marketplace 的 Agent Plugin 提交。现有 skills/coinank-openapi/(含 .claude-plugin/)保持不变,继续兼容 OKX Plugin Store。
本地加载路径:
# 将本仓库(或 symlink)放到 Cursor 本地插件目录后 Reload Window
mkdir -p ~/.cursor/plugins/local
cp -R /path/to/coinank-openapi-skill ~/.cursor/plugins/local/coinank-openapi
# 或: ln -s /path/to/coinank-openapi-skill ~/.cursor/plugins/local/coinank-openapi
然后在 Cursor 中执行 Developer: Reload Window,打开 Customize 确认已加载 skill coinank-openapi。
鉴权:
export COINANK_API_KEY="your_api_key_here"
请求时把 key 放在 HTTP header apikey(不是 Authorization):
curl -H "apikey: $COINANK_API_KEY" \
"https://open-api.coinank.com/api/fundingRate/current?type=current"
无 API Key 时也可走 Agent Payments Protocol / x402 按次支付(见下方模式二)。
推荐测试任务(test task):
查 BTC 当前资金费率
Agent 应读取 skills/coinank-openapi/references/funding-rate.openapi.json,调用 GET /api/fundingRate/current,并用自然语言汇报 BTC 相关费率。
提交 Marketplace:将公开 Git 仓提交到 https://cursor.com/marketplace/publish
模式一:CoinAnk API Key 直连
export COINANK_API_KEY="your_api_key_here"
模式二:Agent Payments Protocol 或 x402 按次支付
如果你没有 CoinAnk API 会员,也可以通过 OKX Onchain OS 使用 Agent Payments Protocol 或 x402 完成单次调用支付:
请使用最新版 okx-agent-payments-protocol。新版 OKX 支付 skill 支持 Agent Payments Protocol / x402 proof 方式,也支持新的 charge 支付方式;实际支付方式以 OKX skill 返回或要求的流程为准。
# 安装 OKX Onchain OS skills
npx skills add okx/onchainos-skills
# 登录钱包(用于后续 Agent Payments Protocol / x402 支付签名)
onchainos wallet login
OKX Buyer 侧接入参考:
https://web3.okx.com/zh-hans/onchainos/dev-docs/payments/payment-use-buyer-ai
然后在支持 OKX Plugin Store 的 Agent 中直接用自然语言查询:
> "查一下 BTC 当前的资金费率"
> "看看过去 24 小时的爆仓数据"
> "获取以太坊的多空比"
认证与请求规范
| 项目 | 说明 |
|---|---|
| Base URL | https://open-api.coinank.com |
| 认证方式 | API Key 直连:apikey: <your_api_key>;Agent Payments Protocol / x402:由支付流生成对应支付 Header |
| 请求方法 | 全部为 GET |
| 响应格式 | application/json |
| 成功标志 | {"success": true, "code": "1", "data": ...} |
访问模式
| 模式 | 适用场景 | 要求 |
|---|---|---|
| API Key 直连 | 你已有 CoinAnk API 会员 | 设置 COINANK_API_KEY |
| Agent Payments Protocol 或 x402 按次支付 | 你没有 CoinAnk API 会员,但希望为单次请求付费 | 安装 okx/onchainos-skills |
标准响应结构
{
"success": true,
"code": "1",
"data": [ ... ]
}
错误码说明
| code | 含义 |
|---|---|
1 | 成功 |
-3 | API Key 无效或认证失败 |
-7 | 超出允许访问的时间范围(endTime 参数错误) |
0 | 系统错误(参数缺失或服务端异常) |
Agent Payments Protocol / x402 响应说明
当 CoinAnk 对某个请求返回 HTTP 402 Payment Required 时,Agent 应先完成支付,再重放同一个请求,而不是把 402 当成最终业务结果。
示例请求说明
下文接口示例默认展示 API Key 直连模式。如果使用 Agent Payments Protocol / x402,实际请求参数和 URL 不变,只是在支付成功后由 Agent 为原请求补充支付 Header 再重放。
关键注意事项
1. 时间戳必须是毫秒级且为当前时间
所有 endTime 参数均为毫秒级时间戳,且必须接近当前时间。传入过期或格式错误的时间戳会返回 code: -7。
# 正确:使用 python3 生成(跨平台兼容)
NOW=$(python3 -c "import time; print(int(time.time()*1000))")
# 错误:macOS 的 date 命令不支持 %3N,会生成如 "17228693N" 的无效值
NOW=$(date +%s%3N) # 不要用这个!
2. API 权限等级
接口分为 API1~API4 四个级别,级别越高可访问的接口越多。每个接口标注了所需最低 API 等级。
3. exchanges 参数传空字符串
getAggCvd、getAggBuySellCount 等聚合市价单接口中,exchanges 参数必须传入(传空字符串 exchanges= 表示聚合所有交易所)。
4. OpenAPI 文件中的时间戳仅为示例
references/ 目录下 JSON 文件中的 example 时间戳均为历史示例,调用时应使用实时生成的时间戳。
5. Agent Payments Protocol / x402 只在卖家返回 HTTP 402 时生效
这个 skill 不会“假设”某个接口支持 Agent Payments Protocol 或 x402。只有当 CoinAnk 服务端对该请求真实返回 HTTP 402 Payment Required 挑战时,Agent 才会进入按次支付流程。
如果你没有 COINANK_API_KEY,而接口返回的是业务错误(例如 code: "-3")但没有 HTTP 402,说明该路由当前仍然只支持会员访问,尚未开启 Agent Payments Protocol 或 x402。
6. Agent Payments Protocol / x402 单次调用流程
当某个请求命中 Agent Payments Protocol / x402 时,推荐流程是:
- 先按原请求发送一次,不预先登录、不预先扣费。
- 如果服务端返回
HTTP 402 Payment Required,解析支付挑战。 - 向用户展示本次支付的网络、币种、金额、收款地址;如果金额大于 0,则等待用户确认。
- 使用最新版
okx-agent-payments-protocol处理支付;它同时支持 Agent Payments Protocol / x402 支付证明和新的charge支付方式。 - 如果 OKX 支付 skill 返回或要求
charge方式,则走charge流程,不要强制套用旧的 x402-only proof 流程。 - 仅在原请求基础上追加支付 Header 或所选支付方式要求的授权数据,重放同一个请求。
如果支付挑战中的金额为 0,它仍然是有效的 Agent Payments Protocol / x402 挑战。Agent 不应将 0 金额视为错误或不支持,也不能把 0 兜底、抬高或转换成 0.000001 USDC/USDT 等最小非零金额;应提示用户本次请求需要支付证明或授权但不会扣费,然后使用原始 0 金额继续通过 OKX 支付 skill 生成证明、授权或 charge 请求并重放请求。
这意味着 Agent Payments Protocol / x402 是按请求计费,更适合单次查询、临时取数和低频调用,不适合在没有 API Key 的情况下直接做大规模多接口扇出分析。
7. Agent Payments Protocol / x402 签名 scheme 约束
接入 Agent Payments Protocol / x402 时,签名 scheme 必须和签名主体保持一致:
- 如果使用 EOA 钱包私钥 签名,必须使用
exactscheme - 如果使用 OKX 合约钱包 / OKX 钱包会话签名,必须使用
aggr_deferredscheme
不要混用这两条路径,否则会导致支付流程和签名语义不匹配。
接口详情
1. K 线 — 1 个接口 · API1
GET /api/kline/lists — K线行情数据
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
symbol | Yes | string | 交易对 | BTCUSDT |
exchange | Yes | string | 交易所 | Binance |
endTime | Yes | number | 毫秒时间戳,返回此时间之前的数据 | 当前时间戳 |
size | Yes | integer | 数量,最大 500 | 10 |
interval | Yes | string | 周期,见枚举值 | 1h |
productType | Yes | string | SWAP 合约 / SPOT 现货 | SWAP |
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/kline/lists?symbol=BTCUSDT&exchange=Binance&endTime=$NOW&size=10&interval=1h&productType=SWAP"
2. ETF — 5 个接口 · API1
GET /api/etf/getUsBtcEtf — 美国 BTC ETF 列表
无需参数
GET /api/etf/getUsEthEtf — 美国 ETH ETF 列表
无需参数
GET /api/etf/usBtcInflow — 美国 BTC ETF 历史净流入
无需参数
GET /api/etf/usEthInflow — 美国 ETH ETF 历史净流入
无需参数
GET /api/etf/hkEtfInflow — 港股 ETF 历史净流入
无需参数
curl -H "apikey: $APIKEY" "https://open-api.coinank.com/api/etf/getUsBtcEtf"
curl -H "apikey: $APIKEY" "https://open-api.coinank.com/api/etf/getUsEthEtf"
curl -H "apikey: $APIKEY" "https://open-api.coinank.com/api/etf/usBtcInflow"
curl -H "apikey: $APIKEY" "https://open-api.coinank.com/api/etf/usEthInflow"
curl -H "apikey: $APIKEY" "https://open-api.coinank.com/api/etf/hkEtfInflow"
3. HyperLiquid 鲸鱼 — 2 个接口 · API2
GET /api/hyper/topPosition — 鲸鱼持仓排行
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
sortBy | Yes | string | 排序字段 | positionValue |
sortType | Yes | string | desc 降序 / asc 升序 | desc |
page | Yes | integer | 页码 | 1 |
size | Yes | integer | 每页数量 | 10 |
GET /api/hyper/topAction — 鲸鱼最新动态
无需参数
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/hyper/topPosition?sortBy=positionValue&sortType=desc&page=1&size=10"
curl -H "apikey: $APIKEY" "https://open-api.coinank.com/api/hyper/topAction"
4. 净多头和净空头 — 1 个接口 · API3
GET /api/netPositions/getNetPositions — 净多头/净空头历史
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
exchange | Yes | string | 交易所 | Binance |
symbol | Yes | string | 交易对 | BTCUSDT |
interval | Yes | string | 周期 | 1h |
endTime | Yes | number | 毫秒时间戳 | 当前时间戳 |
size | Yes | integer | 数量,最大 500 | 10 |
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/netPositions/getNetPositions?exchange=Binance&symbol=BTCUSDT&interval=1h&endTime=$NOW&size=10"
5. 大额订单 — 2 个接口 · API3
GET /api/trades/largeTrades — 大额市价订单
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
symbol | Yes | string | 交易对 | BTCUSDT |
productType | Yes | string | SWAP 合约 / SPOT 现货 | SWAP |
amount | Yes | string | 最小金额(USD) | 10000000 |
endTime | Yes | string | 毫秒时间戳 | 当前时间戳 |
size | Yes | string | 数量,最大 500 | 10 |
GET /api/bigOrder/queryOrderList — 大额限价订单
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
symbol | Yes | string | 交易对 | BTCUSDT |
exchangeType | Yes | string | SWAP 永续 / SPOT 现货 / FUTURES 交割 | SWAP |
size | Yes | integer | 数量,最大 500 | 10 |
amount | Yes | number | 最低金额(USD) | 1000000 |
side | Yes | string | ask 卖 / bid 买 | ask |
exchange | Yes | string | 交易所(Binance / OKX / Coinbase) | Binance |
isHistory | Yes | string | true 历史 / false 实时 | true |
startTime | No | number | 截止时间戳(isHistory=true 时建议传当前时间戳) | 当前时间戳 |
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/trades/largeTrades?symbol=BTCUSDT&productType=SWAP&amount=10000000&endTime=$NOW&size=10"
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/bigOrder/queryOrderList?symbol=BTCUSDT&exchangeType=SWAP&size=10&amount=1000000&side=ask&exchange=Binance&isHistory=true&startTime=$NOW"
6. 币种和交易对 — 5 个接口 · API1
GET /api/instruments/getLastPrice — 实时价格
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
symbol | Yes | string | 交易对 | BTCUSDT |
exchange | Yes | string | 交易所 | Binance |
productType | Yes | string | SWAP / SPOT | SWAP |
GET /api/instruments/getCoinMarketCap — 币种市值信息
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
baseCoin | Yes | string | 币种 | BTC |
GET /api/baseCoin/list — 支持的币种列表
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
productType | Yes | string | SWAP / SPOT | SWAP |
GET /api/baseCoin/symbols — 支持的交易对列表
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
exchange | Yes | string | 交易所 | Binance |
productType | Yes | string | SWAP / SPOT | SWAP |
GET /api/instruments/agg — 合约聚合行情
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
page | No | integer | 页码,默认 1 | 1 |
size | No | integer | 每页条数,默认 50 | 50 |
返回全币种聚合行情:价格、聚合未平仓合约及 5m~7D 多周期持仓变化率、流通量,支持分页。
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/instruments/getLastPrice?symbol=BTCUSDT&exchange=Binance&productType=SWAP"
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/instruments/getCoinMarketCap?baseCoin=BTC"
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/baseCoin/list?productType=SWAP"
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/baseCoin/symbols?exchange=Binance&productType=SWAP"
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/instruments/agg?page=1&size=50"
7. 多空比 — 6 个接口 · API1
GET /api/longshort/buySell — 全市场多空买卖比
API等级:API3
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
baseCoin | Yes | string | 币种 | BTC |
interval | Yes | string | 周期 | 1h |
endTime | Yes | string | 毫秒时间戳 | 当前时间戳 |
size | Yes | string | 数量 | 10 |
GET /api/longshort/realtimeAll — 交易所实时多空比
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
baseCoin | Yes | string | 币种 | BTC |
interval | Yes | string | 周期,可选 5m/15m/30m/1h/2h/4h/6h/8h/12h/1d | 1h |
GET /api/longshort/person — 多空持仓人数比
支持交易所:Binance / OKX / Bybit
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
exchange | Yes | string | 交易所 | Binance |
symbol | Yes | string | 交易对 | BTCUSDT |
interval | Yes | string | 周期 | 1h |
endTime | Yes | string | 毫秒时间戳 | 当前时间戳 |
size | Yes | string | 数量,最大 500 | 10 |
GET /api/longshort/position — 大户多空比(持仓量)
支持交易所:Binance / OKX / Huobi — 参数与 person 相同。
GET /api/longshort/account — 大户多空比(账户数)
支持交易所:Binance / OKX / Huobi — 参数与 person 相同。
GET /api/longshort/kline — 多空比 K 线
支持交易所:Binance / OKX / Huobi
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
exchange | Yes | string | 交易所 | Binance |
symbol | Yes | string | 交易对 | BTCUSDT |
interval | Yes | string | 周期 | 1h |
endTime | Yes | string | 毫秒时间戳 | 当前时间戳 |
size | Yes | string | 数量,最大 500 | 10 |
type | Yes | string | longShortPerson 人数比 / longShortPosition 持仓比 / longShortAccount 账户比 | longShortPerson |
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/longshort/realtimeAll?baseCoin=BTC&interval=1h"
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/longshort/person?exchange=Binance&symbol=BTCUSDT&interval=1h&endTime=$NOW&size=10"
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/longshort/kline?exchange=Binance&symbol=BTCUSDT&interval=1h&endTime=$NOW&size=10&type=longShortPerson"
8. 市价单统计指标 — 8 个接口 · API3
分为单交易对和**聚合(跨交易所)**两组。
单交易对系列(需指定 exchange + symbol)
| 接口 | 说明 |
|---|---|
GET /api/marketOrder/getCvd | CVD(主动买卖量差) |
GET /api/marketOrder/getBuySellCount | 主动买卖笔数 |
GET /api/marketOrder/getBuySellValue | 主动买卖额(USD) |
GET /api/marketOrder/getBuySellVolume | 主动买卖量(币本位) |
公共参数:
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
exchange | Yes | string | 交易所(Binance / OKX / Bybit / Bitget) | Binance |
symbol | Yes | string | 交易对 | BTCUSDT |
interval | Yes | string | 周期 | 1h |
endTime | Yes | string | 毫秒时间戳 | 当前时间戳 |
size | Yes | integer | 数量,最大 500 | 10 |
productType | Yes | string | SWAP / SPOT | SWAP |
聚合系列(按 baseCoin 跨交易所聚合)
| 接口 | 说明 |
|---|---|
GET /api/marketOrder/getAggCvd | 聚合 CVD |
GET /api/marketOrder/getAggBuySellCount | 聚合买卖笔数 |
GET /api/marketOrder/getAggBuySellValue | 聚合买卖额 |
GET /api/marketOrder/getAggBuySellVolume | 聚合买卖量 |
公共参数:
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
baseCoin | Yes | string | 币种 | BTC |
interval | Yes | string | 周期 | 1h |
endTime | Yes | string | 毫秒时间戳 | 当前时间戳 |
size | Yes | integer | 数量,最大 500 | 10 |
productType | Yes | string | SWAP / SPOT | SWAP |
exchanges | Yes | string | 传空字符串表示聚合所有交易所 | (空) |
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/marketOrder/getCvd?exchange=Binance&symbol=BTCUSDT&interval=1h&endTime=$NOW&size=10&productType=SWAP"
# 注意:exchanges 参数必须传入,传空字符串表示聚合全部
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/marketOrder/getAggCvd?baseCoin=BTC&interval=1h&endTime=$NOW&size=10&productType=SWAP&exchanges="
9. 新闻快讯 — 2 个接口 · API2
GET /api/news/getNewsList — 新闻/快讯列表
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
type | Yes | string | 1 快讯 / 2 新闻 | 1 |
lang | Yes | string | 语言:zh 中文 / en 英文 | zh |
page | Yes | string | 页码 | 1 |
pageSize | Yes | string | 每页数量 | 10 |
isPopular | Yes | string | 是否推荐:true / false | false |
search | Yes | string | 搜索关键词,无则传空字符串 | (空) |
GET /api/news/getNewsDetail — 新闻详情
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
id | Yes | string | 新闻 ID(从列表接口获取) | 69a2f40912d08f6a781aedd0 |
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/news/getNewsList?type=1&lang=zh&page=1&pageSize=10&isPopular=false&search="
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/news/getNewsDetail?id=69a2f40912d08f6a781aedd0"
10. 指标数据 — 11 个接口 · API1
以下指标无需参数,直接请求即可。
| 接口 | 说明 |
|---|---|
GET /api/indicator/getBtcMultiplier | 两年 MA 乘数 |
GET /api/indicator/getCnnEntity | 贪婪恐惧指数 |
GET /api/indicator/getAhr999 | ahr999 囤币指标 |
GET /api/indicator/getPuellMultiple | 普尔系数(Puell Multiple) |
GET /api/indicator/getBtcPi | Pi 循环顶部指标 |
GET /api/indicator/getMovingAvgHeatmap | 200 周均线热力图 |
GET /api/indicator/getAltcoinSeason | 山寨季指数 |
GET /api/indicator/getMarketCapRank — 市值占比排名
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
symbol | Yes | string | 币种 | BTC |
GET /api/indicator/getGrayscaleOpenInterest — 灰度持仓数据
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
symbol | Yes | string | 币种 | BTC |
GET /api/indicator/smc — SMC 聪明钱指标
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
symbol | Yes | string | 交易对 | BTCUSDT |
interval | Yes | string | 周期 | 1d |
exchange | No | string | 交易所,默认 Binance | Binance |
返回 SMC(Smart Money Concepts)结构数据:摆动高低点、BOS/CHoCH、FVG 公允价值缺口、看涨/看跌订单块、Breaker Block。
GET /api/indicator/index/charts — 彩虹图等综合指标
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
type | Yes | string | 图表类型 | bitcoin-rainbow-v2 |
curl -H "apikey: $APIKEY" "https://open-api.coinank.com/api/indicator/getCnnEntity"
curl -H "apikey: $APIKEY" "https://open-api.coinank.com/api/indicator/getMarketCapRank?symbol=BTC"
curl -H "apikey: $APIKEY" "https://open-api.coinank.com/api/indicator/smc?symbol=BTCUSDT&interval=1d"
curl -H "apikey: $APIKEY" "https://open-api.coinank.com/api/indicator/index/charts?type=bitcoin-rainbow-v2"
11. 未平仓合约 — 7 个接口 · API1
GET /api/openInterest/all — 实时持仓列表(全交易所)
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
baseCoin | Yes | string | 币种 | BTC |
GET /api/openInterest/v2/chart — 币种聚合持仓历史
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
baseCoin | Yes | string | 币种 | BTC |
exchange | Yes | string | 交易所,传空字符串查全部 | (空) |
interval | Yes | string | 周期 | 1h |
size | Yes | string | 数量,最大 500 | 10 |
type | Yes | string | USD 美元计价 / 币种名(如 BTC)币本位 | USD |
endTime | Yes | number | 毫秒时间戳 | 当前时间戳 |
GET /api/openInterest/symbol/Chart — 交易对持仓历史
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
exchange | Yes | string | 交易所 | Binance |
symbol | Yes | string | 交易对 | BTCUSDT |
interval | Yes | string | 周期 | 1h |
endTime | Yes | number | 毫秒时间戳 | 当前时间戳 |
size | Yes | string | 数量,最大 500 | 10 |
type | Yes | string | USD / 币种名 | USD |
GET /api/openInterest/kline — 交易对持仓 K 线
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
exchange | Yes | string | 交易所 | Binance |
symbol | Yes | string | 交易对 | BTCUSDT |
interval | Yes | string | 周期 | 1h |
endTime | Yes | number | 毫秒时间戳 | 当前时间戳 |
size | Yes | integer | 数量 | 10 |
GET /api/openInterest/aggKline — 聚合持仓 K 线
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
baseCoin | Yes | string | 币种 | BTC |
interval | Yes | string | 周期 | 1h |
endTime | Yes | number | 毫秒时间戳 | 当前时间戳 |
size | Yes | integer | 数量 | 10 |
GET /api/tickers/topOIByEx — 实时持仓(按交易所统计)
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
baseCoin | Yes | string | 币种 | BTC |
GET /api/instruments/oiVsMc — 历史持仓市值比
API等级:API2
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
baseCoin | Yes | string | 币种 | BTC |
endTime | Yes | string | 毫秒时间戳 | 当前时间戳 |
size | Yes | string | 数量,最大 500 | 100 |
interval | Yes | string | 周期 | 1h |
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/openInterest/all?baseCoin=BTC"
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/openInterest/aggKline?baseCoin=BTC&interval=1h&endTime=$NOW&size=10"
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/instruments/oiVsMc?baseCoin=BTC&endTime=$NOW&size=100&interval=1h"
12. 热门排行 — 8 个接口 · API2
GET /api/instruments/visualScreener — 视觉筛选器
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
interval | Yes | string | 15m / 1h / 4h / 24h | 15m |
GET /api/instruments/oiVsMarketCap — 持仓/市值排行
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
page | Yes | integer | 页码 | 1 |
size | Yes | integer | 每页数量 | 10 |
sortBy | Yes | string | 排序字段 | openInterest |
sortType | Yes | string | desc / asc | desc |
GET /api/instruments/longShortRank — 多空持仓人数比排行
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
sortBy | Yes | string | 排序字段 | longRatio |
sortType | Yes | string | desc / asc | desc |
size | Yes | integer | 每页数量 | 10 |
page | Yes | integer | 页码 | 1 |
GET /api/instruments/oiRank — 持仓量排行榜
参数同 longShortRank,sortBy 示例值:openInterest。
GET /api/trades/count — 交易笔数排行
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
productType | Yes | string | SWAP / SPOT | SWAP |
sortBy | Yes | string | 排序字段,如 h1Count(1小时)、d1Count(1天) | h1Count |
sortType | Yes | string | desc / asc | desc |
GET /api/instruments/liquidationRank — 爆仓排行榜
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
sortBy | Yes | string | 排序字段,如 liquidationH24 | liquidationH24 |
sortType | Yes | string | desc / asc | desc |
page | Yes | integer | 页码 | 1 |
size | Yes | integer | 每页数量 | 10 |
GET /api/instruments/priceRank — 价格变化排行
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
sortBy | Yes | string | 如 priceChangeH24(24h涨跌幅) | priceChangeH24 |
sortType | Yes | string | desc / asc | desc |
GET /api/instruments/volumeRank — 交易量变化排行
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
sortBy | Yes | string | 如 h24Volume(24h交易量) | h24Volume |
sortType | Yes | string | desc / asc | desc |
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/instruments/visualScreener?interval=15m"
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/trades/count?productType=SWAP&sortBy=h1Count&sortType=desc"
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/instruments/priceRank?sortBy=priceChangeH24&sortType=desc"
13. 爆仓数据 — 8 个接口 · API1
GET /api/liquidation/allExchange/intervals — 各时间段实时爆仓统计
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
baseCoin | Yes | string | 币种 | BTC |
GET /api/liquidation/aggregated-history — 聚合爆仓历史
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
baseCoin | Yes | string | 币种 | BTC |
interval | Yes | string | 周期 | 1h |
endTime | Yes | number | 毫秒时间戳 | 当前时间戳 |
size | Yes | integer | 数量 | 10 |
GET /api/liquidation/history — 交易对爆仓历史
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
exchange | Yes | string | 交易所 | Binance |
symbol | Yes | string | 交易对 | BTCUSDT |
interval | Yes | string | 周期 | 1h |
endTime | Yes | number | 毫秒时间戳 | 当前时间戳 |
size | Yes | integer | 数量 | 10 |
GET /api/liquidation/orders — 爆仓订单列表
API等级:API3
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
baseCoin | Yes | string | 币种 | BTC |
exchange | Yes | string | 交易所 | Binance |
side | Yes | string | long 多 / short 空 | long |
amount | Yes | number | 最低爆仓金额(USD) | 100 |
endTime | Yes | number | 毫秒时间戳 | 当前时间戳 |
GET /api/liqMap/getLiqMap — 清算地图
API等级:API4
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
symbol | Yes | string | 交易对 | BTCUSDT |
exchange | Yes | string | 交易所 | Binance |
interval | Yes | string | 周期 | 1d |
GET /api/liqMap/getAggLiqMap — 聚合清算地图
API等级:API4
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
baseCoin | Yes | string | 币种 | BTC |
interval | Yes | string | 周期 | 1d |
GET /api/liqMap/getLiqHeatMap — 清算热力图
API等级:API4
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
exchange | Yes | string | 交易所 | Binance |
symbol | Yes | string | 交易对 | BTCUSDT |
interval | Yes | string | 周期 | 1d |
GET /api/liqMap/getLiqHeatMapSymbol — 清算热图支持的交易对列表
API等级:API1 | 无需参数
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/liquidation/allExchange/intervals?baseCoin=BTC"
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/liquidation/orders?baseCoin=BTC&exchange=Binance&side=long&amount=100&endTime=$NOW"
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/liqMap/getLiqHeatMapSymbol"
14. 订单本 — 3 个接口 · API3
GET /api/orderBook/v2/bySymbol — 按交易对查询挂单深度历史
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
symbol | Yes | string | 交易对 | BTCUSDT |
exchange | Yes | string | 交易所 | Binance |
rate | Yes | number | 价格精度比例 | 0.01 |
productType | Yes | string | SWAP / SPOT | SWAP |
interval | Yes | string | 周期 | 1h |
endTime | Yes | number | 毫秒时间戳 | 当前时间戳 |
size | Yes | integer | 数量,最大 500 | 10 |
GET /api/orderBook/v2/byExchange — 按交易所查询挂单深度历史
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
baseCoin | Yes | string | 币种 | BTC |
productType | Yes | string | SWAP / SPOT | SWAP |
interval | Yes | string | 周期 | 1h |
endTime | Yes | number | 毫秒时间戳 | 当前时间戳 |
size | Yes | integer | 数量,最大 500 | 10 |
exchanges | Yes | string | 交易所名称 | Binance |
type | Yes | string | 价格精度比例 | 0.01 |
GET /api/orderBook/getHeatMap — 挂单流动性热力图
API等级:API4
此接口
endTime参数会被 CDN 缓存层校验,必须传入当前毫秒时间戳。
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
exchange | Yes | string | 交易所(目前仅支持 Binance) | Binance |
symbol | Yes | string | 交易对 | BTCUSDT |
interval | Yes | string | 周期:1m / 3m / 5m | 1m |
endTime | Yes | string | 毫秒时间戳(必须传当前时间,过期时间会被 CDN 拦截返回 401) | 当前时间戳 |
size | Yes | string | 数量,最大 500 | 10 |
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/orderBook/v2/bySymbol?symbol=BTCUSDT&exchange=Binance&rate=0.01&productType=SWAP&interval=1h&endTime=$NOW&size=10"
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/orderBook/getHeatMap?exchange=Binance&symbol=BTCUSDT&interval=1m&endTime=$NOW&size=10"
15. 资金流 — 2 个接口 · API3
GET /api/fund/fundReal — 实时资金流
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
productType | Yes | string | SWAP / SPOT | SWAP |
page | Yes | integer | 页码 | 1 |
size | Yes | integer | 每页数量 | 10 |
sortBy | Yes | string | 排序字段,如 h1net(1h净流入) | h1net |
sortType | Yes | string | desc / asc | desc |
baseCoin | Yes | string | 币种(传空字符串查全部) | BTC |
GET /api/fund/getFundHisList — 历史资金流
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
baseCoin | Yes | string | 币种 | BTC |
endTime | Yes | number | 毫秒时间戳 | 当前时间戳 |
productType | Yes | string | SWAP / SPOT | SWAP |
size | Yes | integer | 数量 | 10 |
interval | Yes | string | 周期 | 1h |
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/fund/fundReal?productType=SWAP&page=1&size=10&sortBy=h1net&sortType=desc&baseCoin=BTC"
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/fund/getFundHisList?baseCoin=BTC&endTime=$NOW&productType=SWAP&size=10&interval=1h"
16. 订单流 — 1 个接口 · API3
GET /api/orderFlow/lists — 订单流数据
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
exchange | Yes | string | 交易所 | Binance |
symbol | Yes | string | 交易对 | BTCUSDT |
interval | Yes | string | 周期 | 1h |
endTime | Yes | number | 毫秒时间戳 | 当前时间戳 |
size | Yes | integer | 数量 | 10 |
productType | Yes | string | SWAP / SPOT | SWAP |
tickCount | Yes | integer | tick 数量 | 1 |
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/orderFlow/lists?exchange=Binance&symbol=BTCUSDT&interval=1h&endTime=$NOW&size=10&productType=SWAP&tickCount=1"
17. 资金费率 — 7 个接口 · API1
GET /api/fundingRate/hist — 历史资金费率(跨交易所)
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
baseCoin | Yes | string | 币种 | BTC |
exchangeType | Yes | string | 计价币类型:USDT / USD(币本位) | USDT |
endTime | Yes | number | 毫秒时间戳 | 当前时间戳 |
size | Yes | integer | 数量 | 10 |
GET /api/fundingRate/current — 实时资金费率排行
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
type | Yes | string | current 实时 / day 1日 / week 1周 / month 1月 / year 1年 | current |
GET /api/fundingRate/accumulated — 累计资金费率
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
type | Yes | string | day / week / month / year | day |
GET /api/fundingRate/indicator — 交易对资金费率历史
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
exchange | Yes | string | 交易所(Binance / OKX / Bybit / Huobi / Gate / Bitget) | Binance |
symbol | Yes | string | 交易对 | BTCUSDT |
interval | Yes | string | 周期 | 1h |
endTime | Yes | string | 毫秒时间戳 | 当前时间戳 |
size | Yes | string | 数量,最大 500 | 10 |
GET /api/fundingRate/kline — 资金费率 K 线
参数与 fundingRate/indicator 相同。
GET /api/fundingRate/getWeiFr — 加权资金费率
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
baseCoin | Yes | string | 币种 | BTC |
interval | Yes | string | 周期 | 1h |
endTime | Yes | string | 毫秒时间戳 | 当前时间戳 |
size | Yes | string | 数量,最大 500 | 10 |
GET /api/fundingRate/frHeatmap — 资金费率热力图
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
type | Yes | string | openInterest 按持仓 / marketCap 按市值 | marketCap |
interval | Yes | string | 1D / 1W / 1M / 6M | 1M |
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/fundingRate/current?type=current"
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/fundingRate/accumulated?type=day"
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/fundingRate/frHeatmap?type=marketCap&interval=1M"
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/fundingRate/getWeiFr?baseCoin=BTC&interval=1h&endTime=$NOW&size=10"
18. RSI 选币器 — 1 个接口 · API2
GET /api/rsiMap/list — RSI 指标筛选
| 参数 | 必填 | 类型 | 说明 | 示例 |
|---|---|---|---|---|
interval | Yes | string | 周期(注意大写H/D):1H / 4H / 1D 等 | 1H |
exchange | Yes | string | 交易所 | Binance |
curl -H "apikey: $APIKEY" \
"https://open-api.coinank.com/api/rsiMap/list?interval=1H&exchange=Binance"
枚举值速查
interval(K线/历史数据周期)
| 值 | 说明 |
|---|---|
1m | 1 分钟 |
3m | 3 分钟 |
5m | 5 分钟 |
15m | 15 分钟 |
30m | 30 分钟 |
1h | 1 小时 |
2h | 2 小时 |
4h | 4 小时 |
6h | 6 小时 |
8h | 8 小时 |
12h | 12 小时 |
1d | 1 天 |
RSI 选币器使用大写:
1H、4H、1D资金费率热力图使用:1D、1W、1M、6M
exchange(主流交易所)
| 值 | 说明 |
|---|---|
Binance | 币安 |
OKX | 欧易 |
Bybit | Bybit |
Bitget | Bitget |
Gate | Gate.io |
Huobi | 火币 |
Bitmex | BitMEX |
dYdX | dYdX |
Bitfinex | Bitfinex |
CME | 芝商所 |
Kraken | Kraken |
Deribit | Deribit |
productType(产品类型)
| 值 | 说明 |
|---|---|
SWAP | 永续合约 |
SPOT | 现货 |
FUTURES | 交割合约 |
sortBy 常用字段
| 接口类型 | 常用 sortBy 值 |
|---|---|
| 持仓排行 | openInterest |
| 爆仓排行 | liquidationH24、liquidationH12、liquidationH8、liquidationH4、liquidationH1 |
| 价格排行 | priceChangeH24、priceChangeH1、priceChangeM5 |
| 交易量排行 | h24Volume、h1Volume |
| 笔数排行 | h1Count、d1Count、h4Count |
| 资金流 | h1net、h4net、h8net、h24net |
| 鲸鱼持仓 | positionValue、unrealizedPnl |
License
MIT License — CoinAnk
Built for AI-powered crypto derivatives intelligence.
Made by CoinAnk