币币交易

币币交易信息

ENUM 定义

术语解释

base asset 指的是symbol的quantity（即数量）
quote asset 指的是symbol的price（即价格）

Symbol 状态

TRADING - 交易中
HALT - 终止
BREAK - 断开

订单状态

NEW - 新订单，暂无成交
PARTIALLY_FILLED - 部分成交
FILLED - 完全成交
CANCELED - 已取消
PENDING_CANCEL - 等待取消
REJECTED - 被拒绝

订单类型

LIMIT - 限价单
MARKET - 市价单

订单方向

BUY - 买单
SELL - 卖单

订单时效类型

k线/烛线图区间

m -> 分钟; h -> 小时; d -> 天; w -> 周; M -> 月

访问接口频率请参见BrokerInfo接口中的：

频率限制类型 (rateLimitType)

REQUESTS_WEIGHT
ORDERS

频率限制区间

SECOND
MINUTE
DAY

比如：

{
      "rateLimitType": "ORDERS",
      "interval": "SECOND",
      "limit": 20
    }

这表示每秒的下单频率限制为20。

公共

安全类型: None

公共下方的端点不需要API-Key或者签名就能自由访问

测试连接

GET https://api.wenxpro.com/openapi/v1/ping

测试REST API的连接。

{}

Weight: 0

服务器时间

GET https://api.wenxpro.com/openapi/v1/time

测试连接并获取当前服务器的时间。

{"serverTime": 1538323200000}

Weight: 0

Broker信息

GET https://api.wenxpro.com/openapi/v1/brokerInfo

当前broker交易规则和symbol信息

Query Parameters

Name

Type

Description

type

string

交易类型，支持的类型现为token（币币）、options（期权）、contracts（合约）。如果没有发送此参数，所有交易类型的symbol信息都会被返回。

{
  "timezone": "UTC",
  "serverTime": 1538323200000,
  "rateLimits": [{
      "rateLimitType": "REQUESTS_WEIGHT",
      "interval": "MINUTE",
      "limit": 1500
    },
    {
      "rateLimitType": "ORDERS",
      "interval": "SECOND",
      "limit": 20
    },
    {
      "rateLimitType": "ORDERS",
      "interval": "DAY",
      "limit": 350000
    }
  ],
  "brokerFilters":[],
  "symbols": [{
    "symbol": "ETHBTC",
    "status": "TRADING",
    "baseAsset": "ETH",
    "baseAssetPrecision": "0.001",
    "quoteAsset": "BTC",
    "quotePrecision": "0.01",
    "icebergAllowed": false,
    "filters": [{
      "filterType": "PRICE_FILTER",
      "minPrice": "0.00000100",
      "maxPrice": "100000.00000000",
      "tickSize": "0.00000100"
    }, {
      "filterType": "LOT_SIZE",
      "minQty": "0.00100000",
      "maxQty": "100000.00000000",
      "stepSize": "0.00100000"
    }, {
      "filterType": "MIN_NOTIONAL",
      "minNotional": "0.00100000"
    }]
  }]
}

Response:

名称

类型

例子

描述

timezone

string

UTC

服务器所在时区

serverTime

long

1554887652929

当前服务器时间（Unix Timestamp格式，ms毫秒级)

在 symbols对应的信息组里，所有当前正在交易的币对信息将会被返回：

名称

类型

例子

描述

symbol

string

BTC0308CS3900

币对名称

status

string

TRADING

币对当前状态

baseAsset

string

BTC0308CS3900

币对的名称

baseAssetPrecision

float

0.001

币对交易张数精度

quoteAsset

string

BUSDT

计价的货币

quoteAssetPrecision

float

0.01

币对交易价格的精度

icebergAllowed

string

false

是否支持“冰山订单”

在symbols里面的filters对应的信息组里：

名称

类型

例子

描述

filterType

string

PRICE_FILTER

Filter类型

minPrice

float

0.001

币对最小交易价格

maxPrice

float

100000.00000000

币对最大交易价格

tickSize

float

0.001

币对交易价格精度

minQty

float

0.01

币对最小交易张数

maxQty

float

100000.00000000

币对最大交易张数

stepSize

float

0.001

币对交易张数精度

minNotional

float

1

订单金额精度 (数量 * 价格)

Pairs交易对

GET https://api.wenxpro.com/openapi/v1/pairs

返回当前正在交易的所有现货交易对

[
    {
        "symbol": "BTCUSDT",
        "quoteToken": "USDT",
        "baseToken": "BTC"
    },...
]

行情

安全类型: None

行情下方的端点不需要API-Key或者签名就能自由访问

订单簿

GET https://api.wenxpro.com/openapi/quote/v1/depth

这个端点返回市场订单簿深度信息。该端点300毫秒更新一次。

Query Parameters

Name

Type

Description

symbol

string

Symbol名称 E.g. BTCUSDT

limit

integer

默认100; 最大 100.

{
  "bids": [
    [
      "3.90000000",   // 价格
      "431.00000000"  // 数量
    ],
    [
      "4.00000000",
      "431.00000000"
    ]
  ],
  "asks": [
    [
      "4.00000200",  // 价格
      "12.00000000"  // 数量
    ],
    [
      "5.10000000",
      "28.00000000"
    ]
  ]
}

Response:

名称

类型

例子

描述

time

long

1550829103981

当前时间（Unix Timestamp，毫秒ms）

bids

list

(如下)

所有bid的价格和数量信息，最优bid价格由上到下排列。

asks

list

(如下)

所有ask的价格和数量信息，最优ask价格由上到下排列。

bids和asks所对应的信息组代表了订单簿的所有价格以及价格对应数量的信息，由最优价格从上到下排列。

名称

类型

例子

描述

''

float

123.10

价格

''

float

300

当前价格对应的数量

合并订单簿（推荐）

GET https://api.wenxpro.com/openapi/quote/v1/depth/merged

这个端点返回市场订单簿深度信息(非全量)。该端点300毫秒更新一次。

Query Parameters

Name

Type

Description

symbol

string

Symbol名称 E.g. BTCUSDT

limit

integer

默认40; 最大 40.

{
  "bids": [
    [
      "3.90000000",   // 价格
      "431.00000000"  // 数量
    ],
    [
      "4.00000000",
      "431.00000000"
    ]
  ],
  "asks": [
    [
      "4.00000200",  // 价格
      "12.00000000"  // 数量
    ],
    [
      "5.10000000",
      "28.00000000"
    ]
  ]
}

Response:

名称

类型

例子

描述

time

long

1550829103981

当前时间（Unix Timestamp，毫秒ms）

bids

list

(如下)

所有bid的价格和数量信息，最优bid价格由上到下排列。

asks

list

(如下)

所有ask的价格和数量信息，最优ask价格由上到下排列。

bids和asks所对应的信息组代表了订单簿的所有价格以及价格对应数量的信息，由最优价格从上到下排列。

名称

类型

例子

描述

''

float

123.10

价格

''

float

300

当前价格对应的数量

K线/烛线图数据

GET https://api.wenxpro.com/openapi/quote/v1/klines

Symbol的k线/烛线图数据 K线会根据开盘时间而辨别。

Query Parameters

Name

Type

Description

symbol

string

Symbol名称 E.g. BTCUSDT

interval

string

K线图区间。可识别发送的值为： 1m,5m,15m,30m,1h,1d,1w,1M（m=分钟，h=小时,d=天，w=星期，M=月）

startTime

number

开始时间戳(毫秒ms)

endTime

number

结束时间戳(毫秒ms)

limit

integer

默认 500; 最大 1000

[
  [
    1499040000000,      // Open time
    "0.01634790",       // Open
    "0.80000000",       // High
    "0.01575800",       // Low
    "0.01577100",       // Close
    "148976.11427815",  // Volume
    1499644799999,      // Close time
    "2434.19055334",    // Quote asset volume
    308,                // Number of trades
    "1756.87402397",    // Taker buy base asset volume
    "28.46694368"       // Taker buy quote asset volume
  ]
]

Response:

名称

类型

例子

描述

''

long

1538728740000

开始时间戳，毫秒（ms）

''

float

36.00000'

开盘价

''

float

36.00000

最高价

''

float

36.00000

最低价

''

float

36.00000

收盘价

''

float

148976.11427815

交易金额

''

long

1538728740000

停止时间戳，毫秒（ms）

''

float

2434.19055334

交易数量（张数）

''

integer

308

已成交数量（张数）

''

float

1756.87402397

买方购买金额

''

float

28.46694368

买方购买数量（张数）

如果startTime和endTime没有发送，只有最新的K线会被返回

24小时ticker价格变化数据

GET https://api.wenxpro.com/openapi/quote/v1/ticker/24hr

24小时价格变化数据。注意如果没有发送symbol，会返回很多数据。

Path Parameters

Name

Type

Description

symbol

string

Symbol 名称 E.g. BTCUSDT

## Single ticker 
{
  "time": 1538725500422,
  "symbol": "ETHBTC",
  "bestBidPrice": "4.00000200",
  "bestAskPrice": "4.00000200",
  "lastPrice": "4.00000200",
  "openPrice": "99.00000000",
  "highPrice": "100.00000000",
  "lowPrice": "0.10000000",
  "volume": "8913.30000000"
}
## Multiple ticker info when symbol is omiited
[
  {
    "time": 1538725500422,
    "symbol": "ETHBTC",
    "lastPrice": "4.00000200",
    "openPrice": "99.00000000",
    "highPrice": "100.00000000",
    "lowPrice": "0.10000000",
    "volume": "8913.30000000"
 },...
]

Response:

名称

类型

例子

描述

time

long

1538728740000

开始时间戳

symbol

string

ETHBTC

Symbol 名称

bestBidPrice

float

4.000002000

最佳买价

bestAskPrice

float

4.000002000

最佳卖价

lastPrice

float

4.000002000

Symbol价格

GET https://api.wenxpro.com/openapi/quote/v1/ticker/price

单个或多个symbol的最新价。

Query Parameters

Name

Type

Description

symbol

string

Symbol 名称 E.g. BTCUSDT

## Single ticker 
{
  "price": "4.00000200"
}
## Multiple ticker info when symbol is omiited
[
  {
    "symbol": "LTCBTC",
    "price": "4.00000200"
  },
  {
    "symbol": "ETHBTC",
    "price": "0.07946600"
  },...
]

Response:

名称

类型

例子

描述

symbol

string

ETHBTC

Symbol 名称

price

float

4.0000200

Symbol 价格

如果symbol没有发送，所有symbol的最新价都会被返回。

Symbol最佳订单簿价格

GET https://api.wenxpro.com/openapi/quote/v1/ticker/bookTicker

单个或者多个symbol的最佳买单卖单价格。

Path Parameters

Name

Type

Description

symbol

string

Symbol 名称 E.g. BTCUSDT

## Single ticker 
{
  "symbol": "LTCBTC",
  "bidPrice": "4.00000000",
  "bidQty": "431.00000000",
  "askPrice": "4.00000200",
  "askQty": "9.00000000"
}
## Multiple ticker info when symbol is omiited
[
  {
    "symbol": "LTCBTC",
    "bidPrice": "4.00000000",
    "bidQty": "431.00000000",
    "askPrice": "4.00000200",
    "askQty": "9.00000000"
  },
  {
    "symbol": "ETHBTC",
    "bidPrice": "0.07946700",
    "bidQty": "9.00000000",
    "askPrice": "100000.00000000",
    "askQty": "1000.00000000"
  },...
]

Response:

名称

类型

例子

描述

symbol

string

ETHBTC

Symbol 名称

bidPrice

float

4.0000000

最佳买价

bidQty

float

431

最佳买价数量

askPrice

float

4.0000200

最佳卖价

askQty

float

9

最佳卖价数量

如果symbol没有被发送，所有symbol的最佳订单簿价格都会被返回。

交易

安全类型： USER_DATA/TRADE

交易下方的端点需要~~签名和API-Key验证~~

创建新订单

POST https://api.wenxpro.com/openapi/v1/order

发送一个新的订单

Query Parameters

Name

Type

Description

symbol

string

Symbol名称 E.g. BTCUSDT

quantity

number

订单数量，对于市价买单（MARKET BUY）订单，quantity=amount

side

string

订单方向, BUY/SELL

type

string

订单类型, LIMIT/MARKET/LIMIT_MAKER

timeInForce

string

订单时间指令（Time in Force）。可能出现的值为：GTC（Good Till Canceled，一直有效），FOK（Fill or Kill，全部成交或者取消），IOC（Immediate or Cancel，立即成交或者取消）

price

number

订单价格，对于LIMIT 订单必需发送

newClientOrderId

string

特殊订单ID，用户自己生成 E.g. 12094ahsihsiad

Headers

Name

Type

Description

X-BH-APIKEY

string

你的API-Key

Request Body

Name

Type

Description

signature

string

这个端点需要签名验证

timestamp

integer

当前时间戳（毫秒）

recvWindow

integer

当前请求的RecvWindow

{
    'symbol': 'LXTUSDT', 
    'orderId': '494736827050147840', 
    'clientOrderId': '157371322565051',
    'transactTime': '1573713225668', 
    'price': '0.005452', 
    'origQty': '110', 
    'executedQty': '0', 
    'status': 'NEW',
    'timeInForce': 'GTC', 
    'type': 'LIMIT', 
    'side': 'SELL'

Response:

名称

类型

例子

描

orderId

integer

891

订单ID（系统生成）

clientOrderId

integer

213443

订单ID（自己发送的）

symbol

string

BTCUSDT

币对名称

transactTime

integer

1273774892913

订单创建时间

price

float

4765.29

订单价格

origQty

float

1.01

订单数量

executedQty

float

1.01

已经成交订单数量

avgPrice

float

4754.24

订单已经成交的平均价格

type

string

LIMIT

订单类型。可能出现的值只能为:LIMIT(限价)和MARKET（市价）

side

string

BUY

订单方向。可能出现的值只能为：BUY（买入做多）和 SELL（卖出做空）

status

string

NEW

订单状态。可能出现的值为：NEW(新订单，无成交)、PARTIALLY_FILLED（部分成交）、FILLED（全部成交）、CANCELED（已取消）和REJECTED（订单被拒绝）.

timeInForce

string

GTC

订单时间指令（Time in Force）。可能出现的值为：GTC（Good Till Canceled，一直有效），FOK（Fill or Kill，全部成交或者取消），IOC（Immediate or Cancel，立即成交或者取消）.

Weight: 1

创建新测试订单

POST https://api.wenxpro.com/openapi/v1/order/test

用signature和recvWindow测试生成新订单。创建和验证一个新订单但是不送入撮合引擎。

Query Parameters

Name

Type

Description

symbol

string

Symbol 名称 E.g. BTCUSDT

quantity

number

订单数量

side

string

订单方向, BUY/SELL

type

string

订单类型, LIMIT/MARKET/LIMIT_MAKER

timeInForce

string

price

number

订单价格，对于LIMIT订单必须发送

newClientOrderId

string

特殊订单ID，用户自己生成 E.g. 12094ahsihsiad

Headers

Name

Type

Description

X-BH-APIKEY

string

你的API-Key

Request Body

Name

Type

Description

signature

string

这个端点需要签名验证

timestamp

integer

当前时间戳（毫秒）

recvWindow

integer

当前请求的RecvWindow

{}

Weight: 1

订单查询

GET https://api.wenxpro.com/openapi/v1/order

查询订单状态

Query Parameters

Name

Type

Description

orderId

string

订单Id E.g. 507904211109878016

origClientOrderId

string

特殊订单Id（用户自己生成）E.g. 12094ahsihsiad

Headers

Name

Type

Description

X-BH-APIKEY

string

你的API-Key

Request Body

Name

Type

Description

signature

string

这个端点需要签名验证

timestamp

integer

当前时间戳（毫秒）

recvWindow

integer

当前请求的RecvWindow

{
    'orderId': '499890200602846976', 
    'clientOrderId': '157432755564968', 
    'exchangeId': '301', 
    'symbol': 'BHTUSDT', 
    'price': '0.01', 
    'origQty': '50', 
    'executedQty': '0', 
    'cummulativeQuoteQty': '0', 
    'avgPrice': '0', 
    'status': 'NEW', 
    'timeInForce': 'GTC', 
    'type': 'LIMIT', 
    'side': 'BUY', 
    'stopPrice': '0.0', 
    'icebergQty': '0.0', 
    'time': '1574327555669', 
    'updateTime': '0', 
    'isWorking': true
    }

Response:

名称

类型

例子

描述

orderId

integer

891

订单ID（系统生成）

clientOrderId

integer

213443

订单ID（自己发送的）

symbol

string

BTCUSDT

币对名称

price

float

4765.29

订单价格

origQty

float

1.01

订单数量

executedQty

float

1.01

已经成交订单数量

avgPrice

float

4754.24

订单已经成交的平均价格

type

string

LIMIT

订单类型。可能出现的值只能为:LIMIT(限价)和MARKET（市价）

side

string

BUY

订单方向。可能出现的值只能为：BUY（买入做多）和 SELL（卖出做空）

status

string

NEW

订单状态。可能出现的值为：NEW(新订单，无成交)、PARTIALLY_FILLED（部分成交）、FILLED（全部成交）、CANCELED（已取消）和REJECTED（订单被拒绝）.

timeInForce

string

GTC

fees

订单产生的手续费

在fees里:

名称

类型

例子

描述

feeToken

string

USDT

手续费计价单位

fee

float

0

实际费用值

Weight: 1
单一 orderId 或者 origClientOrderId 必须被发送。
对于某些历史数据 cummulativeQuoteQty 可能会 < 0, 这说明数据当前不可用。

撤销订单

DELETE https://api.wenxpro.com/openapi/v1/order

取消当前正在交易的订单

Query Parameters

Name

Type

Description

orderId

string

订单Id E.g. 507904211109878016

origClientOrderId

string

特殊订单Id（用户自己生成）E.g. 12094ahsihsiad

Headers

Name

Type

Description

X-BH-APIKEY

string

你的API-Key

Request Body

Name

Type

Description

signature

string

这个端点需要签名验证

timestamp

integer

当前时间戳（毫秒）

recvWindow

integer

当前请求的RecvWindow

{
    'exchangeId': '301', 
    'symbol': 'BHTUSDT', 
    'clientOrderId': '0', 
    'orderId': '499890200602846976', 
    'status': 'CANCELED'
    }

名称

类型

例子

描述

orderId

integer

713637304

订单ID（系统生成

clientOrderId

string

213443

订单ID（自己发送的）

symbol

string

BHTUSDT

币对名称

status

string

NEW

订单状态。可能出现的值为：NEW(新订单，无成交)、PARTIALLY_FILLED（部分成交）、FILLED（全部成交）、CANCELED（已取消）和REJECTED（订单被拒绝）

Weight: 1
单一 orderId 或者 clientOrderId必须被发送。

当前订单

GET https://api.wenxpro.com/openapi/v1/openOrders

获取当前单个或者多个symbol的当前订单。注意如果没有发送symbol，会返回很多数据。

Query Parameters

Name

Type

Description

symbol

string

Symbol 名称 E.g. BTCUSDT

orderId

string

订单Id E.g. 507904211109878016

limit

integer

默认 500; 最大 1000

Headers

Name

Type

Description

X-BH-APIKEY

string

你的API-Key验证

Request Body

Name

Type

Description

signature

string

这个端点需要签名验证

timestamp

integer

当前时间戳（毫秒）

recvWindow

integer

当前请求的RecvWindow

[
    {
        'orderId': '499902955766523648', 
        'clientOrderId': '157432907618453', 
        'exchangeId': '301', 
        'symbol': 'BHTUSDT', 
        'price': '0.01', 
        'origQty': '50', 
        'executedQty': '0', 
        'cummulativeQuoteQty': '0', 
        'avgPrice': '0', 
        'status': 'NEW', 
        'timeInForce': 'GTC', 
        'type': 'LIMIT', 
        'side': 'BUY', 
        'stopPrice': '0.0', 
        'icebergQty': '0.0', 
        'time': '1574329076202', 
        'updateTime': '0', 
        'isWorking': true
        },...
    ]

Response:

名称

类型

例子

描述

orderId

integer

891

订单ID（系统生成）

clientOrderId

integer

213443

订单ID（自己发送的）

symbol

string

BTCUSDT

币对名称

price

float

4765.29

订单价格

origQty

float

1.01

订单数量

executedQty

float

1.01

已经成交订单数量

avgPrice

float

4754.24

订单已经成交的平均价格

type

string

LIMIT

订单类型。可能出现的值只能为:LIMIT(限价)和MARKET（市价）

side

string

BUY

订单方向。可能出现的值只能为：BUY（买入做多）和 SELL（卖出做空）

status

string

NEW

订单状态。可能出现的值为：NEW(新订单，无成交)、PARTIALLY_FILLED（部分成交）、FILLED（全部成交）、CANCELED（已取消）和REJECTED（订单被拒绝）.

timeInForce

string

GTC

fees

订单产生的手续费

在fees里:

名称

类型

例子

描述

feeToken

string

USDT

手续费计价单位

fee

float

0

实际费用值

Weight: 1
如果orderId设定好了，会筛选订单小于orderId的。否则会返回最近的订单信息。

历史订单

GET https://api.wenxpro.com/openapi/v1/historyOrders

获取当前账户的历史订单。注意如果没有发送symbol，会返回很多数据。

Query Parameters

Name

Type

Description

symbol

string

Symbol名称 E.g. BTCUSDT

orderId

string

订单Id E.g. 507904211109878016

startTime

integer

开始时间戳(毫秒ms)

endTime

integer

结束时间戳(毫秒ms)

limit

integer

默认500; 最大1000

Headers

Name

Type

Description

X-BH-APIKEY

string

你的API-Key

Request Body

Name

Type

Description

signature

string

这个端点需要签名验证

timestamp

integer

当前时间戳（毫秒）

recvWindow

integer

当前请求的RecvWindow

[
    {
        'orderId': '499890200602846976', 
        'clientOrderId': '157432755564968', 
        'exchangeId': '301', 
        'symbol': 'BHTUSDT', 
        'price': '0.01', 
        'origQty': '50', 
        'executedQty': '0', 
        'cummulativeQuoteQty': '0', 
        'avgPrice': '0', 
        'status': 'CANCELED', 
        'timeInForce': 'GTC', 
        'type': 'LIMIT', 
        'side': 'BUY', 
        'stopPrice': '0.0', 
        'icebergQty': '0.0', 
        'time': '1574327555669', 
        'updateTime': '0', 
        'isWorking': true
        },...
    ]

Response:

名称

类型

例子

描述

orderId

integer

891

订单ID（系统生成）

clientOrderId

integer

213443

订单ID（自己发送的）

symbol

string

BTCUSDT

币对名称

price

float

4765.29

订单价格

origQty

float

1.01

订单数量

executedQty

float

1.01

已经成交订单数量

avgPrice

float

4754.24

订单已经成交的平均价格

type

string

LIMIT

订单类型。可能出现的值只能为:LIMIT(限价)和MARKET（市价）

side

string

BUY

订单方向。可能出现的值只能为：BUY（买入做多）和 SELL（卖出做空）

status

string

NEW

订单状态。可能出现的值为：FILLED（全部成交）、CANCELED（已取消）和REJECTED（订单被拒绝）.

timeInForce

string

GTC

fees

订单产生的手续费

在fees里:

名称

类型

例子

描述

feeToken

string

USDT

手续费计价单位

fee

float

0

实际费用值

Weight: 5
如果orderId设定好了，会筛选订单小于orderId的。否则会返回最近的订单信息。

交易记录

GET https://api.wenxpro.com/openapi/v1/myTrades

获取当前账户历史成交记录

Query Parameters

Name

Type

Description

symbol

string

Symbol名称 E.g. BTCUSDT

startTime

integer

开始时间戳(毫秒ms)

endTime

integer

结束时间戳 (毫秒ms)

fromId

integer

从此Trade Id 开始查询

toId

integer

以此Trade Id为终点

limit

integer

默认 500; 最大 1000

Headers

Name

Type

Description

X-BH-APIKEY

string

你的API-Key

Request Body

Name

Type

Description

signature

string

这个端点需要签名验证

timestamp

integer

当前时间戳（毫秒）

recvWindow

integer

当前请求的RecvWindow

[
  {
    "symbol": "ETHBTC",
    "id": 28457,
    "orderId": 100234,
    "price": "4.00000100",
    "qty": "12.00000000",
    "commission": "10.10000000",
    "commissionAsset": "ETH",
    "time": 1499865549590,
    "isBuyer": true,
    "isMaker": false
  },...
]

Response:

名称

类型

例子

描述

symbol

string

ETHBTC

币种名称(交易对)

id

integer

28457

交易ID

orderId

integer

100234

订单ID

price

integer

4.001

交易时间戳

qty

float

12

交易数量

commission

float

10.10000

交易手续费

commissionAsset

string

ETH

交易手续费币种

time

number

1499865549590

交易时间戳

isBuyer

bool

true

true= Buyer false= Seller

isMaker

bool

false

true=Maker false=Taker

Weight: 5
如果只有fromId，会返回订单号小于fromId的，倒序排列。
如果只有toId，会返回订单号小于toId的，升序排列。
如果同时有fromId和toId, 会返回订单号在fromId和toId的，倒序排列。
如果fromId和toId都没有，会返回最新的成交记录，倒序排列。

账户

安全类型： USER_DATA/TRADE

账户下方的端点需要~~签名和API-Key验证~~

账户信息

GET https://api.wenxpro.com/openapi/v1/account

获取当前账户信息 (余额)

Headers

Name

Type

Description

X-BH-APIKEY

string

你的API-Key

Request Body

Name

Type

Description

signature

string

这个端点需要签名验证

timestamp

integer

当前时间戳（毫秒）

recvWindow

integer

当前请求的RecvWindow

{
    'balances': 
        [
            {
                'asset': 'ALGO', 
                'free': '0', 
                'locked': '0'
                }, 
            {
                'asset': 'BHT', 
                'free': '0', 
                'locked': '0'
                },...
        ]
    }

Response:

Name

type

example

description

balances

float

展示余额具体数据

In the balances field:

名称

类型

例子

描述

asset

string

USDT

币种名称

free

float

600.0

可用

locked

float

100.0

冻结

Weight: 5

账户存款记录

GET https://api.wenxpro.com/openapi/v1/depositOrders

获取当前账户的存款记录

Query Parameters

Name

Type

Description

startTime

integer

开始时间(毫秒ms)

endTime

integer

结束时间 (毫秒ms)

fromId

string

从此Order Id开始查询。默认查询最新的存款记录。

limit

integer

默认 500; 最大 1000

Headers

Name

Type

Description

X-BH-APIKEY

string

你的API-Key

Request Body

Name

Type

Description

signature

string

这个端点需要签名验证

timestamp

integer

当前时间戳（毫秒）

recvWindow

integer

当前请求的RecvWindow

[
    {
        'time': '1565769575929', 
        'orderId': '428100569859739648', 
        'token': 'USDT', 
        'address': '', 
        'addressTag': '', 
        'fromAddress': '', 
        'fromAddressTag': '', 
        'quantity': '1100'
        },...
    ]

Response:

名称

类型

例子

描述

time

float

1565769575929

存款时间戳

orderId

integer

428100569859739648

订单ID

token

string

USDT

Token 名称

address

string

你的token 地址

addressTag

string

你的token 地址 tag

fromAddress

string

转账发起方 token 地址

fromAddressTag

string

转账发起方 token 地址 tag

quantity

float

1100

转账数量

Weight: 5
如果orderId设定好了，会筛选订单小于orderId的。否则会返回最近的订单信息。

账户提币记录

GET https://api.wenxpro.com/openapi/v1/withdrawalOrders

Query Parameters

Name

Type

Description

token

string

Token名称。默认全部

startTime

number

开始时间戳（毫秒）

endTime

number

结束时间戳（毫秒）

fromId

number

从哪个OrderId起开始抓取。默认抓取最新的存款记录。

limit

integer

默认 500; 最大 1000

Headers

Name

Type

Description

X-BH-APIKEY

string

你的API Key

Request Body

Name

Type

Description

signature

string

这个端点需要签名验证

timestamp

integer

当前时间戳（毫秒）

recvWindow

integer

当前请求的RecvWindow

[
    {
        "time":"1536232111669",
        "orderId":"90161227158286336",
        "accountId":"517256161325920",
        "tokenId":"BHC",
        "tokenName":"BHC",
        "address":"0x815bF1c3cc0f49b8FC66B21A7e48fCb476051209",
        "addressExt":"address tag",
        "quantity":"14", // 提币金额
        "arriveQuantity":"14", // 到账金额
        "statusCode":"PROCESSING_STATUS",
        "status":3,
        "txid":"",
        "txidUrl":"",
        "walletHandleTime":"1536232111669",
        "feeTokenId":"BHC",
        "feeTokenName":"BHC",
        "fee":"0.1",
        "requiredConfirmNum":0, // 要求确认数
        "confirmNum":0, // 确认数
        "kernelId":"", // BEAM 和 GRIN 独有
        "isInternalTransfer": false // 是否内部转账
    },
    {
        "time":"1536053746220",
        "orderId":"762522731831527",
        "accountId":"517256161325920",
        "tokenId":"BHC",
        "tokenName":"BHC",
        "address":"fdfasdfeqfas12323542rgfer54135123",
        "addressExt":"EOS tag",
        "quantity":"",
        "arriveQuantity":"10",
        "statusCode":"BROKER_AUDITING_STATUS",
        "status":"2",
        "txid":"",
        "txidUrl":"",
        "walletHandleTime":"1536232111669",
        "feeTokenId":"BHC",
        "feeTokenName":"BHC",
        "fee":"0.1",
        "requiredConfirmNum":0, // 要求确认数
        "confirmNum":0, // 确认数
        "kernelId":"", // BEAM 和 GRIN 独有
        "isInternalTransfer": false // 是否内部转账
    }
]

状态

状态码

描述

BROKER_AUDITING_STATUS

券商审核中

BROKER_REJECT_STATUS

券商审核拒绝

AUDITING_STATUS

平台审核中

AUDIT_REJECT_STATUS

平台审核拒绝

PROCESSING_STATUS

钱包处理中

WITHDRAWAL_SUCCESS_STATUS

提币成功

WITHDRAWAL_FAILURE_STATUS

提币失败

BLOCK_MINING_STATUS

区块打包中

获取账户提笔订单信息

GET https://api.wenxpro.com/openapi/v1/withdraw/detail

获取提币订单信息

Query Parameters

Name

Type

Description

orderId

number

orderId和clientOrderId两者必须有一个有值

clientOrderId

string

orderId和clientOrderId两者必须有一个有值

Headers

Name

Type

Description

X-BH-APIKEY

string

你的API Key

Request Body

Name

Type

Description

signature

string

这个端点需要签名验证

timestamp

integer

当前时间戳（毫秒）

recvWindow

integer

当前请求的RecvWindow

{
    "time":"1536232111669",
    "orderId":"90161227158286336",
    "accountId":"517256161325920",
    "tokenId":"BHC",
    "tokenName":"BHC",
    "address":"0x815bF1c3cc0f49b8FC66B21A7e48fCb476051209",
    "addressExt":"address tag",
    "quantity":"14", // 提币金额
    "arriveQuantity":"14", // 到账金额
    "statusCode":"PROCESSING_STATUS",
    "status":3,
    "txid":"",
    "txidUrl":"",
    "walletHandleTime":"1536232111669",
    "feeTokenId":"BHC",
    "feeTokenName":"BHC",
    "fee":"0.1",
    "requiredConfirmNum":0, // 要求确认数
    "confirmNum":0, // 确认数
    "kernelId":"", // BEAM 和 GRIN 独有
    "isInternalTransfer": false // 是否内部转账
}

获取当前子账户列表

POST https://api.wenxpro.com/openapi/v1/subAccount/query

获取你的主账户和子账户信息

Headers

Name

Type

Description

X-BH-APIKEY

string

你的 API Key

Request Body

Name

Type

Description

signature

string

这个端点需要签名验证

timestamp

integer

当前时间戳（毫秒）

RecvWindow

integer

当前请求的RecvWindow

[
    {
        "accountId": "122216245228131",
        "accountName": "",
        "accountType": 1,
        "accountIndex": 0 // main-account: 0, sub-account: 1
    },
    {
        "accountId": "482694560475091200",
        "accountName": "createSubAccountByCurl", // sub-account name
        "accountType": 1, // sub-account type 1. token trading 3. contract trading
        "accountIndex": 1
    },
    {
        "accountId": "422446415267060992",
        "accountName": "",
        "accountType": 3,
        "accountIndex": 0
    },
    {
        "accountId": "482711469199298816",
        "accountName": "createSubAccountByCurl",
        "accountType": 3,
        "accountIndex": 1
    },
]

Response:

Name

Type

Example

Description

accountId

integer

YES

主账户或者子账户的 AccountId

accountName

string

YES

账户名称

accountType

integer

YES

账户类型: 1. 币币账户 2. 期权账户 3. 合约账户

accountIndex

integer

YES

0: 主账户; >0 (1或更大): 子账户

Weight: 5

账户内部转账

POST https://api.wenxpro.com/openapi/v1/transfer

用该端点可进行内部账户之间的转账

Query Parameters

Name

Type

Description

fromAccountType

string

源账户类型, 1 钱包(币币)账户 2 期权账户 3 合约账户

fromAccountIndex

string

子账户index, 主账户Api调用时候有用，从子账户列表接口/subAccount/query获取

toAccountType

integer

目标账户类型, 1 钱包(币币)账户 2 期权账户 3 合约账户

toAccountIndex

integer

子账户index, 主账户Api调用时候有用，从子账户列表接口/subAccount/query获取

tokenId

string

Token Id. 例： BTC, ETH, XRP

amount

integer

转账的Token数量

Headers

Name

Type

Description

X-BH-APIKEY

string

你的 API key

Request Body

Name

Type

Description

signature

string

这个端点需要签名验证

timestamp

integer

当前时间戳（毫秒）

recvWindow

integer

当前请求的RecvWindow

{
    "success":"true" // success

说明

1、转账账户和收款账户的其中一方，必须是主账户(钱包账户)

2、主账户Api可以从钱包账户向其他账户(包括子账户)转账，也可以从其他账户向钱包账户转账

3、子账户Api调用的时候只能从当前子账户向主账户(钱包账户)转账，所以fromAccountType\fromAccountIndex\toAccountType\toAccountIndex不用填

Weight: 1

提币

POST https://api.wenxpro.com/openapi/v1/withdraw

提币

Query Parameters

Name

Type

Description

tokenId

string

TokenId。E.g. BTC、ETH..

clientOrderId

string

券商端生成的订单id，防止重复提币

address

string

提币地址(注意：提现地址必须是在PC端或者APP端维护在常用地址列表里面的地址)

addressExt

string

EOS tag

withdrawQuantity

string

提币数量

chainType

string

chain type, USDT的chainType分别是OMNI ERC20 TRC20，默认OMNI

Headers

Name

Type

Description

X-BH-APIKEY

string

你的API Key

Request Body

Name

Type

Description

signature

string

这个端点需要签名验证

timestamp

integer

Unix时间戳（毫秒）

recvWindow

integer

当前请求的RecvWindow

  {
        "status": 0,
        "success": true,
        "needBrokerAudit": false, // 是否需要券商审核
        "orderId": "423885103582776064" // 提币成功订单id
    }

查询流水记录

GET https://api.wenxpro.com/openapi/v1/balance_flow

查询某个指定账户的流水记录

Query Parameters

Name

Type

Description

accountType

integer

账户对应的account_type，1 钱包(币币)账户 2 期权账户 3 合约账户

accountIndex

integer

子账户index, 主账户Api调用时候有用，从子账户列表接口/subAccount/query获取

tokenId

string

Token Id. 例： BTC, ETH, XRP

fromFlowId

integer

起始FlowId

endFlowId

integer

结束FlowId

startTime

integer

开始时间戳（毫秒）

endTime

integer

结束时间戳（毫秒）

limit

integer

返回数量（默认500，最大500）

Headers

Name

Type

Description

X-BH-APIKEY

string

你的 API key

Request Body

Name

Type

Description

signature

string

这个端点需要签名验证

timestamp

integer

当前时间戳（毫秒）

recvWindow

integer

当前请求的RecvWindow

[
    {
        "id": "539870570957903104",
        "accountId": "122216245228131",
        "tokenId": "BTC",
        "tokenName": "BTC",
        "flowTypeValue": 51, // balance flow type
        "flowType": "USER_ACCOUNT_TRANSFER", // balance flow type name
        "flowName": "Transfer", // balance flow type Explanation
        "change": "-12.5", // change
        "total": "379.624059937852365", // total asset after change
        "created": "1579093587214"
    },
    {
        "id": "536072393645448960",
        "accountId": "122216245228131",
        "tokenId": "USDT",
        "tokenName": "USDT",
        "flowTypeValue": 7,
        "flowType": "AIRDROP",
        "flowName": "Airdrop",
        "change": "-2000",
        "total": "918662.0917630848",
        "created": "1578640809195"
    }
]

说明

1、主账户Api可以查询钱包账户或者其他账户(包括子账户，指定accountType和accountIndex)的流水’

2、子账户Api只能查询当前子账户的流水，所以不用指定accountType和accountIndex

返回:

Name

Type

Example

Description

integer

539870570957903104

Flow id

accountId

integer

122216245228131

你的 accountId

tokenId

string

USDT

Token ID

tokenId

string

USDT

Token 名称, 大部分情况下和TokenId一样

flowTypeValue

integer

51

Flow类型值

flowType

string

AIRDROP

Flow类型

flowName

string

Airdrop

Flow类型名称

change

float

-12.5

此流水的变化数额

total

float

782.235

流水结束后的账户余额

created

string

1579093587214

流水发生的时间戳（毫秒）

流水类型：

归类

类型参数名

类型参数代号

解释说明

通用流水类

TRADE

交易

通用流水类

FEE

交易手续费

通用流水类

TRANSFER

转账

通用流水类

DEPOSIT

充值

衍生品业务

MAKER_REWARD

maker奖励

衍生品业务

PNL

期货等的盈亏

衍生品业务

SETTLEMENT

交割

衍生品业务

LIQUIDATION

强平

衍生品业务

FUNDING_SETTLEMENT

期货等的资金费率结算

用户子账户之间内部转账

USER_ACCOUNT_TRANSFER

userAccountTransfer 专用，流水没有subjectExtId

OTC

OTC_BUY_COIN

OTC 买入coin

OTC

OTC_SELL_COIN

OTC 卖出coin

OTC

OTC_FEE

OTC 手续费

OTC

OTC_TRADE

200

旧版 OTC 流水

活动

ACTIVITY_AWARD

活动奖励

活动

INVITATION_REFERRAL_BONUS

邀请返佣

活动

REGISTER_BONUS

注册送礼

活动

AIRDROP

空投

活动

MINE_REWARD

挖矿奖励

过滤层

Weight: 5

最后更新于4年前

这有帮助吗？

ENUM 定义

术语解释

Symbol 状态

订单状态

订单类型

订单方向

订单时效类型

k线/烛线图区间

访问接口频率请参见BrokerInfo接口中的：

频率限制类型 (rateLimitType)

频率限制区间

公共

安全类型: None

测试连接

服务器时间

Broker信息

Query Parameters

Response:

Pairs交易对

行情

安全类型: None

订单簿

Query Parameters

Response:

合并订单簿（推荐）

Query Parameters

Response:

最近成交

Query Parameters

Response:

K线/烛线图数据

Query Parameters

Response:

24小时ticker价格变化数据

Path Parameters

Response:

Symbol价格

Query Parameters

Response:

Symbol最佳订单簿价格

Path Parameters

Response:

交易

安全类型： USER_DATA/TRADE

创建新订单

Query Parameters

Headers

Request Body

Response:

创建新测试订单

Query Parameters

Headers

Request Body

订单查询

Query Parameters

Headers

Request Body

Response:

撤销订单

Query Parameters

Headers

Request Body

当前订单

Query Parameters

Headers

Request Body

Response:

历史订单

Query Parameters

Headers

Request Body

Response:

交易记录

Query Parameters

Headers

Request Body

Response:

账户

安全类型： USER_DATA/TRADE

账户信息