合约交易

公共

安全类型: None

公共下方的接口不需要API-key或者签名就能自由访问

get
测试连接

https://futuresopenapi.xxx.com/fapi/v1/ping
测试REST API的连通性
Request
Response
Request
Response
200: OK
连接正常
{}

get
获取服务器时间

https://futuresopenapi.xxx.com/fapi/v1/time
Request
Response
Request
Response
200: OK
{
"serverTime":1607702400000,
"timezone":中国标准时间
}

Response:

名称

类型

例子

描述

serverTime

long

1607702400000

服务器时间戳

timezone

string

中国标准时间

服务器时区

get
合约列表

https://futuresopenapi.xxx.com/fapi/v1/contracts
Request
Response
Request
Response
200: OK
[
{
"symbol": "H-HT-USDT",
"pricePrecision": 8,
"side": 1,
"maxMarketVolume": 100000,
"multiplier": 6,
"minOrderVolume": 1,
"maxMarketMoney": 10000000,
"type": "H",
"maxLimitVolume": 1000000,
"maxValidOrder": 20,
"multiplierCoin": "HT",
"minOrderMoney": 0.001,
"maxLimitMoney": 1000000,
"status": 1
}
]

Response:

名称

类型

例子

描述

symbol

string

E-BTC-USDT

合约名称

status

number

1

合约状态(0:不可交易,1:可交易

type

string

S

合约类型,E:永续合约, S:模拟合约, 其他为混合合约

side

number

1

合约方向(反向:0,1:正向)

multiplier

number

0.5

合约面值

multiplierCoin

string

BTC

合约面值单位

pricePrecision

number

4

价格精度

minOrderVolume

number

10

最小下单量

minOrderMoney

number

10

最小下单金额

maxMarketVolume

number

100000

市价单最大下单数量

maxMarketMoney

number

100000

市价最大下单金额

maxLimitVolume

number

100000

限价单最大下单数量

maxValidOrder

number

100000

最大有效委托的订单数量

行情相关

安全类型: None

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

get
订单薄

https://futuresopenapi.xxx.com/fapi/v1/depth
市场订单薄深度信息
Request
Response
Request
Query Parameters
limit
optional
integer
默认100; 最大100
contractName
required
string
合约合约名称 如 E-BTC-USDT
Response
200: OK
成功获取深度信息
{
"bids": [
[
"3.90000000", // 价格
"431.00000000" // 数量
],
[
"4.00000000",
"431.00000000"
]
],
"asks": [
[
"4.00000200", // 价格
"12.00000000" // 数量
],
[
"5.10000000",
"28.00000000"
]
]
}

Response:

名称

类型

例子

描述

time

long

1595563624731

当前时间(Unix Timestamp, 毫秒ms)

bids

list

如下

订单薄买盘信息

asks

list

如下

订单薄卖盘信息

bids和asks所对应的信息代表了订单薄的所有价格以及价格对应的数量的信息, 由最优价格从上倒下排列

名称

类型

例子

描述

' '

float

131.1

价格

' '

float

2.3

当前价格对应的数量

get
行情ticker

https://futuersopenapi.xxx.com/fapi/v1/ticker
24小时价格变化数据
Request
Response
Request
Query Parameters
contractName
required
string
合约名称 如 E-BTC-USDT
Response
200: OK
成功获取ticker信息
{
"high": "9279.0301",
"vol": "1302",
"last": "9200",
"low": "9279.0301",
"rose": "0",
"time": 1595563624731
}

Response:

名称

类型

例子

描述

time

long

1595563624731

时间戳

high

float

9900

最高价

low

float

8800.34

最低价

last

float

8900

最新价

vol

float

4999

交易量

rose

string

+0.5

涨跌幅

get
获取指数/标记价格

https://futuersopenapi.xxx.com/fapi/v1/index
Request
Response
Request
Query Parameters
contractName
required
string
合约名称 如 E-BTC-USDT
limit
optional
string
默认100; 最大1000
Response
200: OK
{
"markPrice": 581.5,
"indexPrice": 646.3933333333333,
"lastFundingRate": 0.001,
"contractName": "E-ETH-USDT",
"time": 1608273554063
}

Response:

名称

类型

例子

描述

indexPrice

float

0.055

指数价格

markPrice

float

0.0578

标记价格

contractName

string

E-BTC-USDT

合约名称

lastFundingRate

float

0.123

本期资金费率

get
K线/蜡烛图数据

https://futuresopenapi.xxx.com/fapi/v1/klines
Request
Response
Request
Query Parameters
contractName
required
string
合约名称 如 E-BTC-USDT
interval
required
string
k线图区间, 可识别发送的值为: 1min,5min,15min,30min,1h,1day,1week,1month(min=分钟,h=小时,day=天,week=星期,month=月)
limit
optional
integer
默认100; 最大300
Response
200: OK
[
{
"high": "6228.77",
"vol": "111",
"low": "6228.77",
"idx": 1594640340,
"close": "6228.77",
"open": "6228.77"
},
{
"high": "6228.77",
"vol": "222",
"low": "6228.77",
"idx": 1587632160,
"close": "6228.77",
"open": "6228.77"
},
{
"high": "6228.77",
"vol": "333",
"low": "6228.77",
"idx": 1587632100,
"close": "6228.77",
"open": "6228.77"
}
]

Response:

名称

类型

例子

描述

idx

long

1538728740000

开始时间戳,毫秒(ms)

open

float

36.00000

开盘价

close

float

33.00000

收盘价

high

float

36.00000

最高价

low

float

30.00000

最低价

vol

float

2456.111

成交量

交易相关

安全类型: TRADE

交易下方的接口都需要签名和API-key验证

post
创建订单

https://futuresopenapi.xxx.com/fapi/v1/order
创建单个新订单
Request
Response
Request
Headers
X-CH-TS
optional
string
时间戳
X-CH-APIKEY
optional
string
您的API-KEY
X-CH-SIGN
optional
string
签名
Body Parameters
volume
required
number
下单数量
price
required
number
下单价格
contractName
required
string
合约名称 如 E-BTC-USDT
type
required
string
订单类型, LIMIT/MARKET
side
required
string
买卖方向, BUY/SELL
open
required
string
开平仓方向, OPEN/CLOSE
positionType
required
number
持仓类型, 1全仓/2逐仓
clientOrderId
optional
string
客户端下单标识, 长度小于32位的字符串
timeInForce
optional
string
IOC, FOK, POST_ONLY
Response
200: OK
{
"orderId": 256609229205684228
}

Response:

名称

类型

例子

描述

orderId

String

256609229205684228

订单ID

post
取消订单

https://futuresopenapi.xxx.com/fapi/v1/cancel
限速规则: 20次/2s
Request
Response
Request
Headers
X-CH-SIGN
required
string
签名
X-CH-APIKEY
required
string
您的API-key
X-CH-TS
required
integer
时间戳
Body Parameters
contractName
required
string
合约名称如 E-BTC-USDT
orderId
required
string
订单ID
Response
200: OK
{
"orderId": 256609229205684228
}

get
订单详情

https://futuresopenapi.xxx.com/fapi/v1/order
Request
Response
Request
Body Parameters
contractName
required
string
Response
200: OK
[
{
"side": "BUY",
"executedQty": 0,
"orderId": 259396989397942275,
"price": 10000.0000000000000000,
"origQty": 1.0000000000000000,
"avgPrice": 0E-8,
"transactTime": "1607702400000",
"action": "OPEN",
"contractName": "E-BTC-USDT",
"type": "LIMIT",
"status": "INIT"
}
]

Response:

名称

类型

例子

描述

orderId

long

150695552109032492

订单ID(系统生成

contractName

string

E-BTC-USDT

合约名称

price

float

10.5

委托价格

origQty

float

10.5

委托数量

executedQty

float

20

委托数量

avgPrice

float

10.5

成交均价

symbol

string

BHTUSDT

币对名称

status

string

NEW

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

side

string

NEW

订单方向。可能出现的值只能为:BUY(买入做多) 和 SELL(卖出做空)

action

string

OPEN

OPEN/CLOSE

transactTime

long

1607702400000

订单创建时间

get
当前订单

https://futuresopenapi.xxx.com/fapi/v1/openOrders
限速规则: 获取当前合约, 该用户的当前委托
Request
Response
Request
Headers
X-CH-SIGN
required
string
签名
X-CH-APIKEY
required
string
您的API-key
X-CH-TS
required
integer
时间戳
Query Parameters
contractName
required
string
合约名称 E-BTC-USDT
Response
200: OK
[
{
"side": "BUY",
"executedQty": 0,
"orderId": 259396989397942275,
"price": 10000.0000000000000000,
"origQty": 1.0000000000000000,
"avgPrice": 0E-8,
"transactTime": "1607702400000",
"action": "OPEN",
"contractName": "E-BTC-USDT",
"type": "LIMIT",
"status": "INIT"
}
]

Response:

名称

类型

例子

描述

orderId

long

150695552109032492

订单ID(系统生成)

contractName

string

E-BTC-USDT

合约名称

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(订单被拒绝).

action

string

OPEN

OPEN/CLOSE

transactTime

long

1607702400000

订单创建时间,

get
交易记录

https://futuresopenapi.xxx.com/fapi/v1/myTrades
限速规则: 20次/2s
Request
Response
Request
Headers
X-CH-SIGN
required
string
签名
X-CH-APIKEY
required
string
您的API-key
X-CH-TS
required
integer
时间戳
Query Parameters
contractName
required
string
合约名称 如 E-BTC-USDT
limit
optional
string
分页条数, 默认100; 最大1000
fromId
optional
integer
从这个tradeId开始检索
Response
200: OK
[
{
"symbol": "ETHBTC",
"id": 100211,
"bidId": 150695552109032492,
"askId": 150695552109032493,
"price": "4.00000100",
"qty": "12.00000000",
"time": 1499865549590,
"isBuyer": true,
"isMaker": false,
"fee":"0.001"
},...
]

Response:

名称

类型

例子

描述

symbol

string

ETHBTC

币种名称(交易对)

tradeId

number

28457

交易ID

bidId

long

150695552109032492

买方订单ID

askId

long

150695552109032493

卖方订单ID

bidUserId

integer

10024

买方用户ID

askUserId

integer

10025

卖方用户ID

price

float

4.01

成交价格

qty

float

12

交易数量

amount

float

5.38

成交金额

time

number

1499865549590

交易时间戳

fee

number

0.001

交易手续费

side

string

buy

当前订单方向 BUY 买入, SELL 卖出

contractName

string

E-BTC-USDT

合约名称

isMaker

boolean

true

是否是maker

isBuyer

boolean

true

是否买方

账户

安全类型: USER_DATA

账户下方的接口都需要签名和API-key验证

get
账户信息

https://futuresopenapi.xxx.com/fapi/v1/account
限速规则: 20次/2s
Request
Response
Request
Headers
X-CH-SIGN
required
string
签名
X-CH-APIKEY
required
string
您的API-key
X-CH-TS
required
integer
时间戳
Response
200: OK
获取账户信息成功
{
"account": [
{
"marginCoin": "USDT",
"accountNormal": 999.5606,
"accountLock": 23799.5017,
"partPositionNormal": 9110.7294,
"totalPositionNormal": 0,
"achievedAmount": 4156.5072,
"unrealizedAmount": 650.6385,
"totalMarginRate": 0,
"totalEquity": 99964804.560,
"partEquity": 13917.8753,
"totalCost": 0,
"sumMarginRate": 873.4608,
"positionVos": [
{
"contractId": 1,
"contractName": "E-BTC-USDT",
"contractSymbol": "BTC-USDT",
"positions": [
{
"id": 13603,
"uid": 10023,
"contractId": 1,
"positionType": 2,
"side": "BUY",
"volume": 69642.0,
"openPrice": 11840.2394,
"avgPrice": 11840.3095,
"closePrice": 12155.3005,
"leverageLevel": 24,
"holdAmount": 7014.2111,
"closeVolume": 40502.0,
"pendingCloseVolume": 0,
"realizedAmount": 8115.9125,
"historyRealizedAmount": 1865.3985,
"tradeFee": -432.0072,
"capitalFee": 2891.2281,
"closeProfit": 8117.6903,
"shareAmount": 0.1112,
"freezeLock": 0,
"status": 1,
"ctime": "2020-12-11T17:42:10",
"mtime": "2020-12-18T20:35:43",
"brokerId": 21,
"marginRate": 0.2097,
"reducePrice": 9740.8083,
"returnRate": 0.3086,
"unRealizedAmount": 2164.5289,
"openRealizedAmount": 2165.0173,
"positionBalance": 82458.2839,
"settleProfit": 0.4883,
"indexPrice": 12151.1175,
"keepRate": 0.005,
"maxFeeRate": 0.0025
}
]
}
]
}
]
}

Response:

名称

类型

描述

account

[]

余额集合

account field:

名称

类型

例子

描述

marginCoin

string

USDT

保证金币种

accountNormal

float

10.05

余额帐户

accountLock

float

10.07

保证金冻结帐户

partPositionNormal

float

10.07

逐仓保证金余额

totalPositionNormal

float

10.07

全仓占用的初始保证金

achievedAmount

float

10.07

已实现盈亏

unrealizedAmount

float

10.05

未实现盈亏

totalMarginRate

float

10.05

全仓保证金率

totalEquity

float

10.07

全仓权益

partEquity

float

10.07

逐仓权益

totalCost

float

10.07

全仓占用的成本

sumMarginRate

float

10.07

全账户的保证金率

positionVos

[ ]

仓位合约记录

positionVos field:

名称

类型

例子

描述

contractId

integer

2

合约id

contractName

string

E-BTC-USDT

合约名称

contractSymbol

string

BTC-USDT

合约币对

positions

[ ]

仓位明细

positions field:

名称

类型

例子

描述

id

integer

2

仓位id

uid

integer

10023

用户ID

positionType

integer

1

持仓类型(1 全仓,2 仓逐)

side

string

SELL

持仓方向 SELL 多仓, BUY 空仓

volume

float

1.05

持仓数量

openPrice

float

1.05

开仓价格

avgPrice

float

1.05

持仓均价

closePrice

float

1.05

平仓均价

leverageLevel

float

1.05

杠杆倍数

holdAmount

float

1.05

持仓保证金

closeVolume

float

1.05

已平仓数量

pendingCloseVolume

float

1.05

已挂出平仓单的数量

realizedAmount

float

1.05

已实现盈亏

historyRealizedAmount

float

1.05

历史累计已实现盈亏

tradeFee

float

1.05

交易手续费

capitalFee

float

1.05

资金费用

closeProfit

float

1.05

平仓盈亏

shareAmount

float

1.05

分摊金额

freezeLock

integer

0

持仓冻结状态:0 正常,1爆仓冻结,2 交割冻结

status

integer

0

仓位有效性,0无效 1有效

ctime

time

创建时间

mtime

time

更新时间

brokerId

integer

1023

商户id

lockTime

time

爆仓锁仓时间

marginRate

float

1.05

保证金率

reducePrice

float

1.05

强减价格

returnRate

float

1.05

回报率(收益率)

unRealizedAmount

float

1.05

未实现盈亏

openRealizedAmount

float

1.05

开仓未实现盈亏

positionBalance

float

1.05

仓位价值

indexPrice

float

1.05

最新标记价格

keepRate

float

1.05

阶梯最低维持保证金率

maxFeeRate

float

1.05

平仓最大手续费率