跳至主要内容

查詢倉位資訊

信息
  • API 金鑰需要具備 Earn(理財)權限。
  • 僅返回持倉中的倉位,已結算倉位不會包含在內。

HTTP 請求

GET/v5/earn/advance/position

請求參數

參數必填類型說明
categorytruestring產品類別,DiscountBuy
productIdfalsestring按產品 ID 篩選
coinfalsestring按標的資產篩選,例如:BTC
limitfalseint每頁返回數量
cursorfalsestring分頁游標,使用上次響應中的 nextPageCursor

響應參數

參數類型說明
nextPageCursorstring下一頁游標,為空字串表示無更多資料
listarray列表
> positionIdstring倉位 ID
> productIdstring產品 ID
> categorystring產品類別,DiscountBuy
> coinstring投資幣種,例如:USDT
> underlyingAssetstring標的資產,例如:BTC, ETH
> amountstring投資金額
> purchasePricestring下單時鎖定的錨定買入價
> knockoutPricestring敲出價
> knockoutCouponE8string年化息率(e8 精度),實際利率 = knockoutCouponE8 / 1e8
> statusstring倉位狀態:Active(持倉中),Settling(結算處理中)
> orderIdstring關聯訂單 ID
> durationstring產品期限,例如:7d
> settlementTimestring結算時間,毫秒級 Unix 時間戳
> accountTypestring扣款帳戶:FUND(資金帳戶),UNIFIED(統一帳戶)
> toAccountTypestring結算入帳帳戶,固定為 FUND
> settleTypestring行權結算方式:Base = 收取標的資產;Quote = 收取 USDT。敲出時此參數無效
> expectReceiveAtstring預計到帳時間,毫秒級 Unix 時間戳,等於 settlementTime + 15 分鐘

請求示例

GET /v5/earn/advance/position?category=DiscountBuy&productId=7037 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1776154219022
X-BAPI-RECV-WINDOW: 5000

響應示例

{
"retCode": 0,
"retMsg": "",
"result": {
"category": "",
"list": [
{
"positionId": "11959",
"productId": "7037",
"category": "DiscountBuy",
"coin": "USDT",
"underlyingAsset": "BTC",
"amount": "200",
"purchasePrice": "74019",
"knockoutPrice": "76050",
"knockoutCouponE8": "1000000",
"status": "Active",
"orderId": "38f6f5ce-57e2-4d69-b4d3-c39464389ccb",
"duration": "1d",
"settlementTime": "1776240000000",
"accountType": "FUND",
"toAccountType": "FUND",
"settleType": "Base",
"expectReceiveAt": "1776240900000"
}
],
"nextPageCursor": ""
},
"retExtInfo": {},
"time": 1776154219022
}