> ## Documentation Index
> Fetch the complete documentation index at: https://docs.renaiss.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# API reference

> Open the generated HTTP reference for your API deployment.

The generated OpenAPI document defines request bodies, response fields, status codes and security requirements. Use the reference served by the API deployment you call.

| Deployment | Interactive reference | OpenAPI document |
| - | - | - |
| Testnet evaluation | [Swagger](https://dev-api.renaiss.xyz/v2/docs) | [JSON](https://dev-api.renaiss.xyz/v2/openapi.json) |
| Production | [Swagger](https://api.renaiss.xyz/v2/docs) | [JSON](https://api.renaiss.xyz/v2/openapi.json) |

For API base URLs and chain selection, see [networks and contracts](/contracts#api-deployments).

## Route groups

| Section | Route prefix | Guide |
| - | - | - |
| Gacha | `/v2/gacha` | [Packs, purchases and recovery](/gacha) |
| Marketplace | `/v2/marketplace` | [Orders and trading](/marketplace) |
| Redeem | `/v2/redeem` | [Shipping checkout and tracking](/redeem) |
| Wallet sessions | `/v2/auth/wallet` | [Shipping verification](/authentication) |

## Static configuration

Use the SDK's [network constants](/contracts) for contract addresses, platform fee, cart limit and country metadata. Eligibility, shipping prices and checkout preparation come from the API.

## Errors and large values

Standard API failures use `code` and `error`. The SDK also accepts `message` as error text and exposes `code`, `status` and `detail` through `getError`. Handle machine-readable codes rather than matching message text.

Large integer fields are decimal strings in JSON. Preserve their precision when converting to SDK bigint inputs. See [amounts and IDs](/typescript-sdk#amounts-and-ids).