# graphadvocate.com On-chain x402 Address Settlement Summary

> graphadvocate.com On-chain x402 Address Settlement Summary is a paid API for AI agents from graphadvocate.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns lifetime settlement stats and recent payment history for a given blockchain address from the decentralized x402 Base subgraph, including role as payer and recipient.

## Facts

- Endpoint: POST https://graphadvocate.com/onchain-x402/address
- 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/graphadvocate-com-on-chain-x402-address-settlement-summary-244cf39a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZHvp36pzYHeevprjwXxIY

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 graphadvocate-com-on-chain-x402-address-settlement-summary-244cf39a -d '<json body>'
```

Example prompt: Pull the full x402 settlement summary for wallet address 0xAbc123... on Base — I want to see lifetime stats as both payer and recipient, the last 10 payments in each direction, and any facilitator info.

## When to prefer this

Use this endpoint when you need verifiable, decentralized on-chain x402 settlement data for a specific wallet address, including both payer and recipient history, without relying on a centralized database. Prefer this over /ask when you need structured JSON stats rather than natural-language answers, or when you need machine-readable data for downstream agent processing.

## Known failure modes

- Address not found or has no x402 activity — returns empty stats or zero counts
- Invalid or malformed address — returns 400 or error response
- Subgraph indexing lag — indexed_through_block may be behind latest block
- Network or subgraph unavailability — service timeout or 5xx error
- Payment failure for $0.01 USDC — request not processed if payment not settled

## How this service works

On-chain x402 settlement summary for an address from the decentralized x402 Base subgraph on The Graph Network. POST {address}. Returns lifetime stats as payer + recipient (totalPayments, totalVolume, first/last seen), recent 10 payments each direction, facilitator metadata if applicable, plus indexed_through_block for freshness. Decentralized, verifiable. Distinct from /ask. $0.01 USDC on Base.

## Output

Returns a structured JSON object with lifetime stats (totalPayments, totalVolume, firstSeen, lastSeen) for the address as both payer and recipient, the 10 most recent payments in each direction, facilitator metadata if the address is a facilitator, and an indexed_through_block field indicating data freshness. Data is sourced from the decentralized x402 Base subgraph on The Graph Network and is verifiable on-chain.

## Example request

```json
{
 "input": {
  "body": {
   "address": "0x1234567890123456789012345678901234567890"
  },
  "type": "http",
  "method": "POST",
  "bodyType": "json"
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "pattern": "^0x[a-fA-F0-9]{40}$",
   "description": "Lowercase 0x address to look up"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "graph-network:x402-base",
  "address": "0x0ff5a6ecef783bba35463ec2f8403b9b5e9e7c86",
  "as_payer": null,
  "facilitator": null,
  "is_in_index": true,
  "recent_sent": [],
  "as_recipient": {
   "totalPayments": "47",
   "totalVolumeDecimal": "0.47",
   "lastPaymentTimestamp": "1780500000"
  },
  "recent_received": [
   {
    "from": "0xab…",
    "blockNumber": "46500000",
    "amountDecimal": "0.01",
    "transferMethod": "EIP3009"
   }
  ],
  "indexer_has_errors": false,
  "indexed_through_block": 46514000,
  "indexed_through_timestamp": 1780580000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/graphadvocate-com-on-chain-x402-address-settlement-summary-244cf39a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from graphadvocate.com](https://www.zero.xyz/host/graphadvocate.com/llms.txt)