> ## Documentation Index
> Fetch the complete documentation index at: https://docs.circuit.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Rewards agent SDK

> Circuit SDK reference for Merkl rewards: read what the session wallet can claim per network and reward token, and claim it.

`agent.rewards.list({ network? })` returns the session wallet's claimable Merkl rewards as Circuit last indexed them (hourly, and after each transfer into the wallet), one row per network and reward token. `network` limits the rows to one EVM network. Each row has `network`, `token` (the reward token contract, which `rewards.claim` takes in `tokens`), `asset` (the token a claim pays: the reward token, or the token a wrapped reward unwraps to), `symbol` (of `asset`, null if unknown) and `claimable` (whole units).

`agent.rewards.claim({ network, tokens? }, options?)` claims the wallet's rewards on `network` in one transaction and returns a completed operation, the same `rewardsClaim` operation Ask and the web app submit. `tokens` is one to fifty reward token contracts; leave it out to claim everything claimable on the network. Circuit reads Merkl's proofs and the Distributor's claimed amounts live when the claim commits, and refuses with `INVALID_INPUT` when nothing named is claimable or Merkl pays a reward to a recipient other than the wallet. The claimed tokens join the session that claimed them; rewards are not [holdings](https://docs.circuit.org/agent-developers/sdk-reference/holdings.md) until claimed.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.