Skip to main content

Get Position Info

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

HTTP Request

GET /v5/earn/advance/position

Request Parameters

ParameterRequiredTypeComments
categorytruestringProduct type, e.g. DualAssets
productIdfalsestringProduct ID
coinfalsestringCoin
limitfalseintNumber of items per page. Default: 20, Max: 20
cursorfalsestringPagination cursor. Use nextPageCursor from previous response

Response Parameters

ParameterTypeComments
categorystringDualAssets
nextPageCursorstringCursor for the next page. Empty string if no more data
listarrayObject
> positionIdstringPosition ID
> productIdstringProduct ID
> categorystringProduct category, DualAssets
> baseCoinstringBase coin
> quoteCoinstringQuote coin
> investCoinstringInvest coin. BuyLow: same as quoteCoin; SellHigh: same as baseCoin
> amountstringPosition amount, unit is investCoin
> apyE8stringConfirmed annualized yield in e8 precision
> directionstringDirection: BuyLow, SellHigh
> targetPricestringTarget price in USDT
> settlementTimestringSettlement time, unix timestamp in ms
> statusstringActive: Staking, Redeeming: Redeeming
> orderIdstringStaking order ID
> durationstringProduct term, e.g. 8h, 1d, 2d, 3d
> expectReturnCoinstringExpected settlement coin
> expectReturnAmountstringExpected settlement amount
> accountTypestringStaking account: FUND, UNIFIED
> toAccountTypestringSettlement account: FUND, currently only supports settlement to Fund account
> yieldStartAtint64Yield start time, unix timestamp in ms
> yieldEndAtint64Yield end time, unix timestamp in ms

Request Example

GET /v5/earn/advance/position?category=DualAssets 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": [
{
"positionId": "19035",
"productId": "36320",
"category": "DualAssets",
"baseCoin": "ETH",
"quoteCoin": "USDT",
"investCoin": "USDT",
"amount": "20",
"apyE8": "902700000",
"direction": "BuyLow",
"targetPrice": "2325",
"settlementTime": "1774079999000",
"status": "Active",
"orderId": "ef9644c2-0c98-40e5-ae33-8aa5b6d85058",
"duration": "3d",
"expectReturnCoin": "USDT",
"expectReturnAmount": "21.4838",
"accountType": "UNIFIED",
"toAccountType": "FUND",
"yieldStartAt": "1773820799000",
"yieldEndAt": "1774079999000"
}
],
"nextPageCursor": ""
},
"retExtInfo": {},
"time": 1773815399307
}