Get USDC Perpetual Settlement

Query session settlement records of USDC perpetual

HTTP Request

GET /unified/v3/private/settlement-record

Request Parameters

Parameter	Required	Type	Comments
category	true	string	Product type. linear
symbol	false	string	Symbol name
direction	false	string	prev: previous page, next: next page. Default: next
limit	false	integer	Limit for data size per page. [1, 50]. Default: 20
cursor	false	string	Cursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

Response Parameters

Parameter	Type	Comments
nextPageCursor	string	Cursor. Used to pagination
category	string	Product type
list	array	Object
> symbol	string	Symbol name
> side	string	Buy,Sell
> size	string	Position size
> sessionAvgPrice	string	Settlement price
> markPrice	string	Mark price
> realisedPnl	string	Realised PnL
> time	string	Settlement timestamp (ms)

Request Example

GET /unified/v3/private/settlement-record?category=linear&limit=1 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672020804664
X-BAPI-RECV-WINDOW: 5000

Response Example

{
    "retCode": 0,
    "retMsg": "Success",
    "result": {
        "nextPageCursor": "1516%3A0%2C1516%3A0",
        "category": "linear",
        "list": [
        {
            "realisedPnl": "0.72230000",
            "symbol": "BTCPERP",
            "side": "Buy",
            "markPrice": "19769.82000000",
            "size": "0.0100",
            "time": "1666828800000",
            "sessionAvgPrice": "19769.82000000"
        },
    ]
},
    "retExtInfo": {},
    "time": 1672020805170
}