# chainquery Bitcoin Core getzmqnotifications

> chainquery Bitcoin Core getzmqnotifications is a paid API for AI agents from x402.chainquery.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns the active ZMQ notification endpoints configured on chainquery's independent Bitcoin full node

## Facts

- Endpoint: GET https://x402.chainquery.com/v1/rpc/getzmqnotifications
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainquery-bitcoin-core-getzmqnotifications-b70e7e33
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Wz5Ih56F6fJUdJLxz0XOO

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 chainquery-bitcoin-core-getzmqnotifications-b70e7e33
```

Example prompt: What ZMQ notification endpoints are currently active on the chainquery Bitcoin full node? I want to know which topics like rawblock or rawtx are being published and their addresses.

## When to prefer this

Use this endpoint when you need to discover the live ZMQ notification configuration of an independent Bitcoin full node without setting up your own node or managing API keys. It is the right choice when building a ZMQ subscriber and you need to programmatically find the correct addresses and topics, or when monitoring whether ZMQ is correctly configured on this specific chainquery node.

## Known failure modes

- Node temporarily unavailable: returns HTTP 5xx or RPC error
- Payment not processed: returns HTTP 402 requiring x402 payment
- Invalid request format: returns 400 if method or type fields are malformed
- ZMQ not configured: result array may be empty if node has no ZMQ endpoints active

## How this service works

chainquery Bitcoin RPC: pay-per-call Bitcoin Core over x402, no API key. Active ZMQ notification endpoints from chainquery's independent full node. Bitcoin Core getzmqnotifications.

## Output

An array of ZMQ notification objects, each containing the notification type (e.g. 'pubrawblock', 'pubrawtx'), the ZMQ address (e.g. 'tcp://0.0.0.0:28332'), and the configured high-water mark. This tells you what ZeroMQ topics the Bitcoin Core node is actively broadcasting and where to connect to subscribe to them.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 }
}
```

## 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"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "params": {
       "type": "string",
       "description": "optional: JSON-encoded array of positional RPC params"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "result": {
       "description": "getzmqnotifications result"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainquery-bitcoin-core-getzmqnotifications-b70e7e33/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.chainquery.com](https://www.zero.xyz/host/x402.chainquery.com/llms.txt)