币币交易
查询订单详情
查询指定交易对和订单ID的订单详细信息,包含手续费信息
POST
/
platformapi
/
chainup
/
open
/
record
/
queryOrderDetail
curl --request POST \
--url http://service.xxx.com/platformapi/chainup/open/record/queryOrderDetail \
--header 'Content-Type: application/json' \
--data '{
"appKey": "{{appKey}}",
"sign": "{{sign}}",
"symbol": "btcusdt",
"orderId": "2690536306533250910"
}'{
"code": "0",
"msg": "suc",
"data": {
"orderDetail": {
"id": 2690536306533251000,
"userId": 24003817,
"side": "BUY",
"orderType": 1,
"status": 2,
"source": 6,
"symbol": "btcusdt",
"showSymbol": "BTC1/USDT4",
"price": "15078.94736842",
"volume": "0.00069808",
"avgPrice": "14873.398895549862",
"dealMoney": "10.3828223010054482",
"dealVolume": "0.00069808",
"ctime": 1745995453227,
"mtime": 1745995454000,
"feeCoin": "BTC",
"fee": "0.000002303664"
}
}
}API 说明
- 查询订单详情需要指定交易对和订单ID
- 返回结果包含手续费信息
请求参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| appKey | string | 是 | 商户唯一标识 |
| sign | string | 是 | 签名 |
| symbol | string | 是 | 交易对(如:btcusdt) |
| orderId | long | 是 | 订单ID |
请求示例
cURL
curl --request POST \
--url http://service.xxx.com/platformapi/chainup/open/record/queryOrderDetail \
--header 'Content-Type: application/json' \
--data '{
"appKey": "{your_app_key}",
"sign": "{sign}",
"symbol": "btcusdt",
"orderId": 327184612876959744
}'
响应值枚举说明:
- status(订单状态):
- 0: init(初始化)
- 1: new(新订单)
- 2: filled(完全成交)
- 3: part_filled(部分成交)
- 4: canceled(已取消)
- 5: pending_cancel(取消中)
- 6: expired(已过期)
- source(订单来源):
- 1: web
- 2: app
- 3: api
- orderType(订单类型):
- 1: 普通订单
- 2: 杠杆订单
- 3: 全仓杠杆订单
- type(委托类型):
- 1: limit(限价单)
- 2: market(市价单)
- 3: stop(止损单)
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| orderDetail | object | 订单详情 |
| └─id | string | 订单ID |
| └─userId | int | 用户ID |
| └─side | string | 交易方向(buy/sell) |
| └─orderType | int | 订单类型 |
| └─status | int | 订单状态 |
| └─source | int | 来源 |
| └─symbol | string | 交易对 |
| └─showSymbol | string | 显示的交易对名称 |
| └─price | string | 订单价格 |
| └─volume | string | 订单数量 |
| └─avgPrice | string | 平均成交价格 |
| └─dealMoney | string | 成交金额 |
| └─dealVolume | string | 成交数量 |
| └─ctime | long | 创建时间(毫秒) |
| └─mtime | long | 修改时间(毫秒) |
| └─feeCoin | string | 手续费币种 |
| └─fee | string | 手续费金额 |
响应示例
{
"code": "0",
"msg": "suc",
"data": {
"orderDetail": {
"id": 327184612876959744,
"userId": 4107676,
"side": "BUY",
"orderType": 1,
"status": 4,
"source": 1,
"symbol": "btcusdt",
"showSymbol": "BTC/USDT",
"price": "581.57",
"volume": "1",
"avgPrice": "0",
"dealMoney": "0",
"dealVolume": "0",
"ctime": 1606823070215,
"mtime": 1606823070215,
"feeCoin": "USDT",
"fee": "0.5"
}
}
}
Body
application/json
appKey
string
requiredsign
string
requiredsymbol
string
requiredorderId
string
requiredResponse
200 - application/json
code
string
requiredmsg
string
requireddata
object
requiredcurl --request POST \
--url http://service.xxx.com/platformapi/chainup/open/record/queryOrderDetail \
--header 'Content-Type: application/json' \
--data '{
"appKey": "{{appKey}}",
"sign": "{{sign}}",
"symbol": "btcusdt",
"orderId": "2690536306533250910"
}'{
"code": "0",
"msg": "suc",
"data": {
"orderDetail": {
"id": 2690536306533251000,
"userId": 24003817,
"side": "BUY",
"orderType": 1,
"status": 2,
"source": 6,
"symbol": "btcusdt",
"showSymbol": "BTC1/USDT4",
"price": "15078.94736842",
"volume": "0.00069808",
"avgPrice": "14873.398895549862",
"dealMoney": "10.3828223010054482",
"dealVolume": "0.00069808",
"ctime": 1745995453227,
"mtime": 1745995454000,
"feeCoin": "BTC",
"fee": "0.000002303664"
}
}
}