现货账户和交易接口
查询账户KYC状态
请求示例
GET /api/v3/kyc/status?timestamp={{timestamp}}&signature={{signature}}
返回示例
{
"status": "1"
}
HTTP请求
- GET
/api/v3/kyc/status
接口权限要求: 账户读 / SPOT_ACCOUNT_READ
权重(IP): 1
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
timestamp | string | 是 | 时间戳 |
signature | string | 是 | 签名 |
返回参数
参数名 | 数据类型 | 说明 |
---|---|---|
status | string | 1:未kyc 2:初级kyc 3:高级kyc 4:机构kyc |
查询账户UID
请求示例
GET /api/v3/uid?timestamp={{timestamp}}&signature={[{signature]}
返回示例
{
"uid":"209302839"
}
HTTP请求
- GET
/api/v3/uid
接口权限要求: 账户读 / SPOT_ACCOUNT_READ
权重(IP): 1
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
timestamp | string | 是 | 时间戳 |
signature | string | 是 | 签名 |
返回参数
参数名 | 数据类型 | 说明 |
---|---|---|
uid | string | 账户uid |
用户API交易对
获取用户可API交易的交易对
请求示例
GET /api/v3/selfSymbols?timestamp={{timestamp}}&signature={{signature}}
返回示例
{
"code": 200,
"data": [
"GENE1USDT",
"SNTUSDT",
"SQUAWKUSDT",
"HEGICUSDT",
"GUMUSDT"
],
"msg": null
}
HTTP请求
- GET
/api/v3/selfSymbols
接口权限要求: 账户读 / SPOT_ACCOUNT_R
权重(IP): 1
请求参数
NONE
返回参数
参数名 | 数据类型 | 说明 |
---|---|---|
symbol | string | 返回支持API交易的交易对 |
测试下单
用于测试订单请求,但不会提交到撮合引擎
请求示例
POST /api/v3/order/test
返回示例
{}
HTTP请求
- POST
/api/v3/order/test
接口权限要求: 现货交易信息写 / SPOT_DEAL_W
权重(IP): 1
请求参数
同于 POST /api/v3/order
下单
只有当您的账户有足够的资金才能下单。
请求示例
POST /api/v3/order?symbol=MXUSDT&side=BUY&type=LIMIT&quantity=50&price=0.1×tamp={{timestamp}}&signature={{signature}}
返回示例
{
"symbol": "MXUSDT",
"orderId": "06a480e69e604477bfb48dddd5f0b750",
"orderListId": -1,
"price": "0.1",
"origQty": "50",
"type": "LIMIT",
"side": "BUY",
"stpMode": "",
"transactTime": 1666676533741
}
HTTP请求
- POST
/api/v3/order
接口权限要求: 现货交易信息写 / SPOT_DEAL_W
权重(IP): 1/权重(UID): 1
请求参数
名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
symbol | string | 是 | 交易对 |
side | ENUM | 是 | 详见枚举定义:订单方向 |
type | ENUM | 是 | 详见枚举定义:订单类型 |
quantity | decimal | 否 | 委托数量 |
quoteOrderQty | decimal | 否 | 委托总额 |
price | decimal | 否 | 委托价格 |
newClientOrderId | string | 否 | 客户自定义的唯一订单ID |
stpMode | string | 否 | ""-默认值,不限制自成交。“cancel_maker”-取消maker单。“cancel_taker”-取消taker单。“cancel_both”-双方都取消。 |
recvWindow | long | 否 | 赋值不能大于 60000 |
timestamp | long | 是 |
基于订单 type
不同,强制要求某些参数:
类型 | 强制要求的参数 |
---|---|
LIMIT | quantity , price |
MARKET | quantity or quoteOrderQty |
其他说明:
stpMode=""时,不限制自成交.即不判断tradeGroup,只针对账号自身限制自成交。
MARKET:当type是market时,不论是买单或者卖单,quoteOrderQty和quantity参数任选其一。
-
比如在
BTCUSDT
上下一个市价买单, 明确的是买入时想要花费的计价资产数量。此时的报单数量将会以市场流动性和quoteOrderQty
被计算出来(实际成交数量以最终订单详情为准)。 以BTCUSDT
为例,quoteOrderQty=100
:下买单的时候, 订单会尽可能的买进价值100USDT的BTC. -
比如在
BTCUSDT
上下一个市价卖单,quantity
为用户指明能够卖出多少BTC。
返回参数
参数名 | 数据类型 | 说明 |
---|---|---|
symbol | string | 交易对 |
orderId | string | 订单id |
orderListId | string | 客户端订单列表 |
price | string | 订单id |
origQty | string | 委托数量 |
type | string | 订单类型 |
side | string | 订单方向 |
stpMode | string | 否 |
transactTime | long | 下单时间 |
批量下单
支持单次批量下20单,要求必须是同一交易对。
请求示例
POST /api/v3/batchOrders?batchOrders=[{"type": "LIMIT_ORDER","price": "40000","quantity": "0.0002","symbol": "BTCUSDT","side": "BUY","newClientOrderId": 9588234},{"type": "LIMIT_ORDER","price": "4005","quantity": "0.0003","symbol": "BTCUSDT","side": "SELL"}]
返回示例
{ //成功返回:
[
{
"symbol": "BTCUSDT",
"orderId": "1196315350023612316",
"orderListId": -1
},
{
"symbol": "BTCUSDT",
"orderId": "1196315350023612318",
"orderListId": -1
}
],
//有失败的返回:
[
{
"symbol": "BTCUSDT",
"orderId": "1196315350023612316",
"newClientOrderId": "hio8279hbdsds",
"orderListId": -1
},
{
"newClientOrderId": "123456",
"msg": "The minimum transaction volume cannot be less than:0.5USDT",
"code": 30002
},
{
"symbol": "BTCUSDT",
"orderId": "1196315350023612318",
"orderListId": -1
}
]
}
HTTP请求
- POST
/api/v3/batchOrders
接口权限要求: 现货交易信息写 / SPOT_DEAL_W
权重(IP): 1
请求参数
名称 | 类型 | 是否必需 | 说明 |
---|---|---|---|
batchOrders | LIST | 是 | 订单列表,最多支持20个订单(list of JSON格式填写订单参数,参考请求示例) |
symbol | string | 是 | 交易对 |
side | ENUM | 是 | 详见枚举定义:订单方向 |
type | ENUM | 是 | 详见枚举定义:订单类型 |
quantity | decimal | 否 | 委托数量 |
quoteOrderQty | decimal | 否 | 委托总额 |
price | decimal | 否 | 委托价格 |
newClientOrderId | string | 否 | 客户自定义的唯一订单ID |
stpMode | string | 否 | ""-默认值,不限制自成交。“cancel_maker”-取消maker单。“cancel_taker”-取消taker单。“cancel_both”-双方都取消。 |
recvWindow | long | 否 | 赋值不能大于 60000 |
timestamp | long | 是 |
基于订单 type
不同,强制要求某些参数:
类型 | 强制要求的参数 |
---|---|
LIMIT | quantity , price |
MARKET | quantity or quoteOrderQty |
返回参数
参数名 | 数据类型 | 说明 |
---|---|---|
symbol | string | 交易对 |
orderId | string | 订单id |
撤销订单
取消有效订单。
请求示例
DELETE /api/v3/order?symbol=BTCUSDT&orderId=135598325645746176×tamp={{timestamp}}&signature={{signature}}
返回示例
{
"symbol": "BTCUSDT",
"origClientOrderId": "myOrder1",
"orderId": 4,
"orderListId": -1, // OCO订单ID,否则为 -1
"clientOrderId": "cancelMyOrder1",
"price": "29000.0000",
"origQty": "1.00000000",
"executedQty": "0.00000000",
"cummulativeQuoteQty": "0.00000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "BUY"
}
HTTP请求
- DELETE
/api/v3/order
接口权限要求: 现货交易信息写 / SPOT_DEAL_W
权重(IP): 1
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
symbol | string | 是 | 交易对名称 |
orderId | string | 否 | 订单Id |
origClientOrderId | string | 否 | 初始自定义订单Id |
newClientOrderId | string | 否 | 客户自定义的唯一订单ID |
recvWindow | long | 否 | |
timestamp | long | 是 |
返回参数
参数名 | 说明 |
---|---|
symbol | 交易对 |
origClientOrderId | 原始客户端订单id |
orderId | 订单id |
clientOrderId | 客户端id |
price | 价格 |
origQty | 初始数量 |
executedQty | 已成交数量 |
cummulativeQuoteQty | 已成交金额 |
status | 当前状态 |
timeInForce | 订单有效方式 |
type | 订单类型 |
side | 订单方向 |
撤销单一交易对所有订单
撤销单一交易对下所有挂单, 包括OCO的挂单。
请求示例
DELETE /api/v3/openOrders?symbol=BTCUSDT×tamp={{timestamp}}&signature={{signature}}
返回示例
[
{
"symbol": "BTCUSDT",
"origClientOrderId": "E6APeyTJvkMvLMYMqu1KQ4",
"orderId": 11,
"orderListId": -1,
"clientOrderId": "pXLV6Hz6mprAcVYpVMTGgx",
"price": "0.089853",
"origQty": "0.178622",
"executedQty": "0.000000",
"cummulativeQuoteQty": "0.000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "BUY"
},
{
"symbol": "BTCUSDT",
"origClientOrderId": "A3EF2HCwxgZPFMrfwbgrhv",
"orderId": 13,
"orderListId": -1,
"clientOrderId": "pXLV6Hz6mprAcVYpVMTGgx",
"price": "0.090430",
"origQty": "0.178622",
"executedQty": "0.000000",
"cummulativeQuoteQty": "0.000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "BUY"
}
]
HTTP请求
- DELETE
/api/v3/openOrders
接口权限要求: 现货交易信息写 / SPOT_DEAL_W
权重(IP): 1
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
symbol | string | 是 | 交易对 |
recvWindow | long | 否 | |
timestamp | long | 是 |
返回参数
参数名 | 说明 |
---|---|
symbol | 交易对 |
origClientOrderId | 原始客户端订单id |
orderId | 订单id |
clientOrderId | 客户端id |
price | 价格 |
origQty | 初始数量 |
executedQty | 已成交数量 |
cummulativeQuoteQty | 已成交金额 |
status | 状态 |
timeInForce | 订单有效方式 |
type | 订单类型 |
side | 订单方向 |
查询订单
查询指定交易对订单状态,最多查询7天内的订单记录,超过7天的可在web客户端查看和导出。
请求示例
GET /api/v3/order?symbol=BTCUSDT&orderId=129402018493145088×tamp={{timestamp}}&signature={{signature}}
返回示例
{
"symbol": "LTCBTC", // 交易对
"orderId": 1, // 系统的订单ID
"orderListId": -1, // OCO订单的ID,不然就是-1
"clientOrderId": "myOrder1", // 客户自己设置的ID
"price": "0.1", // 订单价格
"Qty": "1.0", // 用户设置的原始订单数量
"executedQty": "0.0", // 交易的订单数量
"cummulativeQuoteQty": "0.0", // 累计交易的金额
"status": "NEW", // 订单状态
"timeInForce": "GTC", // 订单的时效方式
"type": "LIMIT", // 订单类型, 比如市价单,现价单等
"side": "BUY", // 订单方向,买还是卖
"stopPrice": "0.0", // 止损价格
"icebergQty": "0.0", // 冰山数量
"time": 1499827319559, // 订单时间
"updateTime": 1499827319559, // 最后更新时间
"stpMode":"", //stp模式
"cancelReason":"stp_cancel", //取消原因
"isWorking": true, // 订单是否出现在orderbook中
"origQuoteOrderQty": "0.000000" // 原始的交易金额
}
HTTP请求
- GET
/api/v3/order
接口权限要求: 现货交易信息读 / SPOT_DEAL_R
权重(IP): 2
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
symbol | 交易对 | 是 | |
origClientOrderId | 原始客户端订单id | 否 | |
orderId | 订单id | 否 | |
recvWindow | long | 否 | |
timestamp | long | 是 |
返回参数
参数名 | 说明 |
---|---|
symbol | 交易对 |
origClientOrderId | 原始客户端订单id |
orderId | 系统订单id |
clientOrderId | 客户自定义id |
price | 价格 |
Qty | 原始订单数量 |
executedQty | 交易的订单数量 |
cummulativeQuoteQty | 累计订单金额 |
status | 订单状态 |
timeInForce | 订单的时效方式 |
type | 订单类型 |
side | 订单方向 |
stopPrice | 止损价格 |
icebergQty | 冰山数量 |
time | 订单时间 |
updateTime | 最后更新时间 |
isWorking | 是否在orderbook中 |
stpMode | ""-默认值,不限制自成交。“cancel_maker”-取消maker单。“cancel_taker”-取消taker单。“cancel_both”-双方都取消。 |
cancelReason | 取消原因,用户自己取消时该字段为空,stp_cancel :因STP规则取消 |
origQuoteOrderQty | 原始的交易金额 |
当前挂单
获取当前挂单支持查询多交易对,每次最多可以传5个symbol。
若批量查5个交易对,最多也只返回1000条挂单
请求示例
GET /api/v3/openOrders?symbol=BTCUSDT×tamp={{timestamp}}&signature={{signature}}
返回示例
[
{
"symbol": "LTCBTC",
"orderId": 1,
"orderListId": -1,
"clientOrderId": "myOrder1",
"price": "0.1",
"origQty": "1.0",
"executedQty": "0.0",
"cummulativeQuoteQty": "0.0",
"status": "NEW",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "BUY",
"stopPrice": "0.0",
"icebergQty": "0.0",
"time": 1499827319559,
"updateTime": 1499827319559,
"isWorking": true,
"stpMode":"",
"cancelReason":"stp_cancel",
"origQuoteOrderQty": "0.000000"
}
]
HTTP请求
- GET
/api/v3/openOrders
接口权限要求: 现货交易信息读 / SPOT_DEAL_R
权重(IP): 3
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
symbol | string | 否 | 交易对,【最多可以传5个symbol, 由","分隔的字符串表示. e.g. "BTCUSDT,MXUSDT,ADAUSDT"】 |
recvWindow | long | 否 | |
timestamp | long | 是 |
返回参数
参数名 | 说明 |
---|---|
symbol | 交易对 |
origClientOrderId | 原始客户端订单id |
orderId | 系统订单id |
clientOrderId | 客户自定义id |
price | 价格 |
origQty | 原始订单数量 |
executedQty | 交易的订单数量 |
cummulativeQuoteQty | 累计订单金额 |
status | 订单状态 |
timeInForce | 订单的时效方式 |
type | 订单类型 |
side | 订单方向 |
stopPrice | 止损价格 |
icebergQty | 冰山数量 |
time | 订单时间 |
updateTime | 最后更新时间 |
isWorking | 是否在orderbook中 |
stpMode | ""-默认值,不限制自成交。“cancel_maker”-取消maker单。“cancel_taker”-取消taker单。“cancel_both”-双方都取消。 |
cancelReason | 取消原因,用户自己取消时该字段为空,stp_cancel :因STP规则取消 |
origQuoteOrderQty | 原始的交易金额 |
查询所有订单
获取所有有效,已取消或已完成的帐户订单(查询时间段默认最近24小时),最多查询最近7天数据。
请求示例
GET /api/v3/allOrders?symbol=BTCUSDT×tamp={{timestamp}}&signature={{signature}}
返回示例
[
{
"symbol": "LTCBTC",
"orderId": 1,
"orderListId": -1,
"clientOrderId": "myOrder1",
"price": "0.1",
"origQty": "1.0",
"executedQty": "0.0",
"cummulativeQuoteQty": "0.0",
"status": "NEW",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "BUY",
"stopPrice": "0.0",
"icebergQty": "0.0",
"time": 1499827319559,
"updateTime": 1499827319559,
"isWorking": true,
"stpMode":"",
"cancelReason":"stp_cancel",
"origQuoteOrderQty": "0.000000"
}
]
HTTP请求
- GET
/api/v3/allOrders
接口权限要求: 现货交易信息读 / SPOT_DEAL_R
权重(IP): 10
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
symbol | string | 是 | 交易对 |
startTime | long | 否 | |
endTime | long | 否 | |
limit | int | 否 | 默认 500; 最大 1000; |
recvWindow | long | 否 | |
timestamp | long | 是 |
返回参数
参数名 | 说明 |
---|---|
symbol | 交易对 |
origClientOrderId | 原始客户端订单id |
orderId | 系统订单id |
clientOrderId | 客户自定义id |
price | 价格 |
origQty | 原始订单数量 |
executedQty | 交易的订单数量 |
cummulativeQuoteQty | 累计订单金额 |
status | 订单状态 |
timeInForce | 订单的时效方式 |
type | 订单类型 |
side | 订单方向 |
stopPrice | 止损价格 |
icebergQty | 冰山数量 |
time | 订单时间 |
updateTime | 最后更新时间 |
isWorking | 是否在orderbook中 |
stpMode | ""-默认值,不限制自成交。“cancel_maker”-取消maker单。“cancel_taker”-取消taker单。“cancel_both”-双方都取消。 |
cancelReason | 取消原因,用户自己取消时该字段为空,stp_cancel :因STP规则取消 |
origQuoteOrderQty | 原始的交易金额 |
账户信息
获取当前账户信息。
请求示例
GET /api/v3/account?timestamp={{timestamp}}&signature={{signature}}
返回示例
{
"canTrade": true,
"canWithdraw": true,
"canDeposit": true,
"updateTime": null,
"accountType": "SPOT",
"balances": [
{
"asset": "MX",
"free": "3",
"locked": "0"
},
{
"asset": "BTC",
"free": "0.0003",
"locked": "0"
}
],
"permissions": [
"SPOT"
]
}
HTTP请求
- GET
/api/v3/account
接口权限要求: 账户读 / SPOT_ACCOUNT_R
权重(IP): 10
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
recvWindow | long | 否 | |
timestamp | long | 是 |
返回参数
参数名 | 说明 |
---|---|
canTrade | 是否可交易 |
canWithdraw | 是否可提现 |
canDeposit | 是否可充值 |
updateTime | 更新时间 |
accountType | 账户类型 |
balances | 余额 |
asset | 资产币种 |
free | 可用数量 |
locked | 冻结数量 |
permissions | 权限 |
账户成交历史
获取账户指定交易对的成交历史,仅可查询近1月成交记录,如需查看更多成交记录,请使用web端导出功能,最多支持导出近3年成交记录。
请求示例
GET /api/v3/myTrades?symbol=MXUSDT×tamp={{timestamp}}&signature={{signature}}
返回示例
[
{
"symbol": "MXUSDT",
"id": "fad2af9e942049b6adbda1a271f990c6",
"orderId": "bb41e5663e124046bd9497a3f5692f39",
"orderListId": -1,
"price": "2.044",
"qty": "3",
"quoteQty": "6.132",
"commission": "0.012264",
"commissionAsset": "USDT",
"time": 1651980451000,
"isBuyer": true,
"isMaker": false,
"isBestMatch": true,
"isSelfTrade": null,
"clientOrderId": null
}
]
HTTP请求
- GET
/api/v3/myTrades
接口权限要求: 账户读 / SPOT_ACCOUNT_R
权重(IP): 10
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
symbol | string | 是 | 交易对 |
orderId | string | 否 | 必须和symbol一起使用 |
startTime | long | 否 | |
endTime | long | 否 | |
limit | int | 否 | 默认 100; 最大 100; |
recvWindow | long | 否 | |
timestamp | long | 是 |
返回参数
参数名 | 说明 |
---|---|
symbol | 交易对 |
id | 成交id |
orderId | 订单id |
price | 价格 |
qty | 数量 |
quoteQty | 成交金额 |
time | 成交时间 |
commission | 手续费 |
commissionAsset | 手续费币种 |
isBuyerMaker | 是否为买方maker单 |
isBestMatch | 是否为最佳匹配 |
isSelfTrade | 是否自成交 |
clientOrderId | 用户自定义id |
开启MX抵扣
调用该接口,开启或者关闭现货MX抵扣手续费设置
请求示例
post api/v3/mxDeduct/enable?timestamp={{timestamp}}&signature={{signature}}
返回示例
{
"data":{
"mxDeductEnable":true
},
"code":0,
"msg":"success",
"timestamp":1669109672280
}
HTTP请求
- POST
api/v3/mxDeduct/enable
接口权限要求: 现货交易信息写 / SPOT_DEAL_W
权重(IP): 1
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
mxDeductEnable | boolean | yes | 是否开启MX抵扣,true:开启, false:关闭 |
recvWindow | long | no | 同步时间 |
timestamp | long | yes | 时间戳 |
signature | string | yes | 签名 |
返回参数
参数名 | 类型 | 说明 |
---|---|---|
mxDeductEnable | boolean | 是否开启了MX抵扣,true:已开启,false:已关闭. |
查看MX抵扣状态
请求示例
get api/v3/mxDeduct/enable?timestamp={{timestamp}}&signature={{signature}}
返回示例
{
"data":{
"mxDeductEnable":false
},
"code":0,
"msg":"success",
"timestamp":1669109672717
}
HTTP请求
- GET
api/v3/mxDeduct/enable
接口权限要求: 现货交易信息读 / SPOT_DEAL_R
权重(IP): 1
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
recvWindow | long | no | 同步时间 |
timestamp | long | yes | 时间戳 |
signature | string | yes | 签名 |
返回参数
参数名 | 类型 | 说明 |
---|---|---|
mxDeductEnable | boolean | 是否开启了MX抵扣,true:已开启,false:已关闭. |
查看手续费率
请求示例
get api/v3/tradeFee?symbol=MXUSDT×tamp={{timestamp}}&signature={{signature}}
返回示例
{
"data":{
"makerCommission":0.003000000000000000,
"takerCommission":0.003000000000000000
},
"code":0,
"msg":"success",
"timestamp":1669109672717
}
HTTP请求
- GET
api/v3/tradeFee
接口权限要求: 账户信息读 / SPOT_ACCOUNT_R
权重(IP): 20
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
symbol | string | yes | 交易对 |
recvWindow | long | no | 同步时间 |
timestamp | long | yes | 时间戳 |
signature | string | yes | 签名 |
返回参数
参数名 | 类型 | 说明 |
---|---|---|
makerCommission | long | 用户maker费率 |
takerCommission | long | 用户taker费率 |
新建STP策略组
请求示例
post /api/v3/strategy/group?tradeGroupName=tradeGroupOne×tamp={{timestamp}}&signature={{signature}}
返回示例
{
"data": {
"tradeGroupName": "tradeGroupOne",
"tradeGroupId": 91,
"createTime": 1758043350000,
"updateTime": 1758043350000
},
"code": 200,
"msg": "success",
"timestamp": 1758043350233
}
HTTP请求
- POST
/api/v3/strategy/group
接口权限要求: 账户信息写 / SPOT_ACCOUNT_W
权重(IP): 20
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
tradeGroupName | string | yes | 策略组名称 |
timestamp | long | yes | 时间戳 |
signature | string | yes | 签名 |
返回参数
参数名 | 类型 | 说明 |
---|---|---|
tradeGroupName | string | 策略组名称 |
tradeGroupId | string | 策略组id |
createTime | long | 创建时间 |
注意事件:
- 只允许母账号创建,子账号无法操作该接口
- 策略组名称同一个母账号下不可重复
- 策略组id具有唯一性
- 一个母账号下策略组最多10个
查询STP策略组
请求示例
get /api/v3/strategy/group?tradeGroupName=tradeGroupOne×tamp={{timestamp}}&signature={{signature}}
返回示例
{
"data": [
{
"tradeGroupName": "tradeGroupNameOne",
"tradeGroupId": 91,
"createTime": 1758043350000,
"updateTime": 1758043350000
}
],
"code": 200,
"msg": "success",
"timestamp": 1758044090972
}
HTTP请求
- GET
/api/v3/strategy/group
接口权限要求: 账户信息读 / SPOT_ACCOUNT_R
权重(IP): 20
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
tradeGroupName | string | yes | 策略组名称 |
timestamp | long | yes | 时间戳 |
signature | string | yes | 签名 |
返回参数
参数名 | 类型 | 说明 |
---|---|---|
tradeGroupName | string | 策略组名称 |
tradeGroupId | string | 策略组id |
tradeGroupUid | string | 策略组下包含的uid,多个间以,隔开 |
updateTime | long | 更新时间 |
createTime | long | 创建时间 |
删除STP策略组
请求示例
delete /api/v3/strategy/group?tradeGroupId=91×tamp={{timestamp}}&signature={{signature}}
返回示例
{
"data": true,
"code": 200,
"msg": "success",
"timestamp": 1758044399749
}
HTTP请求
- DELETE
/api/v3/strategy/group
接口权限要求: 账户信息写 / SPOT_ACCOUNT_W
权重(IP): 20
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
tradeGroupId | string | yes | 策略组id |
timestamp | long | yes | 时间戳 |
signature | string | yes | 签名 |
返回参数
参数名 | 类型 | 说明 |
---|---|---|
msg | string | 删除状态 |
注意事项:
- 只允许母账户删除,子账户无法访问
- 只允许操作当前母账户下的策略组,无法跨母账户操作
STP策略组中添加用户
请求示例
post /api/v3/strategy/group/uid?uid=49910594&ttradeGroupId=92×tamp={{timestamp}}&signature={{signature}}
返回示例
{
"data": {
"tradeGroupName": "1",
"tradeGroupId": 92,
"tradeGroupUid": "49910594",
"createTime": 1758044671000,
"updateTime": 1758044777000
},
"code": 200,
"msg": "success",
"timestamp": 1758044777023
}
HTTP请求
- GET
/api/v3/strategy/group/uid
接口权限要求: 账户信息写 / SPOT_ACCOUNT_W
权重(IP): 20
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
uid | string | yes | 账户uid,多个以,隔开 |
tradeGroupId | string | yes | 策略组id |
timestamp | long | yes | 时间戳 |
signature | string | yes | 签名 |
返回参数
参数名 | 类型 | 说明 |
---|---|---|
tradeGroupName | string | 策略组名称 |
tradeGroupId | string | 策略组id |
tradeGroupUid | string | 刚添加的账户uid,多个以,隔开 |
updateTime | long | 更新时间 |
注意事项:
- 只允许母账户操作,子账户无法访问
- 只允许添加当前母账户下的账户,无法跨母账户操作
STP策略组中删除用户
请求示例
delete /api/v3/strategy/group/uid?uid=49910594&ttradeGroupId=92×tamp={{timestamp}}&signature={{signature}}
返回示例
{
"data": true,
"code": 200,
"msg": "success",
"timestamp": 1758045403352
}
HTTP请求
- DELETE
/api/v3/strategy/group/uid
接口权限要求: 账户信息写 / SPOT_ACCOUNT_W
权重(IP): 20
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
uid | string | yes | 账户uid,多个以,隔开 |
tradeGroupId | string | yes | 策略组id |
timestamp | long | yes | 时间戳 |
signature | string | yes | 签名 |
返回参数
参数名 | 类型 | 说明 |
---|---|---|
msg | string | 删除状态 |
注意事项:
- 只允许母账户操作,子账户无法访问
- 只允许删除当前母账户下的账户,无法跨母账户操作