Returns a paginated, flat list of a user's completed on-chain claim rows for the project associated with the API key. Each row corresponds to one (transaction hash, currency) pair and includes the claim timestamp, currency details, and the summed amount claimed for that pair.

When to Use This Endpoint

• Claim history UI: Show users a list of their past on-chain claim rows for this project
• Per-currency totals: Display the amount claimed per currency for each transaction
• Reconciliation: Reconcile claim activity per (hash, currency) pair

When NOT to Use This Endpoint

• Don't use for unclaimed balances: Use GET /v1/claim-checks/totals (the unclaimed array) to see what is still claimable
• Don't use for payout-level analytics: Use GET /v1/claim-checks/rewards-payouts for per-payout breakdowns
• Don't use as a real-time poll: Claim history changes slowly; cache responses for at least 30 seconds

How It Works

Only claim checks with status = 'claimed' are included. Results are grouped by (hash, currency_id): for each on-chain transaction hash, every distinct currency settled in that transaction is its own row. Multiple claim checks of the same currency under the same hash are summed. Rows are returned in reverse-chronological order based on the most recent claim timestamp for that (hash, currency) pair.

Each row contains:

• hash: On-chain transaction hash
• claimed_at: ISO timestamp of the most recent claim check fulfilled for this (hash, currency) pair
• currency_address, currency_chain_id, currency_name, currency_decimals: Currency details
• amount: Raw summed amount across all claim checks for this (hash, currency) pair

Important Constraints

• Required API Key Scope: Standard API key (no special scope required)
• Rate Limit: 100 requests/minute (standard rate)
• Decimal handling: amount is a raw string; apply currency_decimals before displaying

Common Errors

• 400 Bad Request: Invalid user_identifier, invalid user_identifier_type, or out-of-range pagination params
• 401 Unauthorized: Missing or invalid API key
• 404 Not Found: Project not found (API key references non-existent project)
• 429 Too Many Requests: Rate limit exceeded (100 requests/minute)