{"uid":"cap_rju6IRyJLus0EeNvFsl3G","slug":"boon-protocol-per-handle-boon-list-ff303ada","name":"Boon Protocol Per-Handle Boon List","description":"Boon chronological per-handle boon list","url":"https://api.boonprotocol.com/api/v1/handles/:handle/boons","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["handle"],"properties":{"handle":{"type":"string","description":"GitHub handle, x:name, or agent:N ERC-8004 identity"}}},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","default":50,"maximum":200,"minimum":1}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gBwNVyWdWEnq98PnNATRN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a chronological list of boons (onchain gratitude tips) received by a specific identity handle","exampleAgentPrompt":"Show me the last 50 boons received by GitHub user 'vitalikbuterin' on Boon Protocol so I can see their onchain gratitude history.","exampleUseCases":[{"title":"Developer tip history audit","prompt":"Pull up the full boon history for GitHub handle 'torvalds' on Boon Protocol — I want to see who's been tipping them and when."},{"title":"Agent reputation check","prompt":"Look up the boon list for agent:42 on Boon Protocol and show me the most recent 20 entries — I'm trying to gauge how appreciated this agent has been."},{"title":"X user gratitude feed","prompt":"Fetch all the boons that x:elonmusk has received on Boon Protocol so I can see their chronological gratitude timeline."}],"resultDescription":"A chronologically ordered list of boon records associated with the given handle, including sender identity, tip amount, timestamp, and any associated x402 endpoint context. Returns up to 200 records per call (default 50).","failureModes":["Handle not found — returns empty list or 404 if the identity has no boon history","Invalid handle format — returns 400 if the handle doesn't match a GitHub, X, or ERC-8004 pattern","Limit out of range — returns 400 if limit is below 1 or above 200","Payment failure — x402 payment not processed, returns 402","Rate limiting — too many calls in a short window"],"whenToPreferThis":"Use this endpoint when you need the full chronological boon (onchain tip/gratitude) history for a specific identity handle — whether GitHub, X/Twitter, or an ERC-8004 agent ID. Prefer this over the endpoint recognition graph when you want per-person tip history rather than endpoint-level data, and over the directory endpoint when you want activity tied to a specific identity rather than browsing all endpoints.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:39:24.097Z","isFirstParty":false}