Skip to main content

Get Order Info

info
  • Need authentication. Up to 10 requests per second.
  • Query your Dual Assets order history. Requires Earn permission on the API key.

HTTP Request

GET /v5/earn/advance/order

Request Parameters

ParameterRequiredTypeComments
categorytruestringProduct type, e.g. DualAssets
productIdfalsestringProduct ID
orderIdfalsestringOrderId
orderLinkIdfalsestringUser customised order ID
startTimefalsestringStart time (order creation time), unix timestamp in milliseconds
endTimefalsestringEnd time, unix timestamp in milliseconds
limitfalseintNumber of items per page. Default: 20, Max: 20
cursorfalsestringPagination cursor. Use nextPageCursor from previous response

Response Parameters

ParameterTypeComments
categorystringDualAssets
nextPageCursorstringNext page cursor, empty means no more data
listarrayOrder list
> orderIdstringOrder ID
> orderLinkIdstringUser customised order ID
> productIdstringProduct ID
> categorystringProduct category,'DualAssets'
> orderTypestringStake: Subscribe
> amountstringOrder amount
> coinstringCoin name
> baseCoinstringBase coin
> quoteCoinstringQuote coin
> statusstringPending: Order confirming, Success: Order successful, position created, Settled: Position settled, Fail: Order failed
> createdTimestringCreated time, unix timestamp in ms
> updatedTimestringUpdated time, unix timestamp in ms
> directionstringBuyLow, SellHigh
> targetPricestringTarget price in USDT
> settlementTimeint64Settlement time, unix timestamp in ms
> estimateApyE8int64Estimated annualized yield, e8 precision
> durationstringProduct term, e.g. 8h, 1d, 2d, 3d
> accountTypestringAccount type
> toAccountTypestringSettlement destination account
> selectApyE8int64APY selected by user at order time, e8 precision
> isVipboolWhether it is a VIP product
> settlementCoinstringSettlement coin, Only available when status=Settled
> settlementAmountstringSettlement amount, Only available when status=Settled
> orderModestringOrder mode: Normal, RFQ
> settlementPricestringSettlement price in USDT, Only available when status=Settled
> refundStatusstringRefund status. Only valid when status=Fail, Processing, Processed
> trialBonusAmountstringTrial bonus amount
> trialBonusPnlstringTrial bonus P&L

Request Example

GET /v5/earn/advance/position?category=DualAssets&limit=2 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672280218882
X-BAPI-RECV-WINDOW: 5000

Response Example

{
"retCode": 0,
"retMsg": "",
"result": {
"category": "DualAssets",
"list": [
{
"orderId": "ef9644c2-0c98-40e5-ae33-8aa5b6d85058",
"orderLinkId": "54b3589b-da55-4b17-acdd-aa75912c9eb9",
"productId": "36320",
"category": "DualAssets",
"orderType": "Stake",
"amount": "20",
"coin": "USDT",
"baseCoin": "ETH",
"quoteCoin": "USDT",
"status": "Success",
"createdTime": "1773815357000",
"updatedTime": "1773815357000",
"direction": "BuyLow",
"targetPrice": "2325",
"settlementTime": "0",
"estimateApyE8": "771808500",
"duration": "3d",
"accountType": "UNIFIED",
"toAccountType": "",
"selectApyE8": "857565000",
"isVip": false,
"settlementCoin": "ETH",
"settlementAmount": "0",
"orderMode": "Normal",
"settlementPrice": "",
"refundStatus": "",
"trialBonusAmount": "",
"trialBonusPnl": ""
}
],
"nextPageCursor": ""
},
"retExtInfo": {},
"time": 1773815392318
}