Claim fee rewards (batch)

Generates batch transactions to claim fee rewards from the FeesVault contract using withdrawBatch.

• If currencyAddress is provided: Claims only that specific currency across all chains
• If currencyAddress is omitted: Claims ALL currencies with claimable balances across all chains

For each chain with claimable balances, generates a single batched transaction that withdraws all applicable currencies at once. Withdraws the maximum available amount (max uint256) for each currency.

This approach minimizes the number of transactions and total gas costs compared to individual withdrawals.

POST /claim-rewards

Claim fee rewards (batch)

cURL

curl --request POST \
  --url https://api.tokenlayer.network/claim-rewards \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "currencyAddress": "<string>",
  "chains": [
    "<string>"
  ]
}
'

200

{
  "success": true,
  "transactions": [
    {
      "to": "<string>",
      "data": "<string>",
      "value": "<string>",
      "chainSlug": "<string>",
      "chainId": "<string>",
      "chainType": "evm",
      "gasLimit": "<string>",
      "description": "<string>"
    }
  ],
  "metadata": {
    "totalChainsWithBalance": 123,
    "totalCurrenciesClaimed": 123,
    "currencyAddress": "<string>"
  }
}

Authorizations

Authorization · string · header · required

JWT token or API key

Body

application/json

currencyAddress · string

chains · string[]

Response

200

application/json

Successful response

success · boolean · required

transactions · object[] · required

Show child attributes

metadata · object · required

Show child attributes