Skip to main content
GET
/
reward-kit
/
boosts
Get a list of reward kit rewards
curl --request GET \
  --url https://api-v2.boost.xyz/reward-kit/boosts
{
  "boosts": [
    {
      "id": "8453:0x378632819f39c74c4f56b1429e760739c5fb51b7:1",
      "chainId": 123,
      "incentives": [
        {
          "type": "AllowListIncentive",
          "assetAddress": "0x378632819f39c74c4f56b1429e760739c5fb51b7",
          "rewardPercentage": 50,
          "rewardAmount": "<string>",
          "rewardAmountFormatted": "<string>",
          "maxReward": "<string>",
          "maxRewardUsdValue": 123,
          "rewardUsdValue": 123,
          "tokenSymbol": "<string>",
          "tokenImageUri": "<string>",
          "metadata": {
            "id": "<string>",
            "chainId": 123,
            "address": "0x378632819f39c74c4f56b1429e760739c5fb51b7",
            "decimals": 123,
            "name": "<string>",
            "symbol": "<string>",
            "imageUri": "<string>"
          }
        }
      ],
      "actionTemplate": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "projectId": "<string>",
        "actionType": "mint",
        "projectImage": "<string>",
        "description": "<string>"
      },
      "status": "active",
      "txHash": "<string>",
      "boostName": "<string>",
      "nftImageUri": "<string>",
      "nftName": "<string>",
      "tokenImageUri": "<string>",
      "blockTimestamp": "<string>",
      "projectUrl": "<string>",
      "startTime": "2023-11-07T05:31:56Z",
      "endTime": "2023-11-07T05:31:56Z",
      "claimCount": 1,
      "totalBudget": "<string>",
      "rewardsDistributed": "<string>",
      "signature": {
        "claimant": "0x378632819f39c74c4f56b1429e760739c5fb51b7",
        "incentiveId": 1,
        "signature": "<string>",
        "referrer": "0x378632819f39c74c4f56b1429e760739c5fb51b7"
      },
      "accessStatus": "allowed",
      "actionTokenMetadata": {
        "tokenSymbol": "<string>",
        "tokenContract": "0x378632819f39c74c4f56b1429e760739c5fb51b7",
        "chainId": 123,
        "tokenImage": "<string>",
        "decimals": 123,
        "marketCap": 123,
        "priceChange24Hr": 123,
        "volume24Hr": 123,
        "priceUsd": 123,
        "holders": 123
      },
      "verificationLevel": "<string>",
      "usdDistributed24Hr": 12345.67,
      "usdDistributed1Hr": 1234.56
    }
  ]
}

Query Parameters

​
page
integer | null
default:1

The desired page to return from the query

Required range: x >= 0
​
pageSize
integer | null
default:10

The amount of items to return from the query, defaults to 10, and must be <= 100

Required range: 0 <= x <= 100
​
budgetAccount
string

Filter boosts by budget account address(es). Accepts a single address or comma-separated list of addresses

Example:

"0x378632819f39c74c4f56b1429e760739c5fb51b7,0x1234567890123456789012345678901234567890"

​
owner
string

Filter boosts by a specific owner address

Pattern: ^0x[a-fA-F0-9]{40}$
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

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x378632819f39c74c4f56b1429e760739c5fb51b7"

​
tokens
string

Retrieve rewards configured with specific token addresses

Example:

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

​
distributionChannel
string

Filter boosts by comma separated list of distribution channels

Example:

"distributionChannel=public,farcaster"

​
sortBy
enum<string>

Sort by active or recently deployed

Available options:
active,
recently-deployed
​
tokenWhitelist
boolean | null
default:true

Filter boosts by token whitelist

​
creatorAddress
string

Filter rewards by the reward creator's address.

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x378632819f39c74c4f56b1429e760739c5fb51b7"

​
claimantAddress
string

Filter rewards by the address of the claimant.

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x378632819f39c74c4f56b1429e760739c5fb51b7"

​
status
enum<string>
default:claimable

Filter rewards by their status, either active, claimed, or claimable.

Available options:
active,
claimed,
claimable
​
actionType
any

Filter by the type of actions that must be taken to claim the reward, eg: "mint", "swap"

Example:

"swap,mint"

​
excludeActionType
any

Exclude rewards with these action types, eg: "mint", "swap"

Example:

"mint,create-any-token"

​
includeTokenMetadata
boolean | null

Include token metadata (price, market cap, etc.) for applicable actions. Defaults to false.

Example:

true

Response

Returns a list of RewardKit rewards

The API response for a user's RewardKit rewards

​
boosts
object[]
required

A list of RewardKit rewards that match a filter criteria