市场数据 API

AICoin开放API提供了涵盖从合约数据到市场指数和K线图的广泛数据集合，提供市场深度、活跃度和价格趋势等关键指标，帮助用户在复杂的市场环境中抓住机遇。

GET/v2/futures/interest

获取合约持仓数据

此接口用于获取合约持仓数据。

请求参数

Name
lan
Type
integer
Description
语言
Name
page
Type
integer
Description
页数
Name
pageSize
Type
integer
Description
页面大小(最大值为20)
Name
currency
Type
string
Description
定价,cny 或 usd
Name
AccessKeyId
Type
string
Description
用户访问密钥ID
Name
SignatureNonce
Type
string
Description
签名随机数
Name
Timestamp
Type
string
Description
请求时间戳(秒)，有效期30秒
Name
Signature
Type
string
Description
使用 HmacSHA1 + Base64 生成的签名，请参考如何获取 API 认证参数

返回数据

Name
success
Type
boolean
Description
接口状态
Name
errorCode
Type
integer
Description
状态码
Name
error
Type
string
Description
错误提示信息
Name
data
Type
object
Description
返回数据
- Name
  list
  Type
  array
  Description
  数据列表
  Name
  key
  Type
  string
  Description
  交易对主键
  Name
  show
  Type
  string
  Description
  交易对简称
  Name
  currency
  Type
  string
  Description
  交易对定价
  Name
  market_name
  Type
  string
  Description
  交易对平台名称
  Name
  trade
  Type
  string
  Description
  成交额
  Name
  vol_coin
  Type
  string
  Description
  持仓量（币种数量）
  Name
  trend
  Type
  array
  Description
  趋势图
  Name
  time
  Type
  string
  Description
  时间戳，单位秒
  Name
  close
  Type
  string
  Description
  收盘持仓量

请求

GET

/v2/futures/interest

curl -G https://open.aicoin.com/api/v2/futures/interest \
  -d "lan=cn" \
  -d "page=1" \
  -d "pageSize=20" \
  -d "currency=usd" \
  -d "AccessKeyId=YOUR_ACCESS_KEY_ID" \
  -d "SignatureNonce=RANDOM_NONCE" \
  -d "Timestamp=CURRENT_TIMESTAMP" \
  -d "Signature=YOUR_SIGNATURE"

响应

{
  "success": true,
  "errorCode": 200,
  "error": "",
  "data": {
    "list": [
      {
        "key": "xbt:bitmex",
        "show": "BTC",
        "currency": "USD",
        "market_name": "BitMEX永续",
        "trade": "3485934999.08",
        "vol_coin": "97257.32371667",
        "trend": [
          {
            "time": "1554832800",
            "close": "470170798"
          }
        ]
      }
    ]
  }
}

GET/v2/index/indexPrice

获取指数价格

此接口用于获取指数价格数据。

请求参数

Name
key
Type
string
Description
指数主键（通过 /api/v2/index/getIndex 获取）
Name
currency
Type
string
Description
定价，cny、usd等
Name
AccessKeyId
Type
string
Description
用户访问密钥ID
Name
SignatureNonce
Type
string
Description
签名随机数
Name
Timestamp
Type
string
Description
请求时间戳(秒)，有效期30秒
Name
Signature
Type
string
Description
使用 HmacSHA1 + Base64 生成的签名，请参考如何获取 API 认证参数

返回数据

Name
success
Type
boolean
Description
接口状态
Name
errorCode
Type
integer
Description
状态码
Name
error
Type
string
Description
错误提示信息
Name
data
Type
object
Description
返回数据
- Name
  price
  Type
  string
  Description
  最新价
- Name
  open
  Type
  string
  Description
  今天开盘价
- Name
  high
  Type
  string
  Description
  24小时最高价
- Name
  low
  Type
  string
  Description
  24小时最低价
- Name
  close
  Type
  string
  Description
  昨天收盘价
- Name
  degree24H
  Type
  string
  Description
  24小时涨跌幅
- Name
  change24H
  Type
  string
  Description
  24小时涨跌
- Name
  up
  Type
  string
  Description
  上涨
- Name
  down
  Type
  string
  Description
  下跌

请求

GET

/v2/index/indexPrice

curl -G https://open.aicoin.com/api/v2/index/indexPrice \
  -d "key=i:diniw:ice" \
  -d "currency=usd" \
  -d "AccessKeyId=YOUR_ACCESS_KEY_ID" \
  -d "SignatureNonce=RANDOM_NONCE" \
  -d "Timestamp=CURRENT_TIMESTAMP" \
  -d "Signature=YOUR_SIGNATURE"

响应

{
  "success": true,
  "errorCode": 200,
  "error": "",
  "data": {
    "price": "933.2206291652",
    "open": "966.1194468979",
    "high": "968.23409269",
    "low": "890.6764162168",
    "close": "906.5192845811",
    "degree24H": "2.88",
    "change24H": "26.13",
    "up": "0",
    "down": "0"
  }
}

GET/v2/index/indexInfo

获取指数信息

此接口用于获取指数的详细信息。

请求参数

Name
key
Type
string
Description
指数主键（通过 /api/v2/index/getIndex 获取）
Name
lan
Type
string
Description
语言，en, cn
Name
AccessKeyId
Type
string
Description
用户访问密钥ID
Name
SignatureNonce
Type
string
Description
签名随机数
Name
Timestamp
Type
string
Description
请求时间戳(秒)，有效期30秒
Name
Signature
Type
string
Description
使用 HmacSHA1 + Base64 生成的签名，请参考如何获取 API 认证参数

返回数据

Name
success
Type
boolean
Description
接口状态
Name
errorCode
Type
integer
Description
状态码
Name
error
Type
string
Description
错误提示信息
Name
data
Type
object
Description
返回数据
- Name
  show
  Type
  string
  Description
  指数简称
- Name
  name
  Type
  string
  Description
  指数名称
- Name
  link
  Type
  string
  Description
  官方网站
- Name
  release_date
  Type
  string
  Description
  发布日期
- Name
  amount
  Type
  string
  Description
  成分币数量
- Name
  introduce
  Type
  string
  Description
  指数说明
- Name
  file_name
  Type
  string
  Description
  编制文件名称
- Name
  file_link
  Type
  string
  Description
  编制文件链接

请求

GET

/v2/index/indexInfo

curl -G https://open.aicoin.com/api/v2/index/indexInfo \
  -d "key=i:diniw:ice" \
  -d "lan=cn"

响应

{
  "success": true,
  "errorCode": 200,
  "error": "",
  "data": {
    "show": "DXY",
    "name": "美元指数",
    "link": "https://finance.sina.com.cn/money/forex/hq/DINIW.shtml",
    "release_date": "",
    "amount": "0",
    "introduce": "",
    "file_name": "",
    "file_link": ""
  }
}

GET/v2/index/getIndex

获取指数列表

此接口用于获取指数列表。

请求参数

Name
AccessKeyId
Type
string
Description
用户访问密钥ID
Name
SignatureNonce
Type
string
Description
签名随机数
Name
Timestamp
Type
string
Description
请求时间戳(秒)，有效期30秒
Name
Signature
Type
string
Description
使用 HmacSHA1 + Base64 生成的签名，请参考如何获取 API 认证参数

返回数据

Name
success
Type
boolean
Description
接口状态
Name
errorCode
Type
integer
Description
状态码
Name
error
Type
string
Description
错误提示信息
Name
data
Type
object
Description
返回数据
- Name
  list
  Type
  array
  Description
  指数列表
  Name
  key
  Type
  string
  Description
  指数主键
  Name
  cn_name
  Type
  string
  Description
  指数中文名称
  Name
  en_name
  Type
  string
  Description
  指数英文名称
  Name
  show
  Type
  string
  Description
  指数简称
  Name
  describe
  Type
  string
  Description
  指数描述
  Name
  degree24h
  Type
  string
  Description
  24小时涨跌幅
  Name
  price
  Type
  string
  Description
  最新价格
  Name
  en_type
  Type
  string
  Description
  英文类型
  Name
  cn_type
  Type
  string
  Description
  中文类型
- Name
  count
  Type
  string
  Description
  指数数量

请求

GET

/v2/index/getIndex

curl -G https://open.aicoin.com/api/v2/index/getIndex \
  -H "AccessKeyId: YOUR_ACCESS_KEY" \
  -H "SignatureNonce: RANDOM_NONCE" \
  -H "Timestamp: TIMESTAMP" \
  -H "Signature: YOUR_SIGNATURE"

响应

{
  "success": true,
  "errorCode": 200,
  "error": "",
  "data": {
    "list": [
      {
        "key": "i:fgi:alternative",
        "cn_name": "恐惧&贪婪指数",
        "en_name": "Crypto Fear & Greed Index",
        "show": "FGI",
        "describe": "描述",
        "degree24h": "-6.00",
        "price": "47",
        "cn_type": "",
        "en_type": ""
      }
    ],
    "count": "156"
  }
}

GET/v2/indicatorKline/getTradingPair

k线指标交易对

此接口用于获取k线指标交易对。

请求参数

Name
coinType
Type
string
Description
币种，如 bitcoin
Name
indicator_key
Type
string
Description
指标主键：
- fundflow: 资金流向，字段：timestmap(时间戳)、value(资金流向数值)
- ttsi: 交易精英趋向指标，字段：time(时间戳)、buyAccount(做多账户比例)、sellAccount(做空账户比例)
- ttmu: 交易精英多空平均持仓比例，字段：time(时间戳)、buyInterest(做多平均持仓比例)、sellInterest(做空平均持仓比例)
- position: 持仓量，字段：time(时间戳)、open(开)、high(高)、low(低)、close(收)
- lsur: 多空持仓人数比，字段：time(时间戳)、sellAccount(卖数量)、buyAccount(买数量)、ratios(多空比例)
- tvolume: 交易量，字段：time(时间戳)、openInterest(合约总量)、volume(成交量)
- ftbs: 合约主动买入卖出，字段：time(时间戳)、buyVolume(买入成交量)、sellVolume(卖出成交量)
- basis: 合约基差，字段：time(时间戳)、basis(基差数值)、basisRate
- mlr: 杠杆多空比，字段：time(时间戳)、ratios(杠杆比数值)
- bsv: 币币主动买入/卖出情况，字段：time(时间戳)、buyVolume(主动买单成交量)、sellVolume(主动卖单成交量)
- fr: 资金费率，字段：fundingTime(当期资金费率时间)、time(数据获取时间戳)、fundingRate(资金费率)
- aibst: 买卖笔数，字段：timestamp(时间戳)、buyAccount(买单数量)、sellAccount(卖单数量)
- aili: 爆仓单统计，字段：timestamp(时间戳)、buySize(平空张数)、sellSize(平多张数)
- aiaggtrade: 聚合主力大单成交，字段：timestamp(时间戳)、key(交易对主键)、coin_type(币种主键)、trade_type(方向)等
Name
AccessKeyId
Type
string
Description
用户访问密钥ID
Name
SignatureNonce
Type
string
Description
签名随机数
Name
Timestamp
Type
string
Description
请求时间戳(秒)，有效期30秒
Name
Signature
Type
string
Description
使用 HmacSHA1 + Base64 生成的签名，请参考如何获取 API 认证参数

返回数据

Name
success
Type
boolean
Description
接口状态
Name
errorCode
Type
integer
Description
状态码
Name
error
Type
string
Description
错误提示信息
Name
data
Type
object
Description
返回数据
- Name
  list
  Type
  array
  Description
  交易对列表

请求

GET

/v2/indicatorKline/getTradingPair

curl -G https://open.aicoin.com/api/v2/indicatorKline/getTradingPair \
  -d "coinType=bitcoin" \
  -d "indicator_key=aiaggtrade" \
  -d "AccessKeyId=YOUR_ACCESS_KEY_ID" \
  -d "SignatureNonce=RANDOM_NONCE" \
  -d "Timestamp=CURRENT_TIMESTAMP" \
  -d "Signature=YOUR_SIGNATURE"

响应

{
  "success": true,
  "errorCode": 200,
  "error": "",
  "data": {
    "list": [
      [
        "btcusdt:okex",
        "btcusdt:okex"
      ]
    ]
  }
}

GET/v2/indicatorKline/dataRecords

指标K线数据

此接口用于获取指标K线数据，单次最多获取500条K线数据。

请求参数

Name
symbol
Type
string
Description
交易对，如 btcusdt:okex
Name
indicator_key
Type
string
Description
指标主键，如 fundflow
Name
size
Type
integer
Description
数据条数，范围：1-500
Name
open_time
Type
integer
Description
开盘时间，0：北京时间0点，8：北京时间8点（默认：0）
Name
period
Type
integer
Description
时间间隔，单位秒（如：900表示15min周期，14400秒表示4h周期）
Name
since
Type
integer
Description
开始时间（默认当前时间）
Name
AccessKeyId
Type
string
Description
用户访问密钥ID
Name
SignatureNonce
Type
string
Description
签名随机数
Name
Timestamp
Type
string
Description
请求时间戳(秒)，有效期30秒
Name
Signature
Type
string
Description
使用 HmacSHA1 + Base64 生成的签名，请参考如何获取 API 认证参数

返回数据

Name
success
Type
boolean
Description
接口状态
Name
errorCode
Type
integer
Description
状态码
Name
error
Type
string
Description
错误提示信息
Name
data
Type
object
Description
返回数据
- Name
  kline_data
  Type
  object
  Description
  K线数据
  Name
  mapping
  Type
  array
  Description
  K线数据相关字段
  Name
  list
  Type
  array
  Description
  K线数据列表
  Name
  request_state
  Type
  integer
  Description
  请求状态

请求

GET

/v2/indicatorKline/dataRecords

curl -G https://open.aicoin.com/api/v2/indicatorKline/dataRecords \
  -d "symbol=btcusdt:okex" \
  -d "indicator_key=aiaggtrade" \
  -d "period=900" \
  -d "AccessKeyId=YOUR_ACCESS_KEY_ID" \
  -d "SignatureNonce=RANDOM_NONCE" \
  -d "Timestamp=CURRENT_TIMESTAMP" \
  -d "Signature=YOUR_SIGNATURE"

响应

{
  "success": true,
  "errorCode": 200,
  "error": "",
  "data": {
    "kline_data": {
      "mapping": [
        "timestamp",
        "buyTurnover",
        "sellTurnover"
      ],
      "list": [
        [
          "1692688800",
          "102115751.81482554",
          "56985363.47174822"
        ]
      ],
      "request_state": 0
    }
  }
}

GET/v2/commonKline/dataRecords

获取K线数据

此接口用于获取K线数据，单次最多获取500条K线数据。

请求参数

Name
symbol
Type
string
Description
交易对，如交易对：btcusdt:okex，指数：i:ixic:nasdaq
Name
size
Type
integer
Description
数据条数，范围：1-500
Name
open_time
Type
integer
Description
开盘时间，0：北京时间0点，8：北京时间8点（默认：0）
Name
period
Type
integer
Description
时间间隔，单位秒（如：900 表示 15min周期，14400秒表示4h周期，可以查看一下Aicoin上面的周期，避免拿不到数据）
Name
since
Type
integer
Description
开始时间（默认当前时间）
Name
AccessKeyId
Type
string
Description
用户访问密钥ID
Name
SignatureNonce
Type
string
Description
签名随机数
Name
Timestamp
Type
string
Description
请求时间戳(秒)，有效期30秒
Name
Signature
Type
string
Description
使用 HmacSHA1 + Base64 生成的签名，请参考如何获取 API 认证参数

返回数据

Name
success
Type
boolean
Description
接口状态
Name
errorCode
Type
integer
Description
状态码
Name
error
Type
string
Description
错误提示信息
Name
data
Type
object
Description
返回数据
- Name
  kline_data
  Type
  array
  Description
  K线数据，每个数组元素包含：[时间(秒)、开盘价、最高价、最低价、收盘价、成交量]

请求

GET

/v2/commonKline/dataRecords

curl -G https://open.aicoin.com/api/v2/commonKline/dataRecords \
  -d "symbol=btcusdt:okex" \
  -d "period=900" \
  -d "AccessKeyId=YOUR_ACCESS_KEY_ID" \
  -d "SignatureNonce=RANDOM_NONCE" \
  -d "Timestamp=CURRENT_TIMESTAMP" \
  -d "Signature=YOUR_SIGNATURE"

响应

{
  "success": true,
  "errorCode": 200,
  "error": "",
  "data": {
    "kline_data": [
      [
        1539172800,
        6501.95,
        6515.58,
        6489.88,
        6490.2,
        721688
      ],
      [
        1539187200,
        6490.21,
        6549.8,
        6485,
        6532.19,
        704650
      ]
    ]
  }
}

GET/v2/market/hotTabCoins

获取热门标签币种列表

此接口用于获取热门标签下的币种列表数据。

请求参数

Name
key
Type
string
Description
标签类型，可选值:
- gamefi (GameFi)
- anonymous (匿名币)
- market (平台币)
- web (Web3.0)
- newcoin (新币)
- stable (稳定币)
- defi (Defi)
Name
currency
Type
string
Description
定价单位，可选值: cny 或 usd
Name
AccessKeyId
Type
string
Description
用户访问密钥ID
Name
SignatureNonce
Type
string
Description
签名随机数
Name
Timestamp
Type
string
Description
请求时间戳(秒)，有效期30秒
Name
Signature
Type
string
Description
使用 HmacSHA1 + Base64 生成的签名，请参考如何获取 API 认证参数

返回数据

Name
success
Type
boolean
Description
接口状态
Name
errorCode
Type
integer
Description
状态码
Name
error
Type
string
Description
错误提示信息
Name
data
Type
object
Description
返回数据
- Name
  list
  Type
  array
  Description
  币种列表
  Name
  key
  Type
  string
  Description
  币种主键
  Name
  logo
  Type
  string
  Description
  币种logo
  Name
  show
  Type
  string
  Description
  币种简称
  Name
  cn_name
  Type
  string
  Description
  币种中文名
  Name
  en_name
  Type
  string
  Description
  币种英文名
  Name
  price
  Type
  string
  Description
  币种价格
  Name
  vol24H
  Type
  string
  Description
  24小时成交量
  Name
  trade24H
  Type
  string
  Description
  24小时成交额
  Name
  degree24H
  Type
  string
  Description
  24小时涨跌幅

请求

GET

/v2/market/hotTabCoins

curl -G https://open.aicoin.com/api/v2/market/hotTabCoins \
  -d "key=newcoin" \
  -d "currency=cny" \
  -d "AccessKeyId=YOUR_ACCESS_KEY_ID" \
  -d "SignatureNonce=RANDOM_NONCE" \
  -d "Timestamp=CURRENT_TIMESTAMP" \
  -d "Signature=YOUR_SIGNATURE"

响应

{
  "success": true,
  "errorCode": 200,
  "error": "",
  "data": {
    "list": [
      {
        "key": "CAITOKEN",
        "logo": "https://static.aicoinstorge.com/coin/20180530/152767311568822.png?x-oss-process=image/resize,m_lfit,h_45,w_45,image/circle,r_21/format,png",
        "show": "CAI",
        "cn_name": "",
        "en_name": "CAI TOKEN", 
        "price": "0.0278",
        "vol24H": "10500000000",
        "trade24H": "21457158.638175",
        "degree24H": "0.72"
      }
    ]
  }
}

GET/v2/market/ticker

获取平台行情数据

此接口用于获取交易平台的行情数据，包括资金净流入等信息。

请求参数

Name
market_list
Type
string
Description
平台列表，用英文逗号连接，最多100个平台
Name
AccessKeyId
Type
string
Description
用户访问密钥ID
Name
SignatureNonce
Type
string
Description
签名随机数
Name
Timestamp
Type
string
Description
请求时间戳(秒)，有效期30秒
Name
Signature
Type
string
Description
使用 HmacSHA1 + Base64 生成的签名，请参考如何获取 API 认证参数

返回数据

Name
success
Type
boolean
Description
接口状态
Name
errorCode
Type
integer
Description
状态码
Name
error
Type
string
Description
错误提示信息
Name
data
Type
array
Description
返回数据
- Name
  market_key
  Type
  string
  Description
  平台主键
- Name
  fundNetInCny
  Type
  string
  Description
  净流入(人民币)，空字符串表示没有数据
- Name
  fundNetInUsd
  Type
  string
  Description
  净流入(美元)，空字符串表示没有数据

请求

GET

/v2/market/ticker

curl -G https://open.aicoin.com/api/v2/market/ticker \
  -d "market_list=okex,binance" \
  -d "AccessKeyId=YOUR_ACCESS_KEY_ID" \
  -d "SignatureNonce=RANDOM_NONCE" \
  -d "Timestamp=CURRENT_TIMESTAMP" \
  -d "Signature=YOUR_SIGNATURE"

响应

{
  "success": true,
  "errorCode": 200,
  "error": "",
  "data": [
    {
      "market_key": "okex",
      "fundNetInCny": "1000",
      "fundNetInUsd": "1000"
    }
  ]
}

GET/v2/market

获取所有平台

此接口用于获取所有交易平台的基本信息。

请求参数

Name
AccessKeyId
Type
string
Description
用户访问密钥ID
Name
SignatureNonce
Type
string
Description
签名随机数
Name
Timestamp
Type
string
Description
请求时间戳(秒)，有效期30秒
Name
Signature
Type
string
Description
使用 HmacSHA1 + Base64 生成的签名，请参考如何获取 API 认证参数

返回数据

Name
success
Type
boolean
Description
接口状态
Name
errorCode
Type
integer
Description
状态码
Name
error
Type
string
Description
错误提示信息
Name
data
Type
array
Description
返回数据
- Name
  key
  Type
  string
  Description
  平台主键
- Name
  en_name
  Type
  string
  Description
  平台英文名称
- Name
  cn_name
  Type
  string
  Description
  平台中文名称

请求

GET

/v2/market

curl -G https://open.aicoin.com/api/v2/market \
  -d "AccessKeyId=YOUR_ACCESS_KEY_ID" \
  -d "SignatureNonce=RANDOM_NONCE" \
  -d "Timestamp=CURRENT_TIMESTAMP" \
  -d "Signature=YOUR_SIGNATURE"

响应

{
  "success": true,
  "errorCode": 200,
  "error": "",
  "data": [
    {
      "key": "okex",
      "en_name": "OKEx",
      "cn_name": "欧易OKX"
    }
  ]
}