Approved cities
application/jsonVersioned city selector with canonical city pages and only operator-verified NIP-29 chat destinations.
/api/cities
BitcoinWalk / developers
Public city and event feeds
Open, read-only feeds generated from BitcoinWalk’s verified Nostr records. The city directory lists every approved city, while event formats contain only upcoming walks and use the current city OG image, including approved sponsor artwork where applicable.
JSON API
application/jsonStructured integration feed with signed Nostr IDs, canonical links, times, coordinates and current OG images.
/api/eventsCalendar subscription
text/calendarSubscribe from Apple Calendar, Google Calendar, Outlook, Thunderbird and other iCalendar clients.
/events.icsRSS feed
application/rss+xmlFollow future walks in feed readers or consume the XML event, GeoRSS and Media RSS fields.
/events.xmlData guarantees
- The signed Nostr event ID is the stable event identifier.
- Times are ISO 8601 in JSON/XML and UTC instants in iCalendar; the original IANA timezone is retained.
- Cancelled, hidden, past and unapproved walks are excluded.
- Paid cities never fall back to the global chat while their dedicated group is incomplete.
- A temporary authoritative read or sponsorship-resolution failure returns HTTP 503 instead of a partial list.
- Feeds may be cached for 60 seconds and support cross-origin reads.