Skip to main content
GET
List a wallet's eligible buybacks for this builder
  1. Refresh the wallet’s offers before showing the payout.
  2. Read buybackTiers in order. The first unexpired tier’s amountInUsdt is the current price. The expiresAt of the last tier with a positive amount is the offer deadline.
  3. Have the wallet sign the reviewed offer to settle the buyback.
See buybacks and delivery for what happens to a card after the window closes.

Request

Builder key required

Response

Error codes

Match the HTTP status and response text to a row below. For guidance on codes shared across endpoints, see Error meanings and recovery.

Authorizations

x-builder-api-key
string
header
required

Your approved builder API key. Keep it on your backend. Gacha and marketplace writes also require wallet action signatures. Redeem also needs a wallet access token, a Bearer token the API issues after the wallet signs a sign-in message.

Query Parameters

buyerWalletAddress
string
required
limit
integer
default:20
Required range: 1 <= x <= 100
offset
integer | null
default:0
Required range: 0 <= x <= 10000

Response

Success

offers
object[]
required