# Boon Gratitude Graph

> Boon Gratitude Graph 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-13).

Returns the gratitude graph centered on a given GitHub handle or repository, showing who has recognized whom

## Facts

- Endpoint: GET https://api.boonprotocol.com/api/v1/graphs/gratitude
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/boon-gratitude-graph-89ac9d15
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xoZTa9wFG1bvjjQDAEd41

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-gratitude-graph-89ac9d15
```

Example prompt: Can you pull up the Boon gratitude graph for the GitHub handle 'torvalds' — I want to see up to 50 recognition connections centered on that user.

## When to prefer this

Use this endpoint when you need to explore or visualize the gratitude/recognition social graph around a specific GitHub user handle or repository. Ideal for understanding contributor appreciation networks, finding who recognizes whom in open source communities, or building reputation dashboards. Prefer this over generic social graph APIs when the context is developer recognition or open source gratitude.

## Known failure modes

- Missing or malformed 'subject' query parameter returns a 400 error — subject must match pattern handle:x:<name> or repo:<owner>/<repo>
- Subject not found in the gratitude graph returns an empty graph or 404
- Limit out of range (below 1 or above 300) returns a validation error
- Payment not fulfilled (x402) results in a 402 Payment Required response
- Network or server errors return a 500 response

## How this service works

Boon gratitude graph

## Output

A gratitude graph data structure centered on the specified subject (handle or repo), showing nodes representing people or projects and edges representing gratitude/recognition events between them, up to the requested limit.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "subject"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 100,
       "maximum": 300,
       "minimum": 1
      },
      "subject": {
       "type": "string",
       "pattern": "^(?:handle:.+|repo:.+)$",
       "description": "Required graph center, such as handle:x:name or repo:owner/repo"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "edges": [
   {
    "to": "agent:42",
    "from": "0xtipper",
    "amount": "10000000"
   }
  ],
  "nodes": [
   {
    "id": "agent:42"
   }
  ],
  "center": "agent:42",
  "version": "0.1"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/boon-gratitude-graph-89ac9d15/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)