GET
/health
Deployment health check for the FastAPI service.
Public API
Bitcoin Node Atlas API Docs
Use the API to inspect observed Bitcoin node stats, reachable node rows, country breakdowns, approximate map data, and node reachability checks. Data reflects this crawler's vantage point and should not be treated as a full network census.
Main endpoints
GET
/stats
Summary counts for reachable nodes, observed addresses, network types, and last crawl time.
GET
/nodes
Paginated reachable and observed node rows with filters for status, network type, and text search.
GET
/nodes/{node_id}
Details for one observed node record, including first observed and last seen timestamps.
GET
/versions
Reachable node counts grouped by reported Bitcoin user agent version.
GET
/countries
Approximate country breakdowns, including unknown buckets when GeoIP data is unavailable.
GET
/map-data
Aggregated map points for approximate IP geolocation, without exposing full raw node lists.
POST
/check-node
One conservative reachability check for a public IPv4, IPv6, hostname, or Tor/onion node when Tor support is enabled server-side.