跳至主要内容

查詢 Token Splash 項目列表

查詢 Token Splash 活動(項目)列表。結果按創建時間倒序排列(最新優先),支持游標分頁。

信息
  • 無需鑒權
  • 僅返回已發布的主站公開活動
  • nextPageCursor 為空字符串時表示已到最後一頁
  • activityEndTime = max(announceTime, tradeAnnounceTime)
  • registrationStartTime = signUpBeginTimetradeSignUpBeginTime 中非零值的最小值

HTTP 請求

GET/v5/spot-x/token-splash/project/list

請求參數

參數是否必須類型說明
statustrueinteger活動階段篩選。0: 即將開始(報名未開始);1: 進行中;2: 已結束(公告時間已過)
projectIdfalsestring精確活動代碼,用於查詢單個項目
activityCoinfalsestring按活動幣種篩選(大小寫不敏感),如 BTCETH
cursorfalsestring分頁游標,傳入上一次響應中的 nextPageCursor。首頁請求無需傳入
limitfalseinteger每頁數量,默認 10,最大 10

返回參數

參數類型說明
listarray當前頁的活動列表
> statusinteger活動狀態。0: 即將開始;1: 進行中;2: 已結束
> projectIdstring唯一活動代碼
> activityCoinstring活動對應的幣種
> rewardCoinstring實際發放的獎勵幣種。優先級順序:新池代幣 → 舊池代幣 → 交易池代幣
> totalRewardstring獎勵池總量(新池、舊池及交易池金額之和)
> participantCountstring已報名參與人數
> registrationStartTimestring最早報名開始時間,毫秒級 Unix 時間戳。等於 signUpBeginTimetradeSignUpBeginTime 中非零值的最小值
> activityEndTimestring活動結束時間,毫秒級 Unix 時間戳。等於 max(announceTime, tradeAnnounceTime)
nextPageCursorstring下一頁游標,為空字符串時表示已到最後一頁

請求示例

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

返回示例

{
"retCode": 0,
"retMsg": "OK",
"result": {
"list": [
{
"status": 1,
"projectId": "TOKENSPLASH_BTC_2024Q1",
"activityCoin": "BTC",
"rewardCoin": "USDT",
"totalReward": "100000",
"participantCount": "3456",
"registrationStartTime": "1704067200000",
"activityEndTime": "1706745600000"
}
],
"nextPageCursor": "eyJpZCI6MTIzfQ=="
},
"retExtInfo": {},
"time": 1705000000000
}