400 | API_AUTH_INVALID_INPUT | error | Request body is too large The request body exceeds 16 KiB. Send a smaller body. |
400 | CONTRACT_REVERT | error | Smart contract execution reverted
Contract error: {reason} The buyback was rejected. Read GET /v2/gacha/buyback/offers to see which collectibles are still offered, then sign again. |
400 | EOA_PURCHASE_REJECTED | error | SAFE addresses are not supported by v2 The wallet cannot be used for this buyback. Use another wallet. |
400 | GACHA_V3_BUYBACK_EXPIRED | error | Buyback has expired for {buybackId} No tier pays for a collectible now (window closed or a zero-percent hold). Read GET /v2/gacha/buyback/offers again and retry only the collectibles it returns. |
400 | GACHA_V3_BUYBACK_VERIFY_FAILED | error | Buyer does not own this card The wallet does not own a collectible in the request. Read GET /v2/gacha/buyback/offers and sign only the collectibles it returns. |
400 | GACHA_V3_TOKEN_STATUS_INVALID | error | Card is already buyback or released A collectible in the request was already sold back or sent to the wallet. Read GET /v2/gacha/buyback/offers and sign again for the collectibles that are still offered. |
400 | PERPETUAL_GACHA_PACK_VERIFY_BUYBACK_FAILED | error | Buyback token must be USDT The signed token is not USDT. Prepare the buyback again from the offers list. |
400 | WRONG_REQUEST_PARAMS | message | Bad request - invalid parameters A field is missing or has the wrong form. Fix the request and send it again. |
400 | Other code | error | Read the returned error string. |
400 | No code | text/plain | Malformed JSON in request body |
401 | API_AUTH_INVALID_CREDENTIAL | error | Invalid authentication credential The builder key is malformed, unknown, expired or revoked. Check the key. Do not retry with the same key. |
401 | API_AUTH_MISSING_CREDENTIAL | error | Required authentication credential is missing No builder key was sent. Send your builder key in the x-builder-api-key header. |
403 | API_AUTH_CREDENTIAL_NOT_ALLOWED | error | Credential is not allowed by this policy This route takes a builder key only. Remove the Authorization header and any other credential, then send the request again. |
403 | API_AUTH_INVALID_ACTION | error | Invalid wallet action proof The signature was not accepted for the wallet and the signed data, or the buyback window has closed. Read the offers again and sign the new data. For a contract wallet, its isValidSignature must return 0x1626ba7e for the EIP-712 digest of the signed data. |
403 | GACHA_V3_BUILDER_NOT_ACCEPTED_ON_PUBLIC_API | error | This builder checks out on its own surface, not on the public API This builder key cannot be used on this API. Do not retry; contact Renaiss. |
404 | EOA_PURCHASE_REJECTED | error | One or more builder draws were not found
Pack not found One or more of the collectibles were not pulled by this wallet under your builder key, or the pack was not found. Check the pack id and the settlement ids from GET /v2/gacha/buyback/offers. |
404 | GACHA_V3_DRAW_RECORD_NOT_FOUND | error | Pack draw record not found for buybackId {buybackId} A settlement ID could not be found for this pack. Refresh the offers and sign only the settlement IDs returned for that pack. |
404 | PERPETUAL_GACHA_PACK_NOT_FOUND | error | Perpetual VRF pack not found: {cardPackId} The pack could not be found. Refresh the offers and check the pack ID. |
404 | PERPETUAL_GACHA_SUBPACK_RECORD_NOT_FOUND | error | Pack draw record not found for buybackId {buybackId}
Perpetual set record not found |
404 | Other code | error | Read the returned error string. |
409 | GACHA_V3_BUYBACK_PRICE_CHANGED | error | amount {signedAmount} does not match expected total {expectedTotal} The signed amount is not the price now: a buyback tier ended after you read the offers. Read GET /v2/gacha/buyback/offers again and sign the new amount. |
409 | Other code | error | Read the returned error string. |
429 | API_AUTH_RATE_LIMITED | error | Authentication rate limit exceeded The builder key hit its rate limit. Wait a little, then retry at a lower rate. |
500 | API_AUTH_ERROR | error | Internal server error The signature could not be checked because the chain could not be read. Retry the request. |
500 | FUNCTION_ERROR | error | Internal server error |
500 | GACHA_V3_BUYBACK_SNAPSHOT_NOT_FOUND
GACHA_V3_SETTLEMENT_ID_MISMATCH
PERPETUAL_GACHA_BUYBACK_CONFIG_NOT_FOUND
PERPETUAL_GACHA_VENDING_MACHINE_ADDRESS_NOT_FOUND
GACHA_V3_BUYBACK_FAILED
GACHA_V3_TIMESTAMP_MISSING
CONTRACT_EXECUTION_ERROR
OP_WALLET_NOT_AVAILABLE
TRANSACTION_VERIFICATION_FAILED
PERPETUAL_GACHA_BUYBACK_SYNC_FAILED
INTERNAL_SERVER_ERROR | error | Internal server error Check the wallet’s offers and activity before signing again. Provide x-request-id to Renaiss if the payout remains uncertain. |
500 | Other code | error | Internal server error |
503 | OP_WALLET_BUSY | error | Payments are busy right now and nothing was charged. Please try again in a few seconds. Every payment sender is busy. Retry the request. |
503 | Other code | error | Internal server error |