查詢 Puzzle 項目列表

查詢 Spot-X Puzzle 活動（項目）列表。結果按創建時間倒序排列（最新優先），支持游標分頁。

信息

• 無需鑒權
• 僅返回主站公開活動
• nextPageCursor 為空字符串時表示已到最後一頁

HTTP 請求

GET/v5/spot-x/puzzle/project/list

請求參數

參數	是否必須	類型	說明
status	true	integer	活動階段篩選。0: 即將開始；1: 進行中；2: 已結束
projectId	false	string	精確活動代碼，用於查詢單個項目
activityCoin	false	string	按活動幣種篩選（大小寫不敏感），如 BTC、ETH
cursor	false	string	分頁游標，傳入上一次響應中的 nextPageCursor。首頁請求無需傳入
limit	false	integer	每頁數量，默認 10，最大 10

返回參數

參數	類型	說明
list	array	當前頁的活動列表
> projectId	string	唯一活動代碼
> activityCoin	string	活動對應的幣種
> rewardCoin	string	實際發放的獎勵幣種
> status	integer	活動狀態。0: 即將開始；1: 進行中；2: 已結束
> startTime	string	活動開始時間，毫秒級 Unix 時間戳
> endTime	string	活動結束時間，毫秒級 Unix 時間戳
> totalReward	string	獎勵池總量
> participantCount	string	已報名參與人數
nextPageCursor	string	下一頁游標，為空字符串時表示已到最後一頁

---

請求示例

HTTP

GET /v5/spot-x/puzzle/project/list?status=1&limit=10 HTTP/1.1
Host: api.bybit.com

Python

Node.js

返回示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "projectId": "PUZZLE_BTC_2024Q1",
                "activityCoin": "BTC",
                "rewardCoin": "USDT",
                "status": 1,
                "startTime": "1704067200000",
                "endTime": "1706745600000",
                "totalReward": "50000",
                "participantCount": "1234"
            }
        ],
        "nextPageCursor": "eyJpZCI6MTIzfQ=="
    },
    "retExtInfo": {},
    "time": 1705000000000
}