BAM Boost API

JIP 31 BAM Early Adopter Subsidy Programme

API Endpoints

1. BAM Boost Validators

Purpose: Returns BAM boost information for all validators in a given epoch

Endpoint: /api/v1/bam_boost_validators

Method: GET

Base URL: https://kobe.mainnet.jito.network

Query Parameters

ParameterTypeRequiredDefaultDescription
epochnumberYes-Filter by specific epoch

Response Fields

The response contains a bam_boost_validators array with the following fields per entry:

FieldTypeDescription
namestring | nullValidator name (null if not set)
epochnumberEpoch number
identity_accountstringValidator identity public key
amountnumberBAM boost amount in lamports
claimedbooleanWhether the boost has been claimed
claim_status_addressstringClaim status account public key

Example Request

curl -X GET \
  https://kobe.mainnet.jito.network/api/v1/bam_boost_validators?epoch=900

Example Response

{
    "bam_boost_validators": [
        {
            "name": "IBB Club",
            "epoch": 900,
            "identity_account": "2KFrkqEeSBKEHiMjUugPxTkBJ2jXepgFBqHu5ZFxtaFg",
            "amount": 5185289422,
            "claimed": false,
            "claim_status_address": "Grhjd1iPxRbDpdcpMnHTjj6gHgPLqqny8yVzRYX1DHFk"
        },
        {
            "name": null,
            "epoch": 900,
            "identity_account": "Ha1CoNmAcbCQbg9QcCjLH79gLCqVZdxABwccQH3xexXE",
            "amount": 5243935756,
            "claimed": false,
            "claim_status_address": "58ic9vW34xN8FyPAm4guHgJxvcQ37peXJeamNjuNFVUk"
        }
    ]
}

2. Claim

Purpose: Returns the claim proof and details required to claim BAM boost rewards for a specific validator

Endpoint: /api/v1/claim/{network}/{epoch}/{identity_account}

Method: GET

Base URL: https://kobe.mainnet.jito.network

Path Parameters

ParameterTypeRequiredDescription
networkstringYesNetwork name (e.g., mainnet)
epochnumberYesEpoch number for the claim
identity_accountstringYesValidator identity public key

Response Fields

FieldTypeDescription
amountnumberClaimable amount in lamports
claimantstringPublic key of the claimant
proofnumber[][]Merkle proof as array of 32-byte arrays
merkle_rootnumber[]32-byte merkle root
distributor_addressstringMerkle distributor program address
claim_status_addressstringAccount address tracking the claim status

Example Request

curl -X GET \
  https://kobe.mainnet.jito.network/api/v1/claim/mainnet/915/5zuNci3TV79w6zLoJZzbZujMvkVZb2FcSPhgv9aT24AK

Example Response

{
    "amount": 1014322740,
    "claimant": "5zuNci3TV79w6zLoJZzbZujMvkVZb2FcSPhgv9aT24AK",
    "proof": [
        [...],
        [...]
    ],
    "merkle_root": [...],
    "distributor_address": "CCRhL2ynYebEzxLWNUHCcEXrKqmJa2jJjnZrr7bDbgnb",
    "claim_status_address": "FYvKEnv3i36SwNRwFTvAKaQH8oo1F3EFTGfVc55oVkqm"
}