Skip to main content
POST
Settle a wallet's draws for this builder using the wallet's signature
Review the selected settlement IDs and the total in USDT with the seller before signing.Submit settlement IDs from the same pack. An ID from another pack can return HTTP 404 with EOA_PURCHASE_REJECTED before the buyback is accepted.The wallet receives USDT. The seller can complete a buyback with zero USDT balance and zero Permit2 allowance.

Request

Builder key and wallet signature

Response

Error codes

Braces in response text mark values supplied at runtime. For guidance on codes shared across endpoints, see Error meanings and recovery.
A CONTRACT_REVERT alone does not identify the cause of a transfer refusal. Check the wallet’s current offers before retrying.On HTTP 503 with OP_WALLET_BUSY, wait the number of seconds in Retry-After and resend the same signed buyback. A 404 with PERPETUAL_GACHA_SUBPACK_RECORD_NOT_FOUND can occur after the transaction confirms. Check the wallet’s activity and current offers before signing again.

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.

Body

application/json
buyerWalletAddress
string
required
cardPackId
string<uuid>
required
buybackAuth
object
required
userSignature
string
required

Response

Success

txHash
string
required

Hexadecimal string with a 0x prefix.

totalAmountInUsdt
string
required
Pattern: ^[0-9]+$
itemCount
integer
required
Required range: x >= 1