The Boost API allows you to get the required signature for claiming boost incentives using the GET /signatures endpoint.

Basic Usage

Fetch a signature for claiming a boost:

const params = new URLSearchParams({
  txHash: '0x2dfc8f4f24b1a3a7ee73ea13b8a20a63fe7457d1c96b95178d3ea4126b6bf5ad',
  boostId: '8453:12'
});

const response = await fetch(
  `https://api-v2.boost.xyz/signatures?${params.toString()}`
);
const { signature, claimant, incentiveId } = await response.json();

For complete API details including all available parameters and response fields, see the API Reference.

Required Parameters

The signature endpoint validates that the transaction meets the boost’s requirements before returning a signature.

  • txHash: The transaction hash that completed the boost’s required action
  • boostId: The ID of the boost (format: chainId:boostNumber)
  • claimData: (Optional) Additional data required for variable incentive types
// Example response structure from the API
{
    "signature": "0x...",   // Signature for verification
    "claimant": "0x...",    // Address eligible to claim
    "incentiveId": 0        // ID of the claimable incentive
}

Using the Signature

Once you have the signature from the API, you can use it with the following SDK methods to claim your boost: