# chainquery getchaintips – Bitcoin Chain Tips via x402

> chainquery getchaintips – Bitcoin Chain Tips via x402 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-14).

Returns all known Bitcoin chain tips with their height and branch status from an independent Bitcoin Core full node, paid per call via x402.

## Facts

- Endpoint: GET https://x402.chainquery.com/v1/rpc/getchaintips
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainquery-getchaintips-bitcoin-chain-tips-via-x402-a67dbc82
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_snabAmi0Z5g0zofbMmGwg

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-getchaintips-bitcoin-chain-tips-via-x402-a67dbc82
```

Example prompt: Show me all the current chain tips on the Bitcoin network — I want to see each tip's block height and whether it's active, valid, or a stale fork, from an independent full node.

## When to prefer this

Use this endpoint when you need authoritative chain tip data from an independent Bitcoin Core full node without setting up your own node or API key, especially when diagnosing forks, reorgs, or stale chain branches in real time. Prefer it over hosted RPC aggregators when independent node verification matters.

## Known failure modes

- Node temporarily unavailable returns HTTP 503
- Payment failure or insufficient funds returns HTTP 402 with payment details
- Malformed params query string returns RPC error
- Network timeout if the full node is syncing

## How this service works

chainquery Bitcoin RPC: pay-per-call Bitcoin Core over x402, no API key. All known chain tips with height and branch status from chainquery's independent full node. Bitcoin Core getchaintips.

## Output

A JSON array of chain tip objects, each containing a block hash, height, branch length, and status string (e.g. 'active', 'valid-fork', 'valid-headers', 'headers-only', 'invalid') representing all known tips tracked by the independent Bitcoin Core node.

## Example request

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

## 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": "getchaintips result"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainquery-getchaintips-bitcoin-chain-tips-via-x402-a67dbc82/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)