现货账户与交易

下单 (TRADE)

Response ACK:

{
  "symbol": "BTCUSDT", // 交易对
  "orderId": 28, // 系统的订单ID
  "clientOrderId": "6gCrw2kRUAF9CvJDGP16IP", // 客户自己设置的ID
  "updateTime": 1507725176595, // 交易的时间戳
  "price": "0.00000000", // 订单价格
  "avgPrice": "0.0000000000000000", //平均价格
  "origQty": "10.00000000", // 用户设置的原始订单数量
  "cumQty": "0",            //累计数量
  "executedQty": "10.00000000", // 交易的订单数量
  "cumQuote": "10.00000000", // 累计交易的金额
  "status": "FILLED", // 订单状态
  "timeInForce": "GTC", // 订单的时效方式
  "stopPrice": "0",     //触发价格
  "origType": "LIMIT",  //触发前订单类型
  "type": "LIMIT", // 订单类型， 比如市价单，现价单等
  "side": "SELL", // 订单方向，买还是卖
}

POST /api/v3/order

发送下单。

权重: 1

参数:

名称	类型	是否必需	描述
symbol	STRING	YES
side	ENUM	YES	详见枚举定义：订单方向
type	ENUM	YES	详见枚举定义：订单类型
timeInForce	ENUM	NO	详见枚举定义：有效方式
quantity	DECIMAL	NO
quoteOrderQty	DECIMAL	NO
price	DECIMAL	NO
newClientOrderId	STRING	NO	客户自定义的唯一订单ID。 如果未发送，则自动生成
stopPrice	DECIMAL	NO	仅 STOP, STOP_MARKET , TAKE_PROFIT,TAKE_PROFIT_MARKET 需要此参数。

基于订单 type不同，强制要求某些参数:

类型	强制要求的参数
LIMIT	timeInForce, quantity, price
MARKET	quantity 或 quoteOrderQty
STOP和TAKE_PROFIT	quantity, price, stopPrice
STOP_MARKET和TAKE_PROFIT_MARKET	quantity, stopPrice

其他信息:

• 下MARKET SELL市价单，用户通过QUANTITY控制想用市价单卖出的基础资产数量。
• 比如在BTCUSDT交易对上下一个MARKET SELL市价单, 通过QUANTITY让用户指明想卖出多少BTC。
• 下MARKET BUY的市价单，用户使用 quoteOrderQty 控制想用市价单买入的报价资产数量，QUANTITY将由系统根据市场流动性计算出来。  * 比如在BTCUSDT交易对上下一个MARKET BUY市价单, 通过quoteOrderQty让用户选择想使用多少USDT买入BTC。
• 使用 quoteOrderQty 的市价单MARKET不会突破LOT_SIZE的限制规则; 报单会按给定的quoteOrderQty尽可能接近地被执行。
• 除非之前的订单已经成交, 不然设置了相同的newClientOrderId订单会被拒绝。

撤销订单 (TRADE)

响应

{
  "symbol": "BTCUSDT", // 交易对
  "orderId": 28, // 系统的订单ID
  "clientOrderId": "6gCrw2kRUAF9CvJDGP16IP", // 客户自己设置的ID
  "updateTime": 1507725176595, // 交易的时间戳
  "price": "0.00000000", // 订单价格
  "avgPrice": "0.0000000000000000", //平均价格
  "origQty": "10.00000000", // 用户设置的原始订单数量
  "cumQty": "0",            //累计数量
  "executedQty": "10.00000000", // 交易的订单数量
  "cumQuote": "10.00000000", // 累计交易的金额
  "status": "CANCELED", // 订单状态
  "timeInForce": "GTC", // 订单的时效方式
  "stopPrice": "0",     //触发价格
  "origType": "LIMIT",  //触发前订单类型
  "type": "LIMIT", // 订单类型， 比如市价单，现价单等
  "side": "SELL", // 订单方向，买还是卖
}

DELETE /api/v3/order

取消有效订单。

权重: 1

参数:

名称	类型	是否必需	描述
symbol	STRING	YES
orderId	LONG	NO
origClientOrderId	STRING	NO

orderId 或 origClientOrderId 必须至少发送一个

查询订单 (USER_DATA)

响应

{
    "orderId": 38,   // 系统订单号
    "symbol": "ADA25SLP25",  // 交易对
    "status": "FILLED",  // 订单状态
    "clientOrderId": "afMd4GBQyHkHpGWdiy34Li",  // 用户自定义的订单号
    "price": "20",  // 委托价格
    "avgPrice": "12.0000000000000000",  // 平均成交价
    "origQty": "10",  // 原始委托数量
    "executedQty": "10",  // 成交量
    "cumQuote": "120",  // 成交金额
    "timeInForce": "GTC",  // 有效方法
    "type": "LIMIT",  // 订单类型
    "side": "BUY",  // 买卖方向
    "stopPrice": "0",  // 触发价
    "origType": "LIMIT",  // 触发前订单类型
    "time": 1649913186270,  // 订单时间
    "updateTime": 1649913186297  // 更新时间
}

GET /api/v3/order

查询订单状态。

• 请注意，如果订单满足如下条件，不会被查询到：
  • 订单的最终状态为 CANCELED 或者 EXPIRED, 并且
  • 订单没有任何的成交记录, 并且
  • 订单生成时间 + 7天 < 当前时间

权重: 1

参数:

名称	类型	是否必需	描述
symbol	STRING	YES
orderId	LONG	NO
origClientOrderId	STRING	NO

注意:

• 至少需要发送 orderId 与 origClientOrderId中的一个

查询当前挂单 (USER_DATA)

响应

{
    "orderId": 38,   // 系统订单号
    "symbol": "ADA25SLP25",  // 交易对
    "status": "NEW",  // 订单状态
    "clientOrderId": "afMd4GBQyHkHpGWdiy34Li",  // 用户自定义的订单号
    "price": "20",  // 委托价格
    "avgPrice": "12.0000000000000000",  // 平均成交价
    "origQty": "10",  // 原始委托数量
    "executedQty": "10",  // 成交量
    "cumQuote": "120",  // 成交金额
    "timeInForce": "GTC",  // 有效方法
    "type": "LIMIT",  // 订单类型
    "side": "BUY",  // 买卖方向
    "stopPrice": "0",  // 触发价
    "origType": "LIMIT",  // 触发前订单类型
    "time": 1649913186270,  // 订单时间
    "updateTime": 1649913186297  // 更新时间
}

GET /api/v3/openOrder

查询订单状态。

权重: 1

参数:

名称	类型	是否必需	描述
symbol	STRING	YES
orderId	LONG	NO
origClientOrderId	STRING	NO

注意:

• 至少需要发送 orderId 与 origClientOrderId中的一个

当前所有挂单 (USER_DATA)

响应

[
    {
        "orderId": 349661, // 系统订单号
        "symbol": "BNBUSDT", // 交易对
        "status": "NEW", // 订单状态
        "clientOrderId": "LzypgiMwkf3TQ8wwvLo8RA", // 用户自定义的订单号
        "price": "1.10000000", // 委托价格
        "avgPrice": "0.0000000000000000", // 平均成交价
        "origQty": "5",  // 原始委托数量
        "executedQty": "0", // 成交量
        "cumQuote": "0", // 成交金额
        "timeInForce": "GTC", // 有效方法
        "type": "LIMIT", // 订单类型
        "side": "BUY",   // 买卖方向
        "stopPrice": "0", // 触发价
        "origType": "LIMIT", // 触发前订单类型
        "time": 1756252940207, // 订单时间
        "updateTime": 1756252940207, // 更新时间
    }
]

GET /api/v3/openOrders

获取交易对的所有当前挂单， 请小心使用不带交易对参数的调用。

权重: - 带symbol 1 - 不带 40  

参数:

名称	类型	是否必需	描述
symbol	STRING	NO

• 不带symbol参数，会返回所有交易对的挂单

取消当前所有挂单 (USER_DATA)

响应

{
    "code": 200,
    "msg": "The operation of cancel all open order is done."
}

DEL /api/v3/allOpenOrders

权重: - 1

参数:

名称	类型	是否必需	描述
symbol	STRING	YES
orderIdList	STRING	NO	id数组字符串
origClientOrderIdList	STRING	NO	clientOrderId数组字符串

查询所有订单 (USER_DATA)

响应

[
    {
        "orderId": 349661, // 系统订单号
        "symbol": "BNBUSDT", // 交易对
        "status": "NEW", // 订单状态
        "clientOrderId": "LzypgiMwkf3TQ8wwvLo8RA", // 用户自定义的订单号
        "price": "1.10000000", // 委托价格
        "avgPrice": "0.0000000000000000", // 平均成交价
        "origQty": "5",  // 原始委托数量
        "executedQty": "0", // 成交量
        "cumQuote": "0", // 成交金额
        "timeInForce": "GTC", // 有效方法
        "type": "LIMIT", // 订单类型
        "side": "BUY",   // 买卖方向
        "stopPrice": "0", // 触发价
        "origType": "LIMIT", // 触发前订单类型
        "time": 1756252940207, // 订单时间
        "updateTime": 1756252940207, // 更新时间
    }
]

GET /api/v3/allOrders

获取所有帐户订单； 有效，已取消或已完成。

• 请注意，如果订单满足如下条件，不会被查询到：
  • 订单生成时间 + 7天 < 当前时间

权重: 5

参数:

名称	类型	是否必需	描述
symbol	STRING	YES
orderId	LONG	NO
startTime	LONG	NO
endTime	LONG	NO
limit	INT	NO	默认 500; 最大 1000.

• 查询时间范围最大不得超过7天
• 默认查询最近7天内的数据

GET /api/v3/prediction/transactionHistory

响应

[
   {
    "tranId": 1759115482304540227, //划转ID
    "tradeId": null,               //流水ID 
    "asset": "ASTER",              //资产
    "symbol": "",                  //交易对
    "balanceDelta": "-500.00000000", //资金流数量，正数代表流入，负数代表流出
    "balanceInfo": "TRADE_SOURCE",   //流水描述 
    "time": 1759115482000,       // 时间
    "type": "TRADE_SOURCE"      //资金流类型
   }
]

查询交易流水

权重: 30

参数:

名称	类型	是否必需	描述
asset	STRING	NO	资产
type	STRING	NO	类别
startTime	LONG	NO	开始时间
endTime	LONG	NO	结束时间
limit	LONG	NO	返回的结果集数量 默认值:100 最大值:1000

注意:

• type 取值 TRADE_TARGET,TRADE_SOURCE,TRANSFER_SPOT_TO_FUTURE,TRANSFER_FUTURE_TO_SPOT,TRANSFER_SPOT_TO_SPOT,AIRDROP,DIVIDEND,TRANSFER_REFUND,INTERNAL_TRANSFER,TRANSFER,SWAP,COMMISSION_REBATE,CASH_BACK,STAKING_WITHDRAW, STAKING_CLAIM, STAKING_DELEGATE,PREDICTION_CLAIM,PREDICTION_USER_REBATE,PREDICTION_SETTLE,PREDICTION_SETTLE_FEE,PREDICTION_MINT,PREDICTION_BURN 中的一种
• 如果startTime 和 endTime 均未发送, 只会返回最近7天的数据。

期货现货互转 (TRADE)

响应:

{
    "tranId": 21841, //交易id
    "status": "SUCCESS" //状态
}

POST /api/v3/asset/wallet/transfer

权重: 5

参数:

名称	类型	是否必需	描述
amount	DECIMAL	YES	数量
asset	STRING	YES	资产
clientTranId	STRING	YES	交易id
kindType	STRING	YES	交易类型

注意: * kindType 取值为FUTURE_SPOT(期货转现货),SPOT_FUTURE(现货转期货)

预测市场铸造 (TRADE)

响应

{
    "clientOrderId": "xxx",        // 客户自定义订单ID
    "quoteAmount": "10.00000000",  // 花费的报价资产总量
    "yesPrice": "0.55000000",      // 铸造时YES代币的价格
    "noPrice": "0.45000000",       // 铸造时NO代币的价格（yesPrice + noPrice = 1）
    "pairCount": "10.00000000"     // 已铸造的YES+NO代币对数量
}

POST /api/v3/prediction/mint

为预测市场铸造 YES+NO 代币对。铸造时系统按当前市场价格扣除等值报价资产，同时向账户发放等量的 YES 和 NO 代币。

权重: 1

参数:

名称	类型	是否必需	描述
symbol	STRING	YES	预测市场的 YES 代币交易对
quantity	DECIMAL	YES	铸造的 YES+NO 代币对数量
newClientOrderId	STRING	NO	客户自定义的唯一订单ID，若不填则自动生成

注意: * symbol 必须是有效的预测市场代币交易对，且状态为 TRADING 或 PENDING_TRADING * quantity 表示同时铸造的 YES 和 NO 代币对数量，铸造后账户将获得等量的 YES 代币和 NO 代币 * yesPrice + noPrice = 1（报价资产单位）

预测市场销毁 (TRADE)

响应

{
    "clientOrderId": "xxx",        // 客户自定义订单ID
    "quoteAmount": "9.80000000",   // 销毁后返还的报价资产总量
    "yesPrice": null,              // 销毁操作不返回价格
    "noPrice": null,               // 销毁操作不返回价格
    "pairCount": "10.00000000"     // 已销毁的YES+NO代币对数量
}

POST /api/v3/prediction/burn

销毁等量的 YES+NO 代币对，赎回相应的报价资产。账户需同时持有等量的 YES 代币和 NO 代币才可销毁。

权重: 1

参数:

名称	类型	是否必需	描述
symbol	STRING	YES	预测市场的 YES 代币交易对
quantity	DECIMAL	YES	销毁的 YES+NO 代币对数量
newClientOrderId	STRING	NO	客户自定义的唯一订单ID，若不填则自动生成

注意: * symbol 必须是有效的预测市场代币交易对，且状态为 TRADING、PENDING_TRADING 或 CLOSED * quantity 表示同时销毁的 YES 和 NO 代币对数量，账户需同时持有对应数量的 YES 代币和 NO 代币 * 销毁操作响应中 yesPrice 和 noPrice 为 null * 市场关闭（CLOSED）后仍可进行销毁操作

预测市场拆分 (TRADE)

响应

{
 "clientOrderId": "xxx",
 "qty": "10.00000000",
 "counterparties": [
 {
 "symbol": "EVENT4_ALGERIA_WIN_YUSDT",
 "price": "0.15000000"
 },
 {
 "symbol": "EVENT4_ARGENTINA_WIN_YUSDT",
 "price": "0.25000000"
 }
 ],
 "sourceNoLastPrice": "0.85000000"
}

POST /api/v3/prediction/split

对于多结果预测事件，将报价资产（USDT）转换为指定预测市场的结果代币。账户花费报价资产，获得目标市场等量的各结果代币。

权重: 1

参数:

名称	类型	是否必需	描述
event	STRING	YES	预测事件名称（如 EVENT4）
symbol	STRING	YES	目标预测市场的 YES 或 NO 代币交易对
quantity	DECIMAL	YES	要获取的结果代币组数；必须为正整数
newClientOrderId	STRING	NO	客户自定义的唯一订单ID，若不填则自动生成
signer	STRING	YES	API钱包地址
nonce	STRING	YES	当前时间的微秒值
signature	STRING	YES	签名

注意: * symbol 必须是有效的预测市场代币交易对（YES 或 NO 均可），且状态为 TRADING 或 PENDING_TRADING；系统会自动解析对应的 YES 代币 * quantity 必须为整数，不含小数 * counterparties 包含参与拆分的各结果代币及其价格 * sourceNoLastPrice 为拆分时来源交易对 NO 代币的最新价格

预测市场合并 (TRADE)

响应

{
 "clientOrderId": "xxx",
 "qty": "10.00000000",
 "counterparties": [
 {
 "symbol": "EVENT4_ALGERIA_WIN_YUSDT",
 "price": "0.15000000"
 },
 {
 "symbol": "EVENT4_ARGENTINA_WIN_YUSDT",
 "price": "0.25000000"
 }
 ]
}

POST /api/v3/prediction/merge

对于多结果预测事件，将一组结果代币退回以赎回报价资产（USDT）。账户提交事件中所有结果代币的等量份额，换回报价资产。

权重: 1

参数:

名称	类型	是否必需	描述
event	STRING	YES	预测事件名称（如 EVENT4）
quantity	DECIMAL	YES	要提交的结果代币组数；必须为正整数
newClientOrderId	STRING	NO	客户自定义的唯一订单ID，若不填则自动生成
signer	STRING	YES	API钱包地址
nonce	STRING	YES	当前时间的微秒值
signature	STRING	YES	签名

注意: * 账户必须持有足够数量的该事件所有结果代币 * quantity 必须为整数，不含小数 * 响应中的 qty 以报价资产（USDT）计价 * counterparties 包含合并过程中消耗的各结果代币及其价格

查询预测市场当前仓位 (USER_DATA)

响应

[
  {
    "marketName": "BTC_UP_DOWN_20260512",      // 预测市场名称
    "symbol": "BTC_UP_DOWN_20260512YES",        // 交易对
    "assetName": "USDT",                        // 结算资产
    "type": "YES",                              // 持仓方向: "YES" 或 "NO"
    "openAvgPrice": "0.65000000",               // 开仓均价
    "cumQty": "100.00000000",                   // 持仓总数量
    "closeAvgPrice": "0.00000000",              // 平仓均价（尚未平仓则为0）
    "realizedPnl": "0.00000000",                // 已实现盈亏
    "closeQty": "0.00000000",                   // 已平仓数量
    "insertTime": 1747000000000,                // 开仓时间（毫秒时间戳）
    "commissionFee": "0.10000000",              // 手续费
    "commissionAsset": "USDT",                  // 手续费资产
    "balance": "65.00000000",                   // 仓位价值（持仓数量 × 开仓均价）
    "availableBalance": "65.00000000",          // 可用余额
  }
]

GET /api/v3/prediction/positions

查询当前账户的预测市场持仓列表。

权重: 1

参数:

名称	类型	是否必需	描述
symbol	STRING	NO	交易对，不传则返回所有持仓
signer	STRING	YES	API钱包地址
nonce	STRING	YES	当前时间的微秒值
signature	STRING	YES	签名

查询预测市场历史仓位 (USER_DATA)

响应

[
  {
    "marketName": "BTC_UP_DOWN_20260501",       // 预测市场名称
    "symbol": "BTC_UP_DOWN_20260501YES",        // 交易对
    "asset": "USDT",                            // 结算资产
    "type": "YES",                              // 持仓方向: "YES" 或 "NO"
    "openAvgPrice": "0.72000000",               // 开仓均价
    "cumQty": "200.00000000",                   // 持仓总数量
    "closeAvgPrice": "1.00000000",              // 平仓均价
    "realizedPnl": "56.00000000",               // 已实现盈亏
    "closeQty": "200.00000000",                 // 已平仓数量
    "insertTime": 1746000000000,                // 开仓时间（毫秒时间戳）
    "closeTime": 1746086400000,                 // 平仓/结算时间（毫秒时间戳）
    "status": "settled",                        // 仓位状态: "close"（手动平仓）或 "settled"（市场结算）
    "commissionFee": "0.10000000",              // 手续费
    "commissionAsset": "USDT",                  // 手续费资产
    "settleFee": "2.00000000",                  // 结算手续费（仅 status 为 "settled" 时存在）
    "settleAsset": "USDT",                      // 结算手续费资产
  }
]

GET /api/v3/prediction/positionHistories

查询当前账户的预测市场历史仓位列表（已平仓或已结算）。

权重: 1

参数:

名称	类型	是否必需	描述
symbol	STRING	NO	交易对，不传则返回所有历史仓位
startTime	LONG	NO	开始时间（毫秒时间戳）
endTime	LONG	NO	结束时间（毫秒时间戳）
limit	INT	NO	返回数量，默认100，最大1000
signer	STRING	YES	API钱包地址
nonce	STRING	YES	当前时间的微秒值
signature	STRING	YES	签名

注意: * startTime 与 endTime 同时传入时，startTime 不得大于 endTime * limit 取值范围为 1 ~ 1000，默认值为 100 * status 字段说明: close 表示用户手动平仓，settled 表示预测市场到期结算

查询预测市场结算历史 (USER_DATA)

响应

[
  {
    "marketName": "BTC_UP_DOWN_20260501",       // 预测市场名称
    "asset": "BTC_UP_DOWN_20260501YES",          // 代币资产（YES 或 NO 代币）
    "symbol": "BTC_UP_DOWN_20260501YES",         // 交易对
    "marketStartTime": 1746000000000,            // 市场开始时间（毫秒时间戳）
    "marketEndTime": 1746086400000,              // 市场结束/结算时间（毫秒时间戳）
    "shareAmount": "200.00000000",               // 结算时持有的份额数量
    "settleAsset": "USDT",                       // 结算资产
    "settleAmount": "200.00000000",              // 结算获得金额
    "settleFeeAmount": "2.00000000",             // 结算手续费
    "entryPrice": "0.72000000",                  // 平均入场价格
    "settlePrice": "1.00000000",                 // 最终结算价格
    "realizedPnl": "56.00000000",                // 结算后已实现盈亏
    "status": "settled"                          // 结算状态
  }
]

GET /api/v3/prediction/settlementHistories

查询当前账户的预测市场结算历史（已到期结算的市场）。

权重: 1

参数:

名称	类型	是否必需	描述
symbol	STRING	NO	交易对，不传则返回所有结算记录
startTime	LONG	NO	按市场开始时间过滤（毫秒时间戳）
endTime	LONG	NO	按市场结束时间过滤（毫秒时间戳）
limit	INT	NO	返回数量，默认100，最大1000
signer	STRING	YES	API钱包地址
nonce	STRING	YES	当前时间的微秒值
signature	STRING	YES	签名

注意: * startTime 与 endTime 同时传入时，startTime 不得大于 endTime * limit 取值范围为 1 ~ 1000，默认值为 100 * settleAmount 为结算总收入，realizedPnl = settleAmount 减去成本 * settleFeeAmount 从结算收入中扣除

现货提现手续费 (NONe)

响应

{
  "tokenPrice": 1.00019000,
   "gasCost": 0.5000,
  "gasUsdValue": 0.5
}

GET /api/v3/aster/withdraw/estimateFee

权重: 1

参数:

名称	类型	是否必需	描述
chainId	STRING	YES
asset	STRING	YES

注意: * chainId: 1(ETH),56(BSC),42161(Arbi) * gasCost: 提现所需的最少数量的手续费

现货提现 (USER_DATA)

响应

{
  "withdrawId": "1014729574755487744",
  "hash":"0xa6d1e617a3f69211df276fdd8097ac8f12b6ad9c7a49ba75bbb24f002df0ebb"
}

POST /api/v3/aster/user-withdraw

权重: 5

参数:

名称	类型	是否必需	描述
chainId	STRING	YES
asset	STRING	YES
amount	STRING	YES
fee	STRING	YES
receiver	STRING	YES
nonce	STRING	YES	当前时间的微秒值
userSignature	STRING	YES

注意: * chainId: 1(ETH),56(BSC),42161(Arbi) * receiver : 当前账户的地址 * 如果期货余额不足，会从spot账户划转到期货账户，进行提现 * userSignature demo

const domain = {
    name: 'Aster',
    version: '1',
    chainId: 56,
    verifyingContract: ethers.ZeroAddress,
  }

const currentTime = Date.now() * 1000

const types = {
    Action: [
        {name: "type", type: "string"},
        {name: "destination", type: "address"},
        {name: "destination Chain", type: "string"},
        {name: "token", type: "string"},
        {name: "amount", type: "string"},
        {name: "fee", type: "string"},
        {name: "nonce", type: "uint256"},
        {name: "aster chain", type: "string"},
    ],
  }
  const value = {
    'type': 'Withdraw',
    'destination': '0xD9cA6952F1b1349d27f91E4fa6FB8ef67b89F02d',
    'destination Chain': 'BSC',
    'token': 'USDT',
    'amount': '10.123400',
    'fee': '1.234567891',
    'nonce': currentTime,
    'aster chain': 'Mainnet',
  }


const signature = await signer.signTypedData(domain, types, value)

账户信息 (USER_DATA)

响应

{     
   "feeTier": 0,
   "canTrade": true,
   "canDeposit": true,
   "canWithdraw": true,
   "canBurnAsset": true,
   "updateTime": 0,
   "balances": [
    {
      "asset": "BTC",
      "free": "4723846.89208129",
      "locked": "0.00000000"
    },
    {
      "asset": "LTC",
      "free": "4763368.68006011",
      "locked": "0.00000000"
    }
  ]
}

GET /api/v3/account

获取当前账户信息。

权重: 5

参数:

名称	类型	是否必需	描述

账户成交历史 (USER_DATA)

响应

[ 
  {
    "symbol": "BNBUSDT",
    "id": 1002,
    "orderId": 266358,
    "side": "BUY",
    "price": "1",
    "qty": "2",
    "quoteQty": "2",
    "commission": "0.00105000",
    "commissionAsset": "BNB",
    "time": 1755656788798,
    "counterpartyId": 19,
    "createUpdateId": null,
    "maker": false,
    "buyer": true
  }
] 

GET /api/v3/userTrades

获取账户指定交易对的成交历史

权重: 5

参数:

名称	类型	是否必需	描述
symbol	STRING	NO
orderId	LONG	NO	必须要和参数symbol一起使用.
startTime	LONG	NO
endTime	LONG	NO
fromId	LONG	NO	起始Trade id。 默认获取最新交易。
limit	INT	NO	默认 500; 最大 1000.

• 如果startTime 和 endTime 均未发送, 只会返回最近7天的数据。
• startTime 和 endTime 的最大间隔为7天
• 不能同时传fromId与startTime 或 endTime      

---