> ## 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. # List marketplace cards > Browse the public marketplace using storefront filters. Results include display images and prices. Send the request without credentials. Read USDT prices as integer strings with 18 decimal places and USD values as cents. Use the token ID to fetch a [card’s current orders](https://docs.renaiss.xyz/api-reference/marketplace/get-orders.md). On mainnet, an upstream failure during a mint-date search can also return HTTP `500` with `COLLECTION_QUERY_FAILED`. ## Request Public read ## 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](https://docs.renaiss.xyz/api-reference/errors.md). | HTTP | Error code | Text field | Response text and recovery | | :- | :- | :- | :- | | `400` | `WRONG_REQUEST_PARAMS` | `error` | `Invalid marketplace request` Check the query parameters or decimal token ID. | | `401` | `API_AUTH_INVALID_CREDENTIAL` | `error` | `Invalid authentication credential` A credential header is malformed. Remove credentials and retry. | | `403` | `API_AUTH_CREDENTIAL_NOT_ALLOWED` | `error` | `Credential is not allowed by this policy` Remove the credential headers and retry. | | `429` | `SUBGRAPH_RATE_LIMITED` | `error` | `Subgraph rate limited (429)` When `Retry-After` is present, wait that many seconds before fetching the next page. | | `500` | `API_AUTH_ERROR` | `error` | `Internal server error` | | `500` | `FUNCTION_ERROR` | `error` | `Internal server error` | | `500` | No code | `text/plain` | `Internal Server Error` | | `500` | `COLLECTION_QUERY_FAILED` `ALL_COLLECTIBLES_QUERY_FAILED` `SUBGRAPH_QUERY_FAILED` | `error` | `Internal server error` Read again after a short wait. | | `502` | `SUBGRAPH_NETWORK_ERROR` `SUBGRAPH_REQUEST_FAILED` `SUBGRAPH_QUERY_ERROR` | `error` | `Internal server error` Read again after a short wait. | | `502` | Other code | `error` | `Internal server error` | ## OpenAPI ````yaml api-reference/openapi.json GET /v2/marketplace openapi: 3.1.1 info: version: 1.0.0 title: Renaiss Builder API v2 description: >- Builder API v2 for gacha, marketplace and redemption with external wallets on BNB Smart Chain (chain 56). Any active, approved builder key can prepare purchases. A collectible is an item a wallet can pull, trade, sell back or redeem, such as a card. This API calls every such item a collectible (e.g. cards), in paths, fields and descriptions. Browse publicly, then prepare and sign actions with the buyer wallet. Gacha history and buyback offers require your builder key; purchases and buybacks also require a wallet action signature. Private shipping data and redemption require a wallet access token, which the API issues from a registered partner origin after the wallet signs a sign-in message. Gacha and marketplace never use a wallet access token. Keep the builder key on your backend. The acting wallet is an EOA or a deployed ERC-1271 contract account. EIP-7702 delegated accounts, ERC-6492 and ERC-8010 wrapped signatures and Renaiss-managed Safes are refused (a Safe only after its signature verified). A pull to a contract account that cannot receive ERC-721 tokens returns `CONTRACT_WALLET_CANNOT_RECEIVE_NFT`. A failed chain read returns `API_AUTH_ERROR` (500). Wallet access tokens and redemption are EOA only. servers: - url: https://api.renaiss.xyz description: BNB Smart Chain - url: https://dev-api.renaiss.xyz description: BNB testnet security: [] tags: - name: Gacha v2 description: >- Direct-EOA pack browsing, purchases, collectible (e.g. card) reveals, purchase history and buybacks. Start here; no wallet access token is needed. - name: Marketplace description: >- Public collectible (e.g. card) browsing and external-wallet asks, bids, purchases and cancellations. Trading requires builder authorization and wallet action signatures. - name: Users description: >- What one wallet address has and did: its collectibles (e.g. cards), their total market value and its activities. The whole wallet, whichever builder it used. Requires your builder key only. - name: Redemption description: >- Shipping eligibility, quotes, redemption preparation, submission and tracking. Requires your builder key and a wallet access token for the same wallet. - name: Wallet access tokens description: >- Get, refresh and revoke the wallet access tokens that Redeem needs. The wallet signs a sign-in message (valid 5 minutes, one use); the API returns a wallet access token (15 minutes) and a refresh token (7 days, single use). Register exact partner frontend origins with Renaiss before use. Gacha and marketplace never use a wallet access token. paths: /v2/marketplace: get: tags: - Marketplace summary: Browse the public marketplace description: >- Browse the public marketplace using storefront filters. Results include display images and prices. parameters: - schema: type: string minLength: 3 maxLength: 150 required: false name: search in: query - schema: type: string enum: - POKEMON - ONE_PIECE required: false name: categoryFilter in: query - schema: type: string required: false name: characterFilter in: query - schema: anyOf: - type: string enum: - '' - type: string enum: - Chinese description: >- this exists here and not in enum definition because it's not actually stored in db - type: string enum: - English - Japanese - Traditional Chinese - Simplified Chinese - Korean - Indonesian - Portuguese - Italian - German - Polish - French - Spanish required: false name: languageFilter in: query - schema: anyOf: - type: string enum: - '' - type: string enum: - PSA - BGS - CGC - SGC required: false name: gradingCompanyFilter in: query - schema: type: string required: false name: gradeFilter in: query - schema: type: string required: false name: yearRange in: query - schema: type: string required: false name: priceRangeFilter in: query - schema: type: string enum: - asc - desc default: desc required: false name: sortOrder in: query - schema: type: boolean required: false name: listedOnly in: query - schema: type: integer minimum: 1 maximum: 100 default: 25 required: false name: limit in: query - schema: type: - integer - 'null' minimum: 0 default: 0 required: false name: offset in: query - schema: type: string enum: - listDate - mintDate - name - year - priceRange - askPriceInUSDT - rixPriceInUsd default: listDate description: >- Set `sortBy` to `rixPriceInUsd` to sort collectibles by RIX price (estimated fair market value, or FMV). required: false name: sortBy in: query description: >- Set `sortBy` to `rixPriceInUsd` to sort collectibles by RIX price (estimated fair market value, or FMV). responses: '200': description: Success content: application/json: schema: type: object properties: collection: type: array items: type: object properties: tokenId: type: string description: Decimal token ID, serialized losslessly pattern: ^\d+$ name: type: string ownerAddress: type: string minLength: 42 maxLength: 42 askPriceInUSDT: type: string description: 18-decimal USDT base units, or `NO-ASK-PRICE` frontImageUrl: type: string format: uri rixPriceInUsd: type: string description: >- The RIX price is the collectible’s estimated fair market value (FMV) in USD cents. Returns `NO-RIX-PRICE` when no estimate is available. rixPriceUpdatedAt: type: - string - 'null' description: >- The time of the last update to the RIX price (estimated FMV) in `rixPriceInUsd`. Returns `null` if no timestamp is available. required: - tokenId - name - ownerAddress - askPriceInUSDT - frontImageUrl - rixPriceInUsd pagination: type: object properties: total: type: number limit: type: number offset: type: number hasMore: type: boolean required: - total - limit - offset - hasMore required: - collection - pagination '400': description: >- Invalid marketplace request. See [error codes and recovery](/api-reference/marketplace/list-cards#http-errors). content: application/json: schema: type: object properties: error: type: string description: A short sentence about what went wrong. code: type: string enum: - WRONG_REQUEST_PARAMS required: - error - code example: error: Invalid marketplace request code: WRONG_REQUEST_PARAMS '401': description: >- Malformed credential. See [error codes and recovery](/api-reference/marketplace/list-cards#http-errors). content: application/json: schema: type: object properties: error: type: string description: A short sentence about what went wrong. code: type: string enum: - API_AUTH_INVALID_CREDENTIAL required: - error - code example: error: Invalid authentication credential code: API_AUTH_INVALID_CREDENTIAL '403': description: >- This public read accepts no credentials. See [error codes and recovery](/api-reference/marketplace/list-cards#http-errors). content: application/json: schema: type: object properties: error: type: string description: A short sentence about what went wrong. code: type: string enum: - API_AUTH_CREDENTIAL_NOT_ALLOWED required: - error - code example: error: Credential is not allowed by this policy code: API_AUTH_CREDENTIAL_NOT_ALLOWED '429': description: >- Too many requests - `SUBGRAPH_RATE_LIMITED` carries a `Retry-After` header: wait that many whole seconds, then retry See [error codes and recovery](/api-reference/marketplace/list-cards#http-errors). headers: Retry-After: description: Seconds to wait before retrying when this header is present. schema: type: integer minimum: 0 content: application/json: schema: type: object properties: code: type: string enum: - SUBGRAPH_RATE_LIMITED error: type: string description: The reason for the rate limit. required: - code - error '500': description: >- A failure on our side. Retry later. See [error codes and recovery](/api-reference/marketplace/list-cards#http-errors). content: text/plain: schema: type: string example: Internal Server Error application/json: schema: type: object properties: error: type: string description: A short sentence about what went wrong. code: type: string required: - error - code example: error: Internal server error code: FUNCTION_ERROR '502': description: >- Bad gateway - an upstream dependency failed; retry later See [error codes and recovery](/api-reference/marketplace/list-cards#http-errors). content: application/json: schema: type: object properties: error: type: string code: type: string examples: - SUBGRAPH_NETWORK_ERROR - SUBGRAPH_REQUEST_FAILED - SUBGRAPH_QUERY_ERROR required: - error - code example: error: Internal server error code: SUBGRAPH_NETWORK_ERROR ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.