Skip to main content
POST
Quote shipping for the authenticated EOA's exact cart
  • Send token IDs as decimal strings. An invalid ID such as abc can return HTTP 500 with FUNCTION_ERROR.
  • Show the courier options, handling fee, insurance and estimated duties. Duties and taxes are payable on delivery and excluded from the checkout total.
  • Save the quote ID and expiry for checkout preparation.

Request

Builder key and wallet access token

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.

Authorization
string
header
required

Wallet access token: Bearer authentication for Redeem

Body

application/json
tokenIds
string[]
required
Required array length: 1 - 50 elements
Pattern: ^\d{1,78}$
address
object
required

Response

Success

quoteId
string<uuid>
required
expiresAt
string<date-time>
required
handlingFeeInUsd
string
required

Unsigned decimal integer smaller than 2^256, encoded as a string.

Pattern: ^\d{1,78}$
couriers
object[]
required