Loyalty SBT Data API Documentation

Host

https://rd-api-staging.tbook.com (staging) https://rd-api.tbook.com(prod)

Authentication

All API requests require the following header:

Authorization: tbk_authorization_djoi39ide2

Base URL

Staging

https://rd-api-staging.tbook.com/sbt-data

Production

https://rd-api.tbook.com/sbt-data

Get Single User SBT Data

Endpoint

GET /gonative/user

Request Parameters
Parameter
Type
Required
Description

address

string

Yes

User’s Sui wallet address

Example Request
Example Response
Response Fields

suiAddress — User wallet address

referralLink — "$baseUrl/native/incentive/$nativeCampaignId?code=$inviteCode"

claimedSocialSbts — Array of claimed social SBTs

  • level: SBT tier (1–10)

  • sbtId: Unique SBT ID

  • title: SBT title

  • taskName: Task description

claimedReferralSbts — Array of claimed referral SBTs

  • level: Referral tier (1–10)

  • sbtId: Unique referral SBT ID

  • title: Referral title (e.g., "First Invite", "Network Starter")

  • taskName: Referral task description (e.g., "Invite 3 friends to claim")

  • invitesRequired: Number of invites required for this level

  • points: Raw points for this referral SBT

invitees - An array containing information about users invited by this user

totalRawPoints — Sum of all raw SBT points

sbtCount — Total claimed SBT count

Get All Users SBT Data (Paginated)

Endpoint

GET /gonative/all-users

Request Parameters
Parameter
Type
Required
Default
Description

page

integer

No

1

Page number (starting from 1)

pageSize

integer

No

10

Items per page (range 5–20)

Example Request
Example Response
Response Fields

users

List of users, each containing:

  • suiAddress

  • sbtCount

  • totalRawPoints

  • claimedSocialSbts (same structure as the single-user API)

  • claimedReferralSbts (same structure as the single-user API)

pagination

  • currentPage — Current page number

  • pageSize — Items per page

  • totalUsers — Total number of users

  • totalPages — Total pages

Last updated