# Boon Batch Gratitude Graph Query

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

Batch-queries the Boon gratitude graph for multiple handles (GitHub, X/Twitter, or agent identifiers) returning their gratitude graph data up to a configurable limit

## Facts

- Endpoint: POST https://api.boonprotocol.com/api/v1/graphs/queries
- 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-batch-gratitude-graph-query-3ade283b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mjFDpZn5Ivp89cMJl8sAD

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-batch-gratitude-graph-query-3ade283b -d '<json body>'
```

Example prompt: Pull the Boon gratitude graph data for these 5 handles — github:torvalds, x:vitalikbuterin, agent:42, github:dhh, and x:pmarca — up to 200 results each, so I can see who's been recognizing them on the Boon protocol.

## When to prefer this

Use this endpoint when you need to query gratitude graph data for multiple handles in a single API call rather than making individual requests. Ideal for bulk analysis of recognition patterns across GitHub users, X/Twitter accounts, or agent identifiers on the Boon x402 protocol. Prefer this over the single-handle gratitude graph endpoint when processing lists of 2–25 identities.

## Known failure modes

- Handles array empty or missing — validation error (minItems:1 violated)
- More than 25 handles provided — request rejected (maxItems:25 exceeded)
- Invalid handle format not matching github:, x:, or agent: patterns — possible empty or error result per handle
- Limit out of range (below 1 or above 500) — validation error
- Payment not included or invalid — 402 Payment Required
- Handle not found in gratitude graph — empty result set for that handle

## How this service works

Boon batch gratitude graph query

## Output

A batch response containing gratitude graph data for each queried handle, showing recognition relationships and associated metadata, limited to the specified number of results per handle (up to 500).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 100,
   "maximum": 500,
   "minimum": 1
  },
  "handles": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 25,
   "minItems": 1,
   "description": "Handles to query (GitHub, x:name, or agent:N)"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

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