Skip to content

coinank/coinank-openapi

v1.0.0MIT

Access CoinAnk crypto derivatives market data via API key or Agent Payments Protocol/x402 pay-per-call.

CoinAnk OpenAPI Skill

> AI Agent 的加密衍生品数据引擎_

Endpoints OKX Plugin Store REST License

简体中文 · English

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 线1API1
ETF5API1
币种和交易对5API1
指标数据11API1
新闻快讯2API2

衍生品深度

分类接口数API等级
未平仓合约7API1
资金费率7API1
多空比6API1
爆仓数据8API1
RSI 选币器1API2

机构级数据

分类接口数API等级
大额订单2API3
市价单统计8API3
订单本3API3
资金流2API3
订单流1API3
净多头/净空头1API3

链上与鲸鱼

分类接口数API等级
HyperLiquid 鲸鱼2API2
热门排行8API2

合计: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 URLhttps://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成功
-3API 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 时,推荐流程是:

  1. 先按原请求发送一次,不预先登录、不预先扣费。
  2. 如果服务端返回 HTTP 402 Payment Required,解析支付挑战。
  3. 向用户展示本次支付的网络、币种、金额、收款地址;如果金额大于 0,则等待用户确认。
  4. 使用最新版 okx-agent-payments-protocol 处理支付;它同时支持 Agent Payments Protocol / x402 支付证明和新的 charge 支付方式。
  5. 如果 OKX 支付 skill 返回或要求 charge 方式,则走 charge 流程,不要强制套用旧的 x402-only proof 流程。
  6. 仅在原请求基础上追加支付 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 钱包私钥 签名,必须使用 exact scheme
  • 如果使用 OKX 合约钱包 / OKX 钱包会话签名,必须使用 aggr_deferred scheme

不要混用这两条路径,否则会导致支付流程和签名语义不匹配。

接口详情


1. K 线 — 1 个接口 · API1

GET /api/kline/lists — K线行情数据

参数必填类型说明示例
symbolYesstring交易对BTCUSDT
exchangeYesstring交易所Binance
endTimeYesnumber毫秒时间戳,返回此时间之前的数据当前时间戳
sizeYesinteger数量,最大 50010
intervalYesstring周期,见枚举值1h
productTypeYesstringSWAP 合约 / 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 — 鲸鱼持仓排行

参数必填类型说明示例
sortByYesstring排序字段positionValue
sortTypeYesstringdesc 降序 / asc 升序desc
pageYesinteger页码1
sizeYesinteger每页数量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 — 净多头/净空头历史

参数必填类型说明示例
exchangeYesstring交易所Binance
symbolYesstring交易对BTCUSDT
intervalYesstring周期1h
endTimeYesnumber毫秒时间戳当前时间戳
sizeYesinteger数量,最大 50010
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 — 大额市价订单

参数必填类型说明示例
symbolYesstring交易对BTCUSDT
productTypeYesstringSWAP 合约 / SPOT 现货SWAP
amountYesstring最小金额(USD)10000000
endTimeYesstring毫秒时间戳当前时间戳
sizeYesstring数量,最大 50010

GET /api/bigOrder/queryOrderList — 大额限价订单

参数必填类型说明示例
symbolYesstring交易对BTCUSDT
exchangeTypeYesstringSWAP 永续 / SPOT 现货 / FUTURES 交割SWAP
sizeYesinteger数量,最大 50010
amountYesnumber最低金额(USD)1000000
sideYesstringask 卖 / bid 买ask
exchangeYesstring交易所(Binance / OKX / Coinbase)Binance
isHistoryYesstringtrue 历史 / false 实时true
startTimeNonumber截止时间戳(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 — 实时价格

参数必填类型说明示例
symbolYesstring交易对BTCUSDT
exchangeYesstring交易所Binance
productTypeYesstringSWAP / SPOTSWAP

GET /api/instruments/getCoinMarketCap — 币种市值信息

参数必填类型说明示例
baseCoinYesstring币种BTC

GET /api/baseCoin/list — 支持的币种列表

参数必填类型说明示例
productTypeYesstringSWAP / SPOTSWAP

GET /api/baseCoin/symbols — 支持的交易对列表

参数必填类型说明示例
exchangeYesstring交易所Binance
productTypeYesstringSWAP / SPOTSWAP

GET /api/instruments/agg — 合约聚合行情

参数必填类型说明示例
pageNointeger页码,默认 11
sizeNointeger每页条数,默认 5050

返回全币种聚合行情:价格、聚合未平仓合约及 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

参数必填类型说明示例
baseCoinYesstring币种BTC
intervalYesstring周期1h
endTimeYesstring毫秒时间戳当前时间戳
sizeYesstring数量10

GET /api/longshort/realtimeAll — 交易所实时多空比

参数必填类型说明示例
baseCoinYesstring币种BTC
intervalYesstring周期,可选 5m/15m/30m/1h/2h/4h/6h/8h/12h/1d1h

GET /api/longshort/person — 多空持仓人数比

支持交易所:Binance / OKX / Bybit

参数必填类型说明示例
exchangeYesstring交易所Binance
symbolYesstring交易对BTCUSDT
intervalYesstring周期1h
endTimeYesstring毫秒时间戳当前时间戳
sizeYesstring数量,最大 50010

GET /api/longshort/position — 大户多空比(持仓量)

支持交易所:Binance / OKX / Huobi — 参数与 person 相同。

GET /api/longshort/account — 大户多空比(账户数)

支持交易所:Binance / OKX / Huobi — 参数与 person 相同。

GET /api/longshort/kline — 多空比 K 线

支持交易所:Binance / OKX / Huobi

参数必填类型说明示例
exchangeYesstring交易所Binance
symbolYesstring交易对BTCUSDT
intervalYesstring周期1h
endTimeYesstring毫秒时间戳当前时间戳
sizeYesstring数量,最大 50010
typeYesstringlongShortPerson 人数比 / 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/getCvdCVD(主动买卖量差)
GET /api/marketOrder/getBuySellCount主动买卖笔数
GET /api/marketOrder/getBuySellValue主动买卖额(USD)
GET /api/marketOrder/getBuySellVolume主动买卖量(币本位)

公共参数:

参数必填类型说明示例
exchangeYesstring交易所(Binance / OKX / Bybit / Bitget)Binance
symbolYesstring交易对BTCUSDT
intervalYesstring周期1h
endTimeYesstring毫秒时间戳当前时间戳
sizeYesinteger数量,最大 50010
productTypeYesstringSWAP / SPOTSWAP

聚合系列(按 baseCoin 跨交易所聚合)

接口说明
GET /api/marketOrder/getAggCvd聚合 CVD
GET /api/marketOrder/getAggBuySellCount聚合买卖笔数
GET /api/marketOrder/getAggBuySellValue聚合买卖额
GET /api/marketOrder/getAggBuySellVolume聚合买卖量

公共参数:

参数必填类型说明示例
baseCoinYesstring币种BTC
intervalYesstring周期1h
endTimeYesstring毫秒时间戳当前时间戳
sizeYesinteger数量,最大 50010
productTypeYesstringSWAP / SPOTSWAP
exchangesYesstring传空字符串表示聚合所有交易所(空)
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 — 新闻/快讯列表

参数必填类型说明示例
typeYesstring1 快讯 / 2 新闻1
langYesstring语言:zh 中文 / en 英文zh
pageYesstring页码1
pageSizeYesstring每页数量10
isPopularYesstring是否推荐:true / falsefalse
searchYesstring搜索关键词,无则传空字符串(空)

GET /api/news/getNewsDetail — 新闻详情

参数必填类型说明示例
idYesstring新闻 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/getAhr999ahr999 囤币指标
GET /api/indicator/getPuellMultiple普尔系数(Puell Multiple)
GET /api/indicator/getBtcPiPi 循环顶部指标
GET /api/indicator/getMovingAvgHeatmap200 周均线热力图
GET /api/indicator/getAltcoinSeason山寨季指数

GET /api/indicator/getMarketCapRank — 市值占比排名

参数必填类型说明示例
symbolYesstring币种BTC

GET /api/indicator/getGrayscaleOpenInterest — 灰度持仓数据

参数必填类型说明示例
symbolYesstring币种BTC

GET /api/indicator/smc — SMC 聪明钱指标

参数必填类型说明示例
symbolYesstring交易对BTCUSDT
intervalYesstring周期1d
exchangeNostring交易所,默认 BinanceBinance

返回 SMC(Smart Money Concepts)结构数据:摆动高低点、BOS/CHoCH、FVG 公允价值缺口、看涨/看跌订单块、Breaker Block。

GET /api/indicator/index/charts — 彩虹图等综合指标

参数必填类型说明示例
typeYesstring图表类型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 — 实时持仓列表(全交易所)

参数必填类型说明示例
baseCoinYesstring币种BTC

GET /api/openInterest/v2/chart — 币种聚合持仓历史

参数必填类型说明示例
baseCoinYesstring币种BTC
exchangeYesstring交易所,传空字符串查全部(空)
intervalYesstring周期1h
sizeYesstring数量,最大 50010
typeYesstringUSD 美元计价 / 币种名(如 BTC)币本位USD
endTimeYesnumber毫秒时间戳当前时间戳

GET /api/openInterest/symbol/Chart — 交易对持仓历史

参数必填类型说明示例
exchangeYesstring交易所Binance
symbolYesstring交易对BTCUSDT
intervalYesstring周期1h
endTimeYesnumber毫秒时间戳当前时间戳
sizeYesstring数量,最大 50010
typeYesstringUSD / 币种名USD

GET /api/openInterest/kline — 交易对持仓 K 线

参数必填类型说明示例
exchangeYesstring交易所Binance
symbolYesstring交易对BTCUSDT
intervalYesstring周期1h
endTimeYesnumber毫秒时间戳当前时间戳
sizeYesinteger数量10

GET /api/openInterest/aggKline — 聚合持仓 K 线

参数必填类型说明示例
baseCoinYesstring币种BTC
intervalYesstring周期1h
endTimeYesnumber毫秒时间戳当前时间戳
sizeYesinteger数量10

GET /api/tickers/topOIByEx — 实时持仓(按交易所统计)

参数必填类型说明示例
baseCoinYesstring币种BTC

GET /api/instruments/oiVsMc — 历史持仓市值比

API等级:API2

参数必填类型说明示例
baseCoinYesstring币种BTC
endTimeYesstring毫秒时间戳当前时间戳
sizeYesstring数量,最大 500100
intervalYesstring周期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 — 视觉筛选器

参数必填类型说明示例
intervalYesstring15m / 1h / 4h / 24h15m

GET /api/instruments/oiVsMarketCap — 持仓/市值排行

参数必填类型说明示例
pageYesinteger页码1
sizeYesinteger每页数量10
sortByYesstring排序字段openInterest
sortTypeYesstringdesc / ascdesc

GET /api/instruments/longShortRank — 多空持仓人数比排行

参数必填类型说明示例
sortByYesstring排序字段longRatio
sortTypeYesstringdesc / ascdesc
sizeYesinteger每页数量10
pageYesinteger页码1

GET /api/instruments/oiRank — 持仓量排行榜

参数同 longShortRank,sortBy 示例值:openInterest。

GET /api/trades/count — 交易笔数排行

参数必填类型说明示例
productTypeYesstringSWAP / SPOTSWAP
sortByYesstring排序字段,如 h1Count(1小时)、d1Count(1天)h1Count
sortTypeYesstringdesc / ascdesc

GET /api/instruments/liquidationRank — 爆仓排行榜

参数必填类型说明示例
sortByYesstring排序字段,如 liquidationH24liquidationH24
sortTypeYesstringdesc / ascdesc
pageYesinteger页码1
sizeYesinteger每页数量10

GET /api/instruments/priceRank — 价格变化排行

参数必填类型说明示例
sortByYesstring如 priceChangeH24(24h涨跌幅)priceChangeH24
sortTypeYesstringdesc / ascdesc

GET /api/instruments/volumeRank — 交易量变化排行

参数必填类型说明示例
sortByYesstring如 h24Volume(24h交易量)h24Volume
sortTypeYesstringdesc / ascdesc
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 — 各时间段实时爆仓统计

参数必填类型说明示例
baseCoinYesstring币种BTC

GET /api/liquidation/aggregated-history — 聚合爆仓历史

参数必填类型说明示例
baseCoinYesstring币种BTC
intervalYesstring周期1h
endTimeYesnumber毫秒时间戳当前时间戳
sizeYesinteger数量10

GET /api/liquidation/history — 交易对爆仓历史

参数必填类型说明示例
exchangeYesstring交易所Binance
symbolYesstring交易对BTCUSDT
intervalYesstring周期1h
endTimeYesnumber毫秒时间戳当前时间戳
sizeYesinteger数量10

GET /api/liquidation/orders — 爆仓订单列表

API等级:API3

参数必填类型说明示例
baseCoinYesstring币种BTC
exchangeYesstring交易所Binance
sideYesstringlong 多 / short 空long
amountYesnumber最低爆仓金额(USD)100
endTimeYesnumber毫秒时间戳当前时间戳

GET /api/liqMap/getLiqMap — 清算地图

API等级:API4

参数必填类型说明示例
symbolYesstring交易对BTCUSDT
exchangeYesstring交易所Binance
intervalYesstring周期1d

GET /api/liqMap/getAggLiqMap — 聚合清算地图

API等级:API4

参数必填类型说明示例
baseCoinYesstring币种BTC
intervalYesstring周期1d

GET /api/liqMap/getLiqHeatMap — 清算热力图

API等级:API4

参数必填类型说明示例
exchangeYesstring交易所Binance
symbolYesstring交易对BTCUSDT
intervalYesstring周期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 — 按交易对查询挂单深度历史

参数必填类型说明示例
symbolYesstring交易对BTCUSDT
exchangeYesstring交易所Binance
rateYesnumber价格精度比例0.01
productTypeYesstringSWAP / SPOTSWAP
intervalYesstring周期1h
endTimeYesnumber毫秒时间戳当前时间戳
sizeYesinteger数量,最大 50010

GET /api/orderBook/v2/byExchange — 按交易所查询挂单深度历史

参数必填类型说明示例
baseCoinYesstring币种BTC
productTypeYesstringSWAP / SPOTSWAP
intervalYesstring周期1h
endTimeYesnumber毫秒时间戳当前时间戳
sizeYesinteger数量,最大 50010
exchangesYesstring交易所名称Binance
typeYesstring价格精度比例0.01

GET /api/orderBook/getHeatMap — 挂单流动性热力图

API等级:API4

此接口 endTime 参数会被 CDN 缓存层校验,必须传入当前毫秒时间戳。

参数必填类型说明示例
exchangeYesstring交易所(目前仅支持 Binance)Binance
symbolYesstring交易对BTCUSDT
intervalYesstring周期:1m / 3m / 5m1m
endTimeYesstring毫秒时间戳(必须传当前时间,过期时间会被 CDN 拦截返回 401)当前时间戳
sizeYesstring数量,最大 50010
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 — 实时资金流

参数必填类型说明示例
productTypeYesstringSWAP / SPOTSWAP
pageYesinteger页码1
sizeYesinteger每页数量10
sortByYesstring排序字段,如 h1net(1h净流入)h1net
sortTypeYesstringdesc / ascdesc
baseCoinYesstring币种(传空字符串查全部)BTC

GET /api/fund/getFundHisList — 历史资金流

参数必填类型说明示例
baseCoinYesstring币种BTC
endTimeYesnumber毫秒时间戳当前时间戳
productTypeYesstringSWAP / SPOTSWAP
sizeYesinteger数量10
intervalYesstring周期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 — 订单流数据

参数必填类型说明示例
exchangeYesstring交易所Binance
symbolYesstring交易对BTCUSDT
intervalYesstring周期1h
endTimeYesnumber毫秒时间戳当前时间戳
sizeYesinteger数量10
productTypeYesstringSWAP / SPOTSWAP
tickCountYesintegertick 数量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 — 历史资金费率(跨交易所)

参数必填类型说明示例
baseCoinYesstring币种BTC
exchangeTypeYesstring计价币类型:USDT / USD(币本位)USDT
endTimeYesnumber毫秒时间戳当前时间戳
sizeYesinteger数量10

GET /api/fundingRate/current — 实时资金费率排行

参数必填类型说明示例
typeYesstringcurrent 实时 / day 1日 / week 1周 / month 1月 / year 1年current

GET /api/fundingRate/accumulated — 累计资金费率

参数必填类型说明示例
typeYesstringday / week / month / yearday

GET /api/fundingRate/indicator — 交易对资金费率历史

参数必填类型说明示例
exchangeYesstring交易所(Binance / OKX / Bybit / Huobi / Gate / Bitget)Binance
symbolYesstring交易对BTCUSDT
intervalYesstring周期1h
endTimeYesstring毫秒时间戳当前时间戳
sizeYesstring数量,最大 50010

GET /api/fundingRate/kline — 资金费率 K 线

参数与 fundingRate/indicator 相同。

GET /api/fundingRate/getWeiFr — 加权资金费率

参数必填类型说明示例
baseCoinYesstring币种BTC
intervalYesstring周期1h
endTimeYesstring毫秒时间戳当前时间戳
sizeYesstring数量,最大 50010

GET /api/fundingRate/frHeatmap — 资金费率热力图

参数必填类型说明示例
typeYesstringopenInterest 按持仓 / marketCap 按市值marketCap
intervalYesstring1D / 1W / 1M / 6M1M
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 指标筛选

参数必填类型说明示例
intervalYesstring周期(注意大写H/D):1H / 4H / 1D 等1H
exchangeYesstring交易所Binance
curl -H "apikey: $APIKEY" \
  "https://open-api.coinank.com/api/rsiMap/list?interval=1H&exchange=Binance"

枚举值速查

interval(K线/历史数据周期)

值说明
1m1 分钟
3m3 分钟
5m5 分钟
15m15 分钟
30m30 分钟
1h1 小时
2h2 小时
4h4 小时
6h6 小时
8h8 小时
12h12 小时
1d1 天

RSI 选币器使用大写:1H、4H、1D 资金费率热力图使用:1D、1W、1M、6M

exchange(主流交易所)

值说明
Binance币安
OKX欧易
BybitBybit
BitgetBitget
GateGate.io
Huobi火币
BitmexBitMEX
dYdXdYdX
BitfinexBitfinex
CME芝商所
KrakenKraken
DeribitDeribit

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