--- title: "Get events for a specific Boost" method: GET path: "/boosts/:id/activity" tags: ["Boost"] --- # Get events for a specific Boost `GET /boosts/:id/activity` Retrieve a history of claimed incentives ## Path parameters - `id` string, required — BoostID in format chainId:boostCoreAddress:identifier ## Query parameters - `page` integer, nullable — The desired page to return from the query - `pageSize` integer, nullable — The amount of items to return from the query, defaults to 10, and must be <= 100 - `claimant` string — Retrieve Boost activity for this claimant address ## Response `200` Returns a list of Boosts - object - `activityEvents` object[], required — A list of claim activity events - `claimant` string, required — The claimant's address - `blockTimestamp` string, required — The block number when this claim was made - `txHash` string, required — The claim transaction hash - `incentives` union[], required — A list of the incentives that were claimed - union - object — An incentive that when claimed, adds the claimant's address to a Boost Protocol AllowList. - `type` 'AllowListIncentive', required — The type of the incentive, in this case "AllowListIncentive" - `allowListAddress` string, required — The address of the allow list to target - `limit` string, required — The maximum number of users that can claim the incentive - object — An ERC20 incentive implementation with reward amounts adjusting dynamically based on claim volume. - `type` 'CGDAIncentive', required — The type of the incentive, in this case "CGDAIncentive" - `asset` string, required — The address of the asset to target - `initialReward` string, required — The initial reward amount that will scale over time - `rewardDecay` string, required — The amount to subtract from the current reward after each claim - `rewardBoost` string, required — The amount by which the reward increases for each hour without a claim (continuous linear increase) - `totalBudget` string, required — The total budget for the incentive - object — A simple ERC20 incentive implementation that allows claiming of tokens - `type` 'ERC20Incentive', required — The type of this incentive, in this case "ERC20Incentive" - `asset` string, required — The address of the underlying token - `strategy` number, required — The strategy for the incentive (POOL=0, RAFFLE=1) - `reward` string, required — The fixed reward amount per claim - `limit` string, required — Maximum number of claims remaining - `claimedAmount` string — The total amount of tokens claimed - `totalClaims` string — The total number of claims made - `totalAmountClaimed` string — The total amount of tokens claimed - `metadata` object, nullable — Additional metadata about the underlying token - `id` string, required — The system ID of the token - `chainId` number, required — The chain ID where this token is deployed - `address` string, required — The address of the token - `decimals` number, required — The number of decimal places for the token, typically 18 - `name` string, required — The display name for the token - `symbol` string, required — The token's symbol, "DEGEN" for example - `imageUri` string, required — A URI pointing to an image representing the token - `remainingBalance` string — The remaining balance of the underlying token for this incentive - object — A simple on-chain points incentive implementation that allows claiming of soulbound tokens - `type` 'PointsIncentive', required — The type of this incentive, in this case "PointsIncentive" - `venue` string, required — The address of the backing token contract - `selector` string, required — The function selector of the transfer function on the underlying venue contract - `reward` string, required — The fixed amount of points rewarded per claim - `limit` string, required — The maximum number of claims allowed - object — A modified ERC20 incentive implementation that allows claiming of variable token amounts with a spending limit - `type` 'ERC20VariableIncentive', required — The type of this incentive, in this case "ERC20VariableIncentive" - `asset` string, required — The address of the ERC20 token contract - `reward` string, required — The scalar value specifying how much of the claim amount is transferred to the claimant - `limit` string, required — The total amount of tokens that can be claimed - `claimedAmount` string — The total amount claimed - `totalAmountClaimed` string — The total amount claimed - `totalClaims` string — The total number of claims - `metadata` object, nullable — Additional metadata about the underlying token - `id` string, required — The system ID of the token - `chainId` number, required — The chain ID where this token is deployed - `address` string, required — The address of the token - `decimals` number, required — The number of decimal places for the token, typically 18 - `name` string, required — The display name for the token - `symbol` string, required — The token's symbol, "DEGEN" for example - `imageUri` string, required — A URI pointing to an image representing the token - `remainingBalance` string — The remaining balance of the token for this incentive - object — An ERC20 incentive with variable reward amounts - `type` 'ERC20VariableCriteriaIncentive', required — The type of the incentive, in this case, "ERC20VariableCriteriaIncentive" - `asset` string, required — The address of the ERC20 token used as the asset for the incentive - `reward` string, required — The scalar value to multiply the claim amount by - `limit` string, required — The total token budget for this incentive - `maxReward` string, required — The maximum amount of tokens that can be claimed in a single claim transaction - `criteria` object, required — Criteria determining how to extract the reward value from a transaction, by pulling a number out of either event log data or function arguments - `criteriaType` 0 | 1, required — Extract claimable amount from event data or function arguments - `signature` string, required — The 4 byte signature of the event or function - `fieldIndex` number, required — The index of the function argument, or event log to extract the numerical claimable amount - `targetContract` string, required — The target contract that contains the function or event signature - `claimedAmount` string — The amount of tokens claimed by the user - `totalAmountClaimed` string — The total amount of tokens claimed between all claims - `totalClaims` string — The total number of claims made against this incentive - `metadata` object, nullable — Optional token metadata - `id` string, required — The system ID of the token - `chainId` number, required — The chain ID where this token is deployed - `address` string, required — The address of the token - `decimals` number, required — The number of decimal places for the token, typically 18 - `name` string, required — The display name for the token - `symbol` string, required — The token's symbol, "DEGEN" for example - `imageUri` string, required — A URI pointing to an image representing the token - `remainingBalance` string — The remaining token balance for this incentive - `rebatePercentage` number — The rebate percentage for the Boost if applicable - object — An ERC20 incentive with variable reward amounts - `type` 'ERC20VariableCriteriaIncentiveV2', required — The type of incentive, in this case, "ERC20VariableCriteriaIncentiveV2" - `asset` string, required — The address of the ERC20 token used as the asset for the incentive - `reward` string, required — The scalar value to multiply the claim amount by - `limit` string, required — The total token budget for this incentive - `maxReward` string, required — The maximum amount of tokens that can be claimed in a single claim transaction - `criteria` object, required — Criteria determining how to extract the reward value from a transaction, by pulling a number out of either event log data or function arguments - `criteriaType` 0 | 1, required — Extract claimable amount from event data or function arguments - `signature` string, required — The 4 byte signature of the event or function - `fieldIndex` number, required — The index of the function argument, or event log to extract the numerical claimable amount - `targetContract` string, required — The target contract that contains the function or event signature - `valueType` 0 | 1, required — The type of value used for the scalar value (RAW or WAD). - `claimedAmount` string — The amount of tokens claimed by the user - `totalAmountClaimed` string — The total amount of tokens claimed between all claims - `totalClaims` string — The total number of claims made against this incentive - `metadata` object, nullable — Optional token metadata - `id` string, required — The system ID of the token - `chainId` number, required — The chain ID where this token is deployed - `address` string, required — The address of the token - `decimals` number, required — The number of decimal places for the token, typically 18 - `name` string, required — The display name for the token - `symbol` string, required — The token's symbol, "DEGEN" for example - `imageUri` string, required — A URI pointing to an image representing the token - `remainingBalance` string — The remaining token balance for this incentive - `rebatePercentage` number — The rebate percentage for the Boost if applicable - object — An ERC20 incentive with reward amounts pegged to the value of a configured peg asset - `type` 'ERC20PeggedIncentive', required — The type of incentive, in this case "ERC20PeggedIncentive" - `asset` string, required — The reward asset address - `peg` string, required — The address of the peg asset, zero address for the native token - `reward` string, required — The amount of the pegged asset to reward a corresponding amount of the reward asset - `limit` string, required — The total budget of the reward asset - `claimedAmount` string — The total amount of the reward asset claimed - `totalClaims` string — The total number of claims made for this incentive - `totalAmountClaimed` string — The total amount of the reward asset claimed - `metadata` object, nullable — Metadata for the reward asset - `id` string, required — The system ID of the token - `chainId` number, required — The chain ID where this token is deployed - `address` string, required — The address of the token - `decimals` number, required — The number of decimal places for the token, typically 18 - `name` string, required — The display name for the token - `symbol` string, required — The token's symbol, "DEGEN" for example - `imageUri` string, required — A URI pointing to an image representing the token - `remainingBalance` string — The remaining balance of the reward asset for this incentive - object — An ERC20 incentive with variable reward amounts pegged to the value of a configured peg asset - `type` 'ERC20PeggedVariableCriteriaIncentive', required — The incentive type, in this case "ERC20PeggedVariableCriteriaIncentive" - `asset` string, required — The address of the reward asset - `peg` string, required — The address of the peg asset - `reward` string, required — The amount to scale the pegged asset value to reward a corresponding amount of the reward asset - `limit` string, required — The total reward asset budget - `maxReward` string, required — The maximum reward asset amount that can be claimed in a single transaction - `criteria` object, required — Criteria determining how to extract the reward value from a transaction, by pulling a number out of either event log data or function arguments - `criteriaType` 0 | 1, required — Extract claimable amount from event data or function arguments - `signature` string, required — The 4 byte signature of the event or function - `fieldIndex` number, required — The index of the function argument, or event log to extract the numerical claimable amount - `targetContract` string, required — The target contract that contains the function or event signature - `claimedAmount` string — The total amount claimed - `totalAmountClaimed` string — The total amount claimed - `totalClaims` string — The total number of claims - `metadata` object, nullable — Metadata about the incentive - `id` string, required — The system ID of the token - `chainId` number, required — The chain ID where this token is deployed - `address` string, required — The address of the token - `decimals` number, required — The number of decimal places for the token, typically 18 - `name` string, required — The display name for the token - `symbol` string, required — The token's symbol, "DEGEN" for example - `imageUri` string, required — A URI pointing to an image representing the token - `remainingBalance` string — The remaining balance of the reward asset spendable by this incentive - `rebatePercentage` number — The rebate percentage for the Boost if applicable - object - `type` 'ERC20PeggedVariableCriteriaIncentiveV2', required — The incentive type, in this case "ERC20PeggedVariableCriteriaIncentiveV2" - `asset` string, required — The address of the reward asset - `peg` string, required — The address of the peg asset - `reward` string, required — The amount to scale the pegged asset value to reward a corresponding amount of the reward asset - `limit` string, required — The total reward asset budget - `maxReward` string, required — The maximum reward asset amount that can be claimed in a single transaction - `criteria` object, required — Criteria determining how to extract the reward value from a transaction, by pulling a number out of either event log data or function arguments - `criteriaType` 0 | 1, required — Extract claimable amount from event data or function arguments - `signature` string, required — The 4 byte signature of the event or function - `fieldIndex` number, required — The index of the function argument, or event log to extract the numerical claimable amount - `targetContract` string, required — The target contract that contains the function or event signature - `valueType` 0 | 1, required — The type of value used for the scalar value (RAW or WAD). - `claimedAmount` string — The total amount claimed - `totalAmountClaimed` string — The total amount claimed - `totalClaims` string — The total number of claims - `metadata` object, nullable — Metadata about the incentive - `id` string, required — The system ID of the token - `chainId` number, required — The chain ID where this token is deployed - `address` string, required — The address of the token - `decimals` number, required — The number of decimal places for the token, typically 18 - `name` string, required — The display name for the token - `symbol` string, required — The token's symbol, "DEGEN" for example - `imageUri` string, required — A URI pointing to an image representing the token - `remainingBalance` string — The remaining balance of the reward asset spendable by this incentive - `rebatePercentage` number — The rebate percentage for the Boost if applicable - `totalActivityCount` integer, required — The total number of claims ## Other responses - `404` — Not found --- [API](https://skmtc.dev/boost/apis/boost-v2-api.md) · [All operations](https://skmtc.dev/boost/apis/boost-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/boost/boost-v2-api/revisions/23f55c70a429/schema)