# nostr.watch: Nostr relay monitor

nostr.watch is a free, open-source monitor for Nostr relays. Monitors in several regions check relays every hour for connectivity, read and write support, latency, SSL and DNS, and publish the results as [NIP-66](https://github.com/nostr-protocol/nips/blob/master/66.md) events.

Relay data on https://nostr.watch loads in the browser. For programmatic access use one of the services below.

## Data services

| Service              | URL                                                                              | Use it for                                           |
| -------------------- | -------------------------------------------------------------------------------- | ---------------------------------------------------- |
| REST API v2          | https://api.nostr.watch/v2/                                                      | HTTP + JSON, OpenAPI docs and sandbox                |
| CVM (MCP over Nostr) | https://cvm.nostr.watch                                                          | 21 MCP tools for AI agents and MCP clients           |
| Raw NIP-66 events    | `wss://relay.nostr.watch`, `wss://relaypag.es`, `wss://monitorlizard.nostr1.com` | Trustless access; verify monitor signatures yourself |

REST examples:

```bash
curl 'https://api.nostr.watch/v2/relays?limit=10&sortBy=updated&sortOrder=desc'
curl 'https://api.nostr.watch/v2/relays/state?relayUrl=wss://relay.damus.io'
curl -X POST https://api.nostr.watch/v2/relays/search -H 'Content-Type: application/json' -d '{"nips":[42]}'
```

NIP-66 event kinds: `10166` monitor announcement, `30166` relay status (`d` tag = relay URL), `1066` relay status delta.

## Pages

- [Relays](https://nostr.watch/relays): table of known relays with status, latency and supported NIPs
- [Relay map](https://nostr.watch/relays/map)
- [Relays by software](https://nostr.watch/relays/software)
- [Relays by country](https://nostr.watch/relays/geography)
- [Relays by ISP](https://nostr.watch/relays/isps)
- [Monitors](https://nostr.watch/monitors)
- [Operators](https://nostr.watch/operators)

## Pricing

<!-- agent-pricing:start -->

The website and the raw NIP-66 events are free; the REST API costs 1 sat to 5 sats per request and the CVM (MCP over Nostr) costs 1 sat to 5 sats per request (3 endpoints are free).

### REST API

Docs: https://api.nostr.watch/v2/. Source: https://api.nostr.watch/v2/openapi.json. Payment methods: L402, X-Cashu.

| Endpoint | Price | Description |
| --- | --- | --- |
| `/relays` | 2 sats | List relay URLs (simple) |
| `/relays/detailed` | 3 sats | List relay states (detailed) |
| `/relays/full` | 4 sats | List relay states (full, with attribution) |
| `/relays/state` | 1 sat | Get single relay state |
| `/relays/search` | 3 sats | Search relays (simple) |
| `/relays/search/detailed` | 4 sats | Search relays (detailed) |
| `/relays/search/full` | 5 sats | Search relays (full, with attribution) |
| `/relays/nearby` | 3 sats | Geo-proximity relay search (simple) |
| `/relays/nearby/detailed` | 4 sats | Geo-proximity relay search (detailed) |
| `/relays/nearby/full` | 5 sats | Geo-proximity relay search (full, with attribution) |
| `/relays/bbox` | 3 sats | Bounding-box relay search (simple) |
| `/relays/bbox/detailed` | 4 sats | Bounding-box relay search (detailed) |
| `/relays/bbox/full` | 5 sats | Bounding-box relay search (full, with attribution) |
| `/relays/labels` | 1 sat | Get labels for a relay |
| `/relays/by/label` | 3 sats | Find relays by label (simple) |
| `/relays/by/label/detailed` | 4 sats | Find relays by label (detailed) |
| `/relays/by/label/full` | 5 sats | Find relays by label (full, with attribution) |
| `/relays/by/software` | 2 sats | Group relays by software |
| `/relays/by/network` | 2 sats | Group relays by network type |
| `/relays/by/nip` | 2 sats | Group relays by NIP support |
| `/relays/by/country` | 3 sats | Group relays by country |
| `/relays/compare` | 5 sats | Multi-relay comparison |
| `/relays/online` | 2 sats | List currently online relays |
| `/relays/offline` | 2 sats | List currently offline relays |
| `/relays/dead` | 2 sats | List probably dead relays |
| `/monitors/:pubkey` | 1 sat | Get monitor details |
| `/monitors/analytics` | 5 sats | Monitor analytics (all) |
| `/monitors/:pubkey/analytics` | 2 sats | Monitor analytics (single) |

### CVM (MCP over Nostr)

Docs: https://cvm.nostr.watch. Source: https://cvm.nostr.watch/config.json.

| Endpoint | Price | Description |
| --- | --- | --- |
| `relays/list` | 2 sats | List relay URLs (simple) |
| `relays/list/detailed` | 3 sats | List relay states (detailed) |
| `relays/list/full` | 4 sats | List relay states (full, with attribution) |
| `relays/state` | 1 sat | Get single relay state |
| `relays/search` | 3 sats | Search relays (simple) |
| `relays/search/detailed` | 4 sats | Search relays (detailed) |
| `relays/search/full` | 5 sats | Search relays (full, with attribution) |
| `relays/nearby` | 3 sats | Geo-proximity relay search (simple) |
| `relays/nearby/detailed` | 4 sats | Geo-proximity relay search (detailed) |
| `relays/nearby/full` | 5 sats | Geo-proximity relay search (full, with attribution) |
| `relays/bbox` | 3 sats | Bounding-box relay search (simple) |
| `relays/bbox/detailed` | 4 sats | Bounding-box relay search (detailed) |
| `relays/bbox/full` | 5 sats | Bounding-box relay search (full, with attribution) |
| `relays/labels` | 1 sat | Get labels for a relay |
| `relays/labels/list` | free | List all available labels |
| `relays/by/label` | 3 sats | Find relays by label (simple) |
| `relays/by/label/detailed` | 4 sats | Find relays by label (detailed) |
| `relays/by/label/full` | 5 sats | Find relays by label (full, with attribution) |
| `relays/by/software` | 2 sats | Group relays by software |
| `relays/by/network` | 2 sats | Group relays by network type |
| `relays/by/nip` | 2 sats | Group relays by NIP support |
| `relays/by/country` | 3 sats | Group relays by country |
| `relays/compare` | 5 sats | Multi-relay comparison |
| `relays/online` | 2 sats | List currently online relays |
| `relays/offline` | 2 sats | List currently offline relays |
| `relays/dead` | 2 sats | List probably dead relays |
| `monitors/get` | 1 sat | Get monitor details |
| `monitors/list` | free | List all monitors |
| `monitors/analytics` | 5 sats | Monitor analytics (all) |
| `monitors/analytics/get` | 2 sats | Monitor analytics (single) |
| `health/ping` | free | Health check |

<!-- agent-pricing:end -->

## FAQ

**What is NIP-66?** A Nostr protocol for relay discovery and liveness monitoring. Monitors publish signed events describing relay health, capabilities and availability.

**Is the data free?** The website and the raw NIP-66 events are free. The REST API and the CVM tools charge small per-request amounts in sats; see Pricing.

**How often is data updated?** Monitors check relays about every hour. The REST API and CVM ingest new monitor events as they are published.

**Can I self-host?** Yes. The monitors and the rstate aggregation engine behind the REST API and CVM are open source.

## About

- Source: https://github.com/sandwichfarm/nostr-watch (MIT)
- Built by [sandwich.farm](https://sandwich.farm)
- Agent summary: https://nostr.watch/llms.txt
