Boon Protocol Per-Handle Boon List

Use this endpoint when you need to retrieve the full or paginated chronological boon history for a single specific handle identity (X/Twitter, GitHub, or ERC-8004 agent). Prefer this over the batch gratitude graph query when you only need data for one handle and want time-ordered results. Use this rather than the recognition graph endpoint when you care about individual boon events rather than graph-level relationships.

• Handle not found — returns empty list or 404 if the handle has no boon records
• Invalid handle format — returns 400 if handle doesn't conform to GitHub, x:name, or agent:N format
• Limit out of range — returns 400 if limit is below 1 or above 200
• Payment failure — returns 402 if the $0.01 USDC x402 payment is not completed
• Rate limiting — returns 429 if too many requests are made in a short period