跳至主要内容

查詢理財持倉

信息

API key需要"理財""權限

備註

已經完全贖回的質押同樣會顯示在持倉列表中

HTTP 請求

GET /v5/earn/position

請求參數

參數是否必需類型說明
categorytruestringFlexibleSaving
productIdfalsestringProduct ID
coinfalsestringCoin name

響應參數

參數類型說明
listarrayObject
> coinstringCoin name
> productIdstringProduct ID
> amountstringTotal staked amount
> totalPnlstringTotal yields
> claimableYieldstringYield accrues on an hourly basis and is distributed at 00:30 UTC daily. If you unstake your assets before yield distribution, any undistributed yield will be credited to your account along with your principal.

請求示例

GET /v5/earn/position?category=FlexibleSaving&coin=USDT HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: XXXXXX
X-BAPI-TIMESTAMP: 1739944576277
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

響應示例

{
"retCode": 0,
"retMsg": "",
"result": {
"list": [
{
"coin": "USDT",
"productId": "428",
"amount": "3000",
"totalPnl": "125.6208",
"claimableYield": "0"
}
]
},
"retExtInfo": {},
"time": 1739944577575
}