GET
/
reward-kit
Get a user's RewardKit profile
curl --request GET \
  --url https://api-v2.boost.xyz/reward-kit
{
  "activeBoosts": [
    {
      "id": "8453:0x378632819f39c74c4f56b1429e760739c5fb51b7:1",
      "chainId": 123,
      "incentives": [
        {
          "type": "AllowListIncentive",
          "assetAddress": "0x378632819f39c74c4f56b1429e760739c5fb51b7",
          "rewardPercentage": 50,
          "rewardAmount": "<string>",
          "rewardAmountFormatted": "<string>",
          "maxReward": "<string>",
          "rewardUsdValue": 123,
          "tokenSymbol": "<string>",
          "tokenImageUri": "<string>",
          "metadata": {
            "id": "<string>",
            "chainId": 123,
            "address": "0x378632819f39c74c4f56b1429e760739c5fb51b7",
            "decimals": 123,
            "name": "<string>",
            "symbol": "<string>",
            "imageUri": "<string>"
          }
        }
      ],
      "status": "active",
      "txHash": "<string>",
      "boostName": "<string>",
      "nftImageUri": "<string>",
      "nftName": "<string>",
      "tokenImageUri": "<string>",
      "blockTimestamp": "<string>",
      "projectUrl": "<string>",
      "actionTemplate": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "projectId": "<string>",
        "actionType": "mint",
        "projectImage": "<string>"
      }
    }
  ],
  "claimedBoosts": [
    {
      "id": "8453:0x378632819f39c74c4f56b1429e760739c5fb51b7:1",
      "chainId": 123,
      "incentives": [
        {
          "type": "AllowListIncentive",
          "assetAddress": "0x378632819f39c74c4f56b1429e760739c5fb51b7",
          "rewardPercentage": 50,
          "rewardAmount": "<string>",
          "rewardAmountFormatted": "<string>",
          "maxReward": "<string>",
          "rewardUsdValue": 123,
          "tokenSymbol": "<string>",
          "tokenImageUri": "<string>",
          "metadata": {
            "id": "<string>",
            "chainId": 123,
            "address": "0x378632819f39c74c4f56b1429e760739c5fb51b7",
            "decimals": 123,
            "name": "<string>",
            "symbol": "<string>",
            "imageUri": "<string>"
          }
        }
      ],
      "status": "active",
      "txHash": "<string>",
      "boostName": "<string>",
      "nftImageUri": "<string>",
      "nftName": "<string>",
      "tokenImageUri": "<string>",
      "blockTimestamp": "<string>",
      "projectUrl": "<string>",
      "actionTemplate": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "projectId": "<string>",
        "actionType": "mint",
        "projectImage": "<string>"
      }
    }
  ],
  "claimableBoosts": [
    {
      "id": "8453:0x378632819f39c74c4f56b1429e760739c5fb51b7:1",
      "chainId": 123,
      "incentives": [
        {
          "type": "AllowListIncentive",
          "assetAddress": "0x378632819f39c74c4f56b1429e760739c5fb51b7",
          "rewardPercentage": 50,
          "rewardAmount": "<string>",
          "rewardAmountFormatted": "<string>",
          "maxReward": "<string>",
          "rewardUsdValue": 123,
          "tokenSymbol": "<string>",
          "tokenImageUri": "<string>",
          "metadata": {
            "id": "<string>",
            "chainId": 123,
            "address": "0x378632819f39c74c4f56b1429e760739c5fb51b7",
            "decimals": 123,
            "name": "<string>",
            "symbol": "<string>",
            "imageUri": "<string>"
          }
        }
      ],
      "status": "active",
      "txHash": "<string>",
      "boostName": "<string>",
      "nftImageUri": "<string>",
      "nftName": "<string>",
      "tokenImageUri": "<string>",
      "blockTimestamp": "<string>",
      "projectUrl": "<string>",
      "actionTemplate": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "projectId": "<string>",
        "actionType": "mint",
        "projectImage": "<string>"
      }
    }
  ],
  "totalClaimedAmountUsd": 1,
  "totalClaimableAmountUsd": 1
}

Query Parameters

​
budgetAccount
string

Filter boosts by a specific budget account address

Example:

"0x378632819f39c74c4f56b1429e760739c5fb51b7"

​
owner
string

Filter boosts by a specific owner address

Example:

"0x378632819f39c74c4f56b1429e760739c5fb51b7"

​
autoboostId
string

Filter boosts by a specific autoboost ID

​
chainId
integer | null

Only retrieve Boosts for a specific chain ID. You must supply this parameter if also specifying targetContract

Required range: x >= 0
​
targetContract
string

Retrieve rewards configured with actions that target a specific contract i.e., Zora's address for all rewards that require a mint in order to claim a reward. If you supply this parameter, you must also supply chainId

Example:

"0x378632819f39c74c4f56b1429e760739c5fb51b7"

​
tokens
string

Retrieve rewards configured with specific token addresses

Example:

"chainId:tokenAddress,chainId:tokenAddress:collection,..."

​
creatorAddress
string

Filter rewards by a reward's creator address

Example:

"0x378632819f39c74c4f56b1429e760739c5fb51b7"

​
claimantAddress
string

Show relevant rewards for this user's address

Example:

"0x378632819f39c74c4f56b1429e760739c5fb51b7"

Response

Returns a user's RewardKit profile

Rewards and metadata that correspond to the RewardKit for a user's address

​
activeBoosts
object[]
required

An array of active RewardKit rewards that match a filter criteria, but are not yet claimable or claimed

​
claimedBoosts
object[]
required

An array of claimed RewardKit rewards that match a filter criteria

​
claimableBoosts
object[]
required

An array of claimable RewardKit rewards that match a filter criteria

​
totalClaimedAmountUsd
number
required

The total amount of USD claimed by the user via rewards that match a filter criteria

Required range: x >= 0
​
totalClaimableAmountUsd
number
required

The total amount of USD claimable by the user via rewards that match a filter criteria

Required range: x >= 0