> ## 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. # Get a card > Look up a visible collectible by token ID to see its details, owner address and price history. Use the card’s decimal token ID and omit credentials. For pack stock or a card awaiting delivery, `ownerAddress` is the gacha inventory contract. Private reservations and buyback authorizations are excluded. The RIX price in `rixPriceInUsd` is the card’s estimated fair market value (FMV) in USD cents. Read the [order book](https://docs.renaiss.xyz/api-reference/marketplace/get-orders.md) for current asks and bids. ## 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. | | `404` | `COLLECTIBLE_NOT_FOUND` | `error` | `Collectible not found` The token id is unknown or the collectible is not available on this API. Check the token id. Do not retry with the same id. | | `500` | `API_AUTH_ERROR` | `error` | `Internal server error` | | `500` | `FUNCTION_ERROR` | `error` | `Internal server error` | | `500` | `COLLECTIBLE_GET_FAILED` `TOKEN_PRICING_QUERY_FAILED` | `error` | `Internal server error` Read again after a short wait. | | `500` | Other code | `error` | `Internal server error` | | `500` | No code | `text/plain` | `Internal Server Error` | ## OpenAPI ````yaml api-reference/openapi.json GET /v2/marketplace/collectibles/{tokenId} 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/collectibles/{tokenId}: get: tags: - Marketplace summary: Get public collectible details and price history description: >- Look up a visible collectible by token ID to see its details, owner address and price history. parameters: - schema: type: string pattern: ^\d+$ required: true name: tokenId in: path responses: '200': description: Success content: application/json: schema: type: object properties: collectible: 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` askExpiresAt: type: string frontImageUrl: type: string format: uri type: type: string enum: - POKEMON - ONE_PIECE - SPORTS description: The collectible's category. attributes: type: array items: type: object properties: key: type: string value: type: string required: - key - value description: >- The collectible's details as key and value pairs. For a card, the keys in this order: Grader, Grade, Cert Number, Year, Set, Card Number, Character, Language. A key without a value is left out. Every value is a string. 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. owner: type: - object - 'null' properties: username: type: string image: type: string format: uri required: - username backImageUrl: type: string format: uri required: - tokenId - name - ownerAddress - askPriceInUSDT - frontImageUrl - type - attributes - rixPriceInUsd - owner pricing: type: object properties: top_offer: type: - object - 'null' properties: value: type: string token: anyOf: - type: string enum: - USDT - type: string enum: - USD required: - value - token last_sale: type: - object - 'null' properties: value: type: string token: anyOf: - type: string enum: - USDT - type: string enum: - USD required: - value - token price_history: type: array items: type: object properties: timestamp: type: string amount: type: object properties: value: type: string token: anyOf: - type: string enum: - USDT - type: string enum: - USD required: - value - token required: - timestamp - amount required: - top_offer - last_sale - price_history required: - collectible - pricing '400': description: >- Invalid marketplace request. See [error codes and recovery](/api-reference/marketplace/get-card#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/get-card#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/get-card#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 '404': description: >- The collectible was not found. See [error codes and recovery](/api-reference/marketplace/get-card#http-errors). content: application/json: schema: type: object properties: error: type: string description: A short sentence about what went wrong. code: type: string enum: - COLLECTIBLE_NOT_FOUND required: - error - code example: error: Collectible not found code: COLLECTIBLE_NOT_FOUND '500': description: >- A failure on our side. Retry later. See [error codes and recovery](/api-reference/marketplace/get-card#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 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.