List wallet activity

List what a wallet did with collectibles on chain

curl --request GET \
  --url https://api.renaiss.xyz/v2/users/{walletAddress}/activities \
  --header 'x-builder-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-builder-api-key': '<api-key>'}};

fetch('https://api.renaiss.xyz/v2/users/{walletAddress}/activities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "activities": [
    {
      "user": "<string>",
      "timestamp": "<string>",
      "blockNumber": "<string>",
      "txHash": "<string>",
      "type": "gacha-v3-pull",
      "contractAddress": "<string>",
      "packId": "<string>",
      "token": "<string>",
      "checkoutIds": [
        "<string>"
      ],
      "totalAmount": "<string>",
      "blockHash": "<string>",
      "collectibles": [
        {
          "type": "POKEMON",
          "name": "<string>",
          "frontImageUrl": "<string>",
          "tokenId": "<string>",
          "subtitle": "<string>",
          "buybackBaseValueInUsd": "<string>",
          "buybackBonus": {
            "originalBuybackBaseValueInUSD": "<string>",
            "bonusBps": 123
          }
        }
      ]
    }
  ],
  "nextCursor": "<string>"
}

{
  "code": "WRONG_REQUEST_PARAMS",
  "message": "Bad request - invalid parameters"
}

{
  "error": "Required authentication credential is missing",
  "code": "API_AUTH_MISSING_CREDENTIAL"
}

{
  "error": "Credential is not allowed by this policy",
  "code": "API_AUTH_CREDENTIAL_NOT_ALLOWED"
}

{
  "error": "Authentication rate limit exceeded",
  "code": "API_AUTH_RATE_LIMITED"
}

Internal Server Error

GET

users

{walletAddress}

activities

List what a wallet did with collectibles on chain

curl --request GET \
  --url https://api.renaiss.xyz/v2/users/{walletAddress}/activities \
  --header 'x-builder-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-builder-api-key': '<api-key>'}};

fetch('https://api.renaiss.xyz/v2/users/{walletAddress}/activities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "activities": [
    {
      "user": "<string>",
      "timestamp": "<string>",
      "blockNumber": "<string>",
      "txHash": "<string>",
      "type": "gacha-v3-pull",
      "contractAddress": "<string>",
      "packId": "<string>",
      "token": "<string>",
      "checkoutIds": [
        "<string>"
      ],
      "totalAmount": "<string>",
      "blockHash": "<string>",
      "collectibles": [
        {
          "type": "POKEMON",
          "name": "<string>",
          "frontImageUrl": "<string>",
          "tokenId": "<string>",
          "subtitle": "<string>",
          "buybackBaseValueInUsd": "<string>",
          "buybackBonus": {
            "originalBuybackBaseValueInUSD": "<string>",
            "bonusBps": 123
          }
        }
      ]
    }
  ],
  "nextCursor": "<string>"
}

{
  "code": "WRONG_REQUEST_PARAMS",
  "message": "Bad request - invalid parameters"
}

{
  "error": "Required authentication credential is missing",
  "code": "API_AUTH_MISSING_CREDENTIAL"
}

{
  "error": "Credential is not allowed by this policy",
  "code": "API_AUTH_CREDENTIAL_NOT_ALLOWED"
}

{
  "error": "Authentication rate limit exceeded",
  "code": "API_AUTH_RATE_LIMITED"
}

Internal Server Error

Read an event. Each entry is one on-chain event for the exact address, including mints, deliveries and redemption burns. Query a signer and its Safe separately. Renaiss custody wallets return no activity. Events for packs closed to your key are omitted.

Event detail	How to use it
Pack or settlement ID	Match a pull’s pack ID to `onChainPackId` in the pack catalog. Match a buyback’s IDs to `settlementId` in your wallet pull history.
`collectibles[]`	Your resolved draws can include card details immediately. Another builder’s ordinary v3 draw can include them after its original buyback window closes and delivery or buyback is confirmed. Limited-pack links stay visible only to the seller. Storefront draws show chain data only.
Amounts	The event amount is the total. Each eligible card can show its original `buybackBaseValueInUsd` in cents. On a buyback, `buybackPaidInUsdt` uses 18-decimal units and can be `null`.

Page through results. Send nextCursor as the next request’s cursor, even after an empty page. Stop when it is null. A transaction with several events can span pages.

Request

Builder key required

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.

HTTP	Error code	Text field	Response text and recovery
`400`	`WRONG_REQUEST_PARAMS`	`message`	`Bad request - invalid parameters` A field is missing, unknown or has the wrong form. Fix the request and send it again.
`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`	`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.
`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`
`500`	`FUNCTION_ERROR`	`error`	`Internal server error`
`500`	`ACTIVITY_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`

Authorizations

x-builder-api-key

string

header

required

Your approved builder API key. Keep it on your backend. Gacha and marketplace writes also require wallet action signatures. Redeem also needs a wallet access token, a Bearer token the API issues after the wallet signs a sign-in message.

Path Parameters

walletAddress

string

required

The wallet to read. Exactly this address.

Query Parameters

filter

enum<string>

default:all

Only this kind of activity. Every kind when all.

Available options:

all,

gacha-v3-pull,

gacha-v3-buyback,

gacha-v3-release-token,

buy,

sell,

transfer,

mint,

burn

cursor

string

Pattern: ^\d+$

limit

integer

default:20

Required range: 1 <= x <= 50

Response

Success

activities

object[]

required

Show child attributes

nextCursor

string | null

required

Getting started

Gacha

Marketplace

Wallet collections

Redeem and shipping

Developer resources

Partner integrations

List wallet activity

Request

Response

Error codes

Authorizations

Path Parameters

Query Parameters

Response