# PulseScanner Validator Entities Grouping

> PulseScanner Validator Entities Grouping is a paid API for AI agents from x402.pulsescanner.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-21).

Returns PulseChain validators grouped by withdrawal address, or blocks grouped by the graffiti they carried

## Facts

- Endpoint: GET https://x402.pulsescanner.io/v2/validators/entities?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pulsescanner-validator-entities-grouping-a658a0ce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vt20L3F2-SnZMb5xLU87D

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 pulsescanner-validator-entities-grouping-a658a0ce
```

Example prompt: Can you show me PulseChain validators grouped by withdrawal address — limit it to the top 20 entities?

## When to prefer this

Use this endpoint when you need to identify staking entities, pool operators, or block builders on PulseChain by grouping validators or blocks into clusters based on shared attributes (withdrawal address or graffiti). Prefer this over the individual validator endpoint when the goal is aggregate analysis, ownership mapping, or entity discovery rather than looking up a single validator's status.

## Known failure modes

- Invalid 'by' parameter value returns a 400 error
- Missing required query parameters may return empty or error response
- Payment not included or insufficient USDC causes 402 Payment Required
- Rate limiting or network issues may cause timeouts
- Invalid 'window' format returns a 400 bad request

## How this service works

Validators grouped by withdrawal address, or blocks grouped by the graffiti they carried. PulseChain (chain id 369). $0.003 USDC per call.

## Output

A list of grouped entities — either validators clustered by their shared withdrawal address (showing count and address per group) or blocks clustered by graffiti string, along with pagination and summary metadata for the queried window on PulseChain (chain ID 369).

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "by": {
       "type": "string"
      },
      "limit": {
       "type": "string"
      },
      "window": {
       "type": "string"
      }
     }
    }
   },
   "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/pulsescanner-validator-entities-grouping-a658a0ce/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.pulsescanner.io](https://www.zero.xyz/host/x402.pulsescanner.io/llms.txt)