查詢理財持倉

信息

API key需要"理財""權限

備註

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

HTTP 請求

GET /v5/earn/position

請求參數

參數	是否必需	類型	說明
category	true	string	FlexibleSaving
productId	false	string	Product ID
coin	false	string	Coin name

響應參數

參數	類型	說明
list	array	Object
> coin	string	Coin name
> productId	string	Product ID
> amount	string	Total staked amount
> totalPnl	string	Total yields
> claimableYield	string	Yield 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.

請求示例

HTTP

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

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="XXXXX",
    api_secret="XXXXX",
)
print(session.get_staked_position(
    category="FlexibleSaving",
    coin="USDT",
))

Node.js

響應示例

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