Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Nostr Relay WebSocket Interface

A Nostr relay is a WebSocket server that accepts signed events,stores them subject to its own policy, and responds to subscriptionfilters from clients. The relay surface is intentionally minimal:no accounts, no shared state, no canonical ordering. Operatorschoose retention, content policy, paid-access, and authentication(NIP-42) independently. Reference implementations include strfry(C++), nostream (TypeScript), and khatru (Go).

Nostr Relay WebSocket Interface is one of 4 APIs that Nostr publishes on the APIs.io network, described by an AsyncAPI event-driven specification.

Tagged areas include Relay, WebSocket, strfry, khatru, and nostream. The published artifact set on APIs.io includes an AsyncAPI specification.

Requests are made against the base URL wss://relay.example.

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI
Base URL
wss://relay.example

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

nostr-asyncapi.yml Raw ↑

Other APIs Nostr publishes across the network.

Nostr Protocol (NIP-01)
Nostr Implementation Possibilities (NIPs)
nostr-tools JavaScript Library