# x402-gateway: Webhook Hook Event Poller

> x402-gateway: Webhook Hook Event Poller is a paid API for AI agents from x402.freeq.one, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Poll or drain queued POST events captured by a previously created single-use webhook hook URL

## Facts

- Endpoint: POST https://x402.freeq.one/hooks/:id/events?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-gateway-webhook-hook-event-poller-6d07a4aa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GwCNNUsuHtcBeVVFyzHEW

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 x402-gateway-webhook-hook-event-poller-6d07a4aa -d '<json body>'
```

Example prompt: Check my webhook hook abc123 for any events that have been captured, and clear the queue after reading so I start fresh next time.

## When to prefer this

Use this endpoint when you have already created a webhook hook URL via the x402-gateway webhook_catch endpoint and need to retrieve or drain the events it has captured. Ideal for polling-based async workflows where a third party POSTs data to a temporary URL and you need to read it back. Prefer over persistent webhook infrastructure when you need a quick, stateless, pay-per-call event capture pattern with no account setup.

## Known failure modes

- Invalid or expired hook ID returns empty or error result
- Hook never received any POST — result contains empty event list
- clear=true is non-idempotent: calling again after clearing returns no events
- Rate limiting or payment failure if USDC balance is insufficient
- Hook URL may have a lifetime limit — stale IDs may return no data

## How this service works

31 tools. Pay per call. No accounts. No logins. No API keys. Blockchain data, stablecoin verification, ZK proofs, QR & diagram rendering, LLM chat, gift cards, short links — settled in USDC on Base via the x402 payment protocol and Coinbase CDP facilitator.

## Output

Returns a JSON object containing all queued events that were POSTed to the specified hook URL since it was created or last cleared. If 'clear' is true, the event queue is emptied after reading. The result wraps event payloads in a result object.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "clear": {
   "type": "boolean",
   "description": "True to empty the hook after this read. Default false (events kept for re-polling)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-gateway-webhook-hook-event-poller-6d07a4aa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.freeq.one](https://www.zero.xyz/host/x402.freeq.one/llms.txt)