公共下方的接口不需要API-key或者签名就能自由访问
{}
{"serverTime":1607702400000,"timezone":中国标准时间}
名称 | 类型 | 例子 | 描述 |
serverTime | long | 1607702400000 | 服务器时间戳 |
timezone | string | 中国标准时间 | 服务器时区 |
[{"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}]
名称 | 类型 | 例子 | 描述 |
symbol | string |
| 合约名称 |
status | number |
| 合约状态(0:不可交易,1:可交易 |
type | string |
| 合约类型,E:永续合约, S:模拟合约, 其他为混合合约 |
side | number |
| 合约方向(反向:0,1:正向) |
multiplier | number |
| 合约面值 |
multiplierCoin | string |
| 合约面值单位 |
pricePrecision | number |
| 价格精度 |
minOrderVolume | number |
| 最小下单量 |
minOrderMoney | number |
| 最小下单金额 |
maxMarketVolume | number |
| 市价单最大下单数量 |
maxMarketMoney | number |
| 市价最大下单金额 |
maxLimitVolume | number |
| 限价单最大下单数量 |
maxValidOrder | number |
| 最大有效委托的订单数量 |
行情下方的接口不需要API-Key或者签名就能自由访问
{"bids": [["3.90000000", // 价格"431.00000000" // 数量],["4.00000000","431.00000000"]],"asks": [["4.00000200", // 价格"12.00000000" // 数量],["5.10000000","28.00000000"]]}
名称 | 类型 | 例子 | 描述 |
time | long |
| 当前时间(Unix Timestamp, 毫秒ms) |
bids | list | 如下 | 订单薄买盘信息 |
asks | list | 如下 | 订单薄卖盘信息 |
bids和asks所对应的信息代表了订单薄的所有价格以及价格对应的数量的信息, 由最优价格从上倒下排列
名称 | 类型 | 例子 | 描述 |
' ' | float |
| 价格 |
' ' | float |
| 当前价格对应的数量 |
{"high": "9279.0301","vol": "1302","last": "9200","low": "9279.0301","rose": "0","time": 1595563624731}
名称 | 类型 | 例子 | 描述 |
time | long |
| 时间戳 |
high | float |
| 最高价 |
low | float |
| 最低价 |
last | float |
| 最新价 |
vol | float |
| 交易量 |
rose | string | +0.5 | 涨跌幅 |
{"markPrice": 581.5,"indexPrice": 646.3933333333333,"lastFundingRate": 0.001,"contractName": "E-ETH-USDT","time": 1608273554063}
名称 | 类型 | 例子 | 描述 |
| float |
| 指数价格 |
| float |
| 标记价格 |
| string |
| 合约名称 |
| float |
| 本期资金费率 |
1min
,5min
,15min
,30min
,1h
,1day
,1week
,1month
(min=分钟,h=小时,day=天,week=星期,month=月)[{"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"}]
名称 | 类型 | 例子 | 描述 |
| long |
| 开始时间戳,毫秒(ms) |
| float |
| 开盘价 |
| float |
| 收盘价 |
| float |
| 最高价 |
| float |
| 最低价 |
| float |
| 成交量 |
交易下方的接口都需要签名和API-key验证
E-BTC-USDT
LIMIT/MARKET
BUY/SELL
OPEN/CLOSE
1全仓/2逐仓
IOC, FOK, POST_ONLY
{"orderId": 256609229205684228}
名称 | 类型 | 例子 | 描述 |
orderId | String |
| 订单ID |
E-BTC-USDT
{"orderId": 256609229205684228}
[{"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"}]
名称 | 类型 | 例子 | 描述 |
| long |
| 订单ID(系统生成 |
| string |
| 合约名称 |
| float |
| 委托价格 |
| float |
| 委托数量 |
| float |
| 委托数量 |
| float |
| 成交均价 |
| string |
| 币对名称 |
| string |
| 订单状态。可能出现的值为: |
| string |
| 订单方向。可能出现的值只能为:BUY(买入做多) 和 SELL(卖出做空) |
| string |
|
|
| long |
| 订单创建时间 |
E-BTC-USDT
[{"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"}]
名称 | 类型 | 例子 | 描述 |
| long |
| 订单ID(系统生成) |
| string |
| 合约名称 |
| float |
| 订单价格 |
| float |
| 订单数量 |
| float |
| 已经成交订单数量 |
| float |
| 订单已经成交的平均价格 |
| string |
| 订单类型。可能出现的值只能为: |
| string |
| 订单方向。可能出现的值只能为: |
| string |
| 订单状态。可能出现的值为: |
| string |
|
|
| long |
| 订单创建时间, |
[{"symbol": "ETHBTC","id": 100211,"bidId": 150695552109032492,"askId": 150695552109032493,"price": "4.00000100","qty": "12.00000000","time": 1499865549590,"isBuyer": true,"isMaker": false,"fee":"0.001"},...]
名称 | 类型 | 例子 | 描述 |
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 | 是否买方 |
账户下方的接口都需要签名和API-key验证
{"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}]}]}]}
名称 | 类型 | 描述 |
|
| 余额集合 |
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 | 平仓最大手续费率 |