Get Launchpool User History

Query the authenticated user's completed Launchpool staking position history.

info

• Authentication is required
• Returns historical (ended) staking positions, not individual transactions
• startTime and endTime filter by the staking period, not record creation time, and must be provided together

HTTP Request

POST/v5/spot-x/launchpool/user/history

Request Parameters

Parameter	Required	Type	Comments
stakeCoin	false	string	Filter by stake coin symbol, e.g. USDT
rewardCoin	false	string	Filter by reward coin symbol, e.g. BTC
startTime	false	string	Staking period start filter, 13-digit Unix timestamp in milliseconds. Filters positions whose staking start time is on or after this value. Must be used together with endTime
endTime	false	string	Staking period end filter, 13-digit Unix timestamp in milliseconds. Filters positions whose staking end time is on or before this value. Must be used together with startTime
pageSize	false	integer	Number of records per page. Default: 10. Max: 10
current	false	integer	Page number (1-based). Default: 1. Max: 100

Response Parameters

Parameter	Type	Comments
list	array	Completed staking position records for the current page
> stakeCoin	string	The coin that was staked in this position
> rewardCoin	string	The coin earned as reward
> totalReward	string	Total reward earned for this completed position
> stakeStartTime	string	Position staking start time, Unix timestamp in milliseconds
> stakeEndTime	string	Position staking end time (auto-redeem time), Unix timestamp in milliseconds
total	integer	Total number of records matching the filter
pageSize	integer	Page size used for this response
current	integer	Current page number

---

Request Example

HTTP

POST /v5/spot-x/launchpool/user/history HTTP/1.1
Host: api.bybit.com
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1705000000000
X-BAPI-RECV-WINDOW: 5000
X-BAPI-SIGN: XXXXX
Content-Type: application/json

{
    "stakeCoin": "USDT",
    "rewardCoin": "BTC",
    "pageSize": 10,
    "current": 1
}

Python

Node.js

Response Example

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "stakeCoin": "USDT",
                "rewardCoin": "BTC",
                "totalReward": "0.00250",
                "stakeStartTime": "1704067200000",
                "stakeEndTime": "1706745600000"
            },
            {
                "stakeCoin": "MNT",
                "rewardCoin": "BTC",
                "totalReward": "0.00080",
                "stakeStartTime": "1701388800000",
                "stakeEndTime": "1704067200000"
            }
        ],
        "total": 12,
        "pageSize": 10,
        "current": 1
    },
    "retExtInfo": {},
    "time": 1705000000000
}