合约交易
公共
安全类型: None
公共下方的接口不需要API-key或者签名就能自由访问
测试连接
GET
https://futuresopenapi.xxx.com/fapi/v1/ping
测试REST API的连通性
获取服务器时间
GET
https://futuresopenapi.xxx.com/fapi/v1/time
timezone
string
China Standard Time
服务器时区
serverTime
long
1607702400000
服务器时间戳
合约列表
GET
https://futuresopenapi.xxx.com/fapi/v1/contracts
symbol
string
E-BTC-USDT
大写合约名称
pricePrecision
number
4
价格精度
status
number
1
合约状态(0:不可交易,1:可交易
type
string
S
合约类型 (E:永续合约,S:模拟合约,其他为混合合约)
side
number
1
合约方向 (0: 反向,1:正向)
multiplier
number
0.50
合约面值
minOrderVolume
number
10
最小下单量
minOrderMoney
number
10
最小下单金额
maxMarketVolume
number
100000
市价单最大下单数量
maxMarketMoney
number
100000.00
市价最大下单金额
maxLimitVolume
number
100000
限价单最大下单数量
maxLimitMoney
number
100000.00
限价最大下单金额
maxValidOrder
number
100000
最大有效委托的订单数量
行情相关
安全类型: None
行情下方的接口不需要API-Key或者签名就能自由访问
订单薄
GET
https://futuresopenapi.xxx.com/fapi/v1/depth
市场订单薄深度信息
Query Parameters
limit
integer
默认100; 最大100
contractName
string
大写合约名称 如 E-BTC-USDT
time
long
1595563624731
当前时间(Unix Timestamp, 毫秒ms)
bids
list
[[2100,13],[1990,3]]
订单薄买盘信息,数组第一位为价格,类型为float;第二位为当前价格对应的数量,类型为float
asks
list
[[2100,13],[1990,3]]
订单薄卖盘信息,数组第一位为价格,类型为float;第二位为当前价格对应的数量,类型为float
行情ticker
GET
https://futuresopenapi.xxx.com/fapi/v1/ticker
24小时价格变化数据
Query Parameters
contractName*
string
大写合约名称 如 E-BTC-USDT
time
long
1595563624731
时间戳
high
float
9900
最高价
low
float
8800.34
最低价
last
float
8900.23
最新价
vol
float
4999
交易量
rose
string
+0.05
涨跌幅,+为涨,-为跌,+0.05为涨5%
buy
float
2100.01
买一价格
sell
float
2050.01
卖一价格
获取指数/标记价格
GET
https://futuresopenapi.xxx.com/fapi/v1/index
Query Parameters
contractName*
string
合约名称大写 如 E-BTC-USDT
limit
string
默认100; 最大1000
indexPrice
float
0.055
指数价格
tagPrice
float
0.0578
标记价格
nextFundRate
float
0.343
资金费率价格
currentFundRate
float
0.123
上期资金费率(用于本期结算)
K线/蜡烛图数据
GET
https://futuresopenapi.xxx.com/fapi/v1/klines
Query Parameters
contractName*
string
合约名称大写 如 E-BTC-USDT
interval*
string
k线图区间, 可识别的参数值为: 1min
,5min
,15min
,30min
,1h
,1day
,1week
,1month
(min=分钟,h=小时,day=天,week=星期,month=月)
limit
integer
默认100; 最大300
startTime
long
时间戳,毫秒(ms)
1708617600000
endTime
long
时间戳,毫秒(ms)
1708704000000
idx
long
1538728740000
开始时间戳,毫秒(ms)
open
float
36.00000
开盘价
close
float
33.00000
收盘价
high
float
36.00000
最高价
low
float
30.00000
最低价
vol
float
2456.00000
成交量
交易相关
安全类型: TRADE
交易下方的接口都需要签名和API-key验证
创建订单
POST
https://futuresopenapi.xxx.com/fapi/v1/order
创建单个新订单
Headers
X-CH-TS*
string
时间戳
X-CH-APIKEY*
string
您的API-KEY
X-CH-SIGN*
string
签名
Request Body
volume*
number
下单张数,有精度限制,精度由管理员设置, 市价开仓时这里单位是价值
price
number
下单价格,限价单时该字段为必传,有精度限制,精度由管理员设置
contractName*
string
大写合约名称 如 E-BTC-USDT
type*
string
订单类型, LIMIT/MARKET
side*
string
买卖方向, BUY/SELL
open*
string
开平仓方向, OPEN/CLOSE
positionType
number
持仓类型, 1:全仓/2:逐仓
clientOrderId
string
客户端下单标识, 长度小于32位的字符串
timeInForce
string
IOC, FOK, POST_ONLY
orderId
string
256609229205684228
订单ID
创建条件单
POST
https://futuresopenapi.xxx.com/fapi/v1/conditionOrder/
Headers
X-CH-TS*
string
时间戳
X-CH-APIKEY*
string
您的API-KEY
X-CH-SIGN*
string
签名
Request Body
triggerType
string
条件的类型,1:止损/2:止盈/3:追涨/4:杀跌
triggerPrice
string
触发价
clientOrderId
string
客户端下单标识,长度小于32位的字符串
positionType
number
持仓类型,1:全仓/2.逐仓
open
string
开平仓方向,OPEN/CLOSE
side
string
买卖方向,BUY/SELL
type
string
订单类型, LIMIT/MARKET
contractName
string
大写合约名称 如 E-BTC-USDT
price
number
下单价格,有精度限制,精度由管理员设置
volume
number
下单数量,市价开仓时这里单位是价值,有精度限制,精度由管理员设置
如果该接口返回与期望不符,请联系技术团队,我们会为您提供相关帮助
取消订单
POST
https://futuresopenapi.xxx.com/fapi/v1/cancel
限速规则: 20次/2s
Headers
X-CH-SIGN*
string
签名
X-CH-APIKEY*
string
您的API-key
X-CH-TS*
integer
时间戳
Request Body
contractName*
string
大写合约名称 如 E-BTC-USDT
orderId*
string
订单ID
订单详情
GET
https://futuresopenapi.xxx.com/fapi/v1/order
Query Parameters
contractName*
string
大写合约名称 如E-BTC-USDT
orderId*
string
订单ID
clientOrderId*
string
客户端唯一标识,默认为0
orderId
long
150695552109032492
订单ID(系统生成
contractName
string
E-BTC-USDT
大写合约名称
price
float
10.50
委托价格
origQty
float
10.50
委托数量
executedQty
float
10.10
成交数量
avgPrice
float
10.50
成交均价
status
string
NEW
订单状态。可能出现的值为:NEW
(新订单,无成交)、PARTIALLY_FILLED
(部分成交)、FILLED
(全部成交)、CANCELED
(已取消)和REJECTED
(订单被拒绝)
side
string
NEW
订单方向。可能出现的值只能为:BUY(买入做多) 和 SELL(卖出做空)
action
string
OPEN
OPEN/CLOSE
transactTime
long
1607702400000
订单创建时间
type
string
LIMIT
订单类型LIMIT/MARKET
timeInForce
integer
2
条件单有效方式1 limit, 2 market,3 IOC,4 FOK,5 POST_ONLY
fills
[ ]
成交记录
当前订单
GET
https://futuresopenapi.xxx.com/fapi/v1/openOrders
限速规则: 获取当前合约, 该用户的当前委托
Query Parameters
contractName
string
需大写合约名称 如E-BTC-USDT
Headers
X-CH-SIGN
string
签名
X-CH-APIKEY
string
您的API-key
X-CH-TS
string
时间戳
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
订单创建时间
历史委托
POST
https://futuresopenapi.xxx.com/fapi/v1/orderHistorical
Headers
X-CH-SIGN
string
签名
X-CH-APIKEY
string
您的API-key
X-CH-TS
string
时间戳
Request Body
contractName
string
大写合约名称 E-BTC-USDT
limit
string
分页条数, 默认100; 最大1000
fromId
long
从这条记录开始检索
如果该接口返回与期望不符,请联系技术团队,我们会为您提供相关帮助
盈亏记录
POST
https://futuresopenapi.xxx.com/fapi/v1/profitHistorical
如果该接口返回报错,请联系技术团队,我们会为您提供相关帮助
Headers
X-CH-SIGN
string
签名
X-CH-APIKEY
string
您的API-key
X-CH-TS
string
时间戳
Request Body
contractName
string
大写合约名称 如E-BTC-USDT
limit
string
分页条数, 默认100; 最大1000
fromId
long
从这条记录开始检索
如果该接口返回与期望不符,请联系技术团队,我们会为您提供相关帮助
交易记录
GET
https://futuresopenapi.xxx.com/fapi/v1/myTrades
限速规则: 20次/2s
Query Parameters
contractName*
string
大写合约名称 如 E-BTC-USDT
limit
string
分页条数, 默认100; 最大1000
fromId
long
从这个tradeId开始检索
Headers
X-CH-SIGN
string
签名
X-CH-APIKEY
string
您的API-key
X-CH-TS
integer
时间戳
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
是否买方
更改持仓模式
POST
https://futuresopenapi.xxx.com/fapi/v1/edit_user_position_model
Headers
X-CH-TS*
integer
时间戳
X-CH-APIKEY*
string
您的API-key
X-CH-SIGN*
string
签名
Request Body
contractName*
string
大写合约名称 如 E-BTC-USDT
positionModel*
integer
持仓模式 (1.净持仓 2.双向持仓)传入1或者2
更改保证金模式
POST
https://futuresopenapi.xxx.com/fapi/v1/edit_user_margin_model
Headers
X-CH-TS*
integer
时间戳
X-CH-APIKEY*
string
您的API-key
X-CH-SIGN*
string
签名
Request Body
contractName*
string
大写合约名称 如 E-BTC-USDT
marginModel*
integer
保证金模式 (1.全仓 2.逐仓)传入1或者2
更改杠杆倍数
POST
https://futuresopenapi.xxx.com/fapi/v1/edit_lever
Headers
X-CH-TS*
integer
时间戳
X-CH-APIKEY*
string
您的API-key
X-CH-SIGN*
string
签名
Request Body
contractName*
string
大写合约名称 如 E-BTC-USDT
nowLevel*
integer
需要修改的杠杆倍数 如50
获取当前条件单
POST
https://futuresopenapi.xxx.com/fapi/v1/trigger_order_list
Headers
X-CH-TS*
integer
时间戳
X-CH-APIKEY*
string
您的API-key
X-CH-SIGN*
string
签名
Request Body
contractName*
string
大写合约名称 如 E-BTC-USDT
page
integer
当前页数,默认为1
limit
integer
分页条数,默认1000条
id
long
782
条件单归集表id
triggerOrderId
long
1322738336974712828
条件单id
contractId
long
127
合约id
contractName
string
BTCUSDT
合约名
marginCoin
string
USDT
保证金币种
multiplier
float
0.0001
合约面值
triggerPrice
float
10000
触发价格
price
float
0
下单价格
pricePrecision
integer
3
价格精度
volume
float
100
下单数量
open
string
OPEN
开平仓方向(open 开仓,close 平仓)
side
string
BUY
买卖方向(buy 买入,sell 卖出)
status
integer
0
有效状态 0有效
expireTime
long
1707722808000
订单过期时间
ctime
long
1705978532000
创建时间
mtime
long
1705978532000
修改时间
triggerType
integer
1
条件单类型1 stop loss,2 take profit,3 stop loss limit,4 take profit limit
取消条件单
POST
https://futuresopenapi.xxx.com/v1/inner/trigger_order_cancel
Headers
X-CH-TS*
integer
时间戳
X-CH-APIKEY*
string
您的API-key
X-CH-SIGN*
string
签名
Request Body
contractName*
string
大写合约名称 如 E-BTC-USDT
orderId*
long
1322738336974712828
账户
安全类型: USER_DATA
账户下方的接口都需要签名和API-key验证
账户信息
GET
https://futuresopenapi.xxx.com/fapi/v1/account
限速规则: 20次/2s
Headers
X-CH-SIGN
string
签名
X-CH-APIKEY
string
您的API-key
X-CH-TS
integer
时间戳
account
[]
余额集合
Last updated