# Boon Protocol Per-Handle Boon List

> Boon Protocol Per-Handle Boon List is a paid API for AI agents from api.boonprotocol.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns a chronological list of boons (onchain gratitude tips) received by a specific identity handle

## Facts

- Endpoint: GET https://api.boonprotocol.com/api/v1/handles/:handle/boons
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/boon-protocol-per-handle-boon-list-ff303ada
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rju6IRyJLus0EeNvFsl3G

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability boon-protocol-per-handle-boon-list-ff303ada
```

Example prompt: Show me the last 50 boons received by GitHub user 'vitalikbuterin' on Boon Protocol so I can see their onchain gratitude history.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Boon chronological per-handle boon list

## Output

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).

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/boon-protocol-per-handle-boon-list-ff303ada/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.boonprotocol.com](https://www.zero.xyz/host/api.boonprotocol.com/llms.txt)