Skip to main content

Make your first request

Try a public catalog request on BNB testnet. You can run it without credentials.
  1. Open the List packs playground and select the testnet server, https://dev-api.renaiss.xyz.
  2. Under Query, expand the optional fields. Set stage to active and limit to 1, then click Send.
  3. Look for cardPacks in the response. If the array contains a pack, copy its slug to get the pack details. An empty array means there are no active packs.
If you use the TypeScript client, see the SDK quickstart.

Explore the endpoints

Choose a workflow to see the sequence of calls and open each endpoint’s reference.

Packs and pulls

Browse packs, inspect their contents, prepare a pull and recover its result.

Buybacks

Find the wallet’s offers and check the status of an accepted buyback.

Marketplace

Find cards, read the order book and prepare signed orders and trades.

Wallet collections

Read the cards a wallet owns, its collection value and its activity.

Wallet access tokens

Request a sign-in message, verify the wallet and manage its shipping session.

Redeem and shipping

Find eligible cards, quote delivery, submit checkout and track an order.

Choose an environment

Use credentials, wallet signatures and contract addresses for the same environment. You can call the public catalog directly. For protected endpoints, send the x-builder-api-key header from your backend. Redeem also requires a wallet access token in the Authorization header. See authentication for the requirements by operation.

Read responses and errors

Each endpoint page includes its parameters, request or response schema, and documented HTTP status codes. Large integer values such as token IDs and USDT amounts are decimal strings. Keep them as strings or convert them to bigint when you calculate amounts. See amounts and IDs. Open the error code reference for known codes, plain-text failures and recovery steps. Each endpoint also lists its errors by HTTP status. If a submission times out after signing, use the status lookup in the gacha or redeem guide before retrying. See the API changelog for field renames, new endpoints and fixes.