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

Retrieves a chronological list of boons (recognitions/gratuities) received by a specific GitHub, X, or agent identity handle

## Facts

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

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-3d88f147
```

Example prompt: Can you pull up the list of boons that github:velinussage has received on Boon Protocol, showing the most recent 50?

## When to prefer this

Use this endpoint when you need the full chronological boon/recognition history for a specific identity handle (GitHub, X, or ERC-8004 agent). Prefer this over the batch gratitude graph query when you need per-handle detail and timeline ordering rather than aggregate graph data. Choose this when building reputation dashboards, auditing recognition history, or verifying how much gratitude a specific developer or endpoint creator has received.

## Known failure modes

- Handle not found — returns empty list or 404 if the identity has no boon records
- Invalid handle format — error if the handle does not conform to github:name, x:name, or agent:N formats
- Limit out of range — error if limit is below 1 or above 200
- Payment failure — x402 payment of $0.01 USDC required; missing or invalid payment returns 402
- Network timeout — service unavailable responses under load

## How this service works

Boon chronological per-handle boon list

## Output

A chronological list of boon events for the requested handle, including recognition records such as sender identity, timestamp, amount, and associated endpoint or context. Returns up to the requested limit (default 50, max 200).

## 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-3d88f147/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)