Free public API

Bitcoin Node Atlas API

Access observed Bitcoin node stats, reachable node lists, country breakdowns, map data, version data, and node reachability checks.

Bitcoin Node Atlas is an observed crawler view, not a complete census of the Bitcoin network.

View API DocsOpen OpenAPI JSON

Endpoints

Public data surfaces

Read-only endpoints are best for dashboards, research, and educational tools. Reachability checks perform live network work and should be used more carefully.

Interactive docs
GET/health

Simple API process health response for deployment checks.

GET/stats

Summary counts for reachable nodes, observed addresses, network types, and the latest crawl time.

GET/nodes

Paginated observed node rows with status, network type, protocol, user agent, block height, latency, and GeoIP fields when available.

GET/nodes/{node_id}

Details for one observed node record, including first observed and last seen timestamps.

POST/check-node

A conservative reachability check for one public Bitcoin node host and port from the API server's vantage point.

GET/versions

Reachable node counts grouped by reported Bitcoin user agent version.

GET/countries

Approximate country breakdowns for observed nodes, including unknown buckets when GeoIP data is blank.

GET/map-data

Aggregated map-friendly buckets for approximate geographic distribution without returning full raw node lists.

Free public access

Reasonable use during launch

The Bitcoin Node Atlas API is currently available as a free public API for reasonable use. It is intended for research, dashboards, hobby projects, educational tools, and public-interest projects.

  • Please cache responses where practical.
  • Avoid aggressive polling.
  • Reasonable-use limits may be applied, especially to node reachability checks.
  • /check-node is more expensive than read-only endpoints and may be more strictly rate limited.

Future API access

Prepared, not active

If usage grows, Bitcoin Node Atlas may add API keys, higher-limit plans, historical datasets, or commercial access options. The current public API remains intended for reasonable use during launch.

No paid billing, prices, API keys, or commercial plans are active on this site yet.

Use responsibly

Conservative data, conservative expectations

Data reflects observed nodes, reachable nodes, approximate IP geolocation, and checks from our crawler's vantage point. Network conditions, peer limits, routing, and crawler scheduling can all affect what appears in the API.

  • Do not use the API to abuse, scan, or attack third-party systems.
  • Do not treat approximate geolocation as precise.
  • Do not represent the data as a complete list of all Bitcoin nodes.
  • Attribution is appreciated when using the API publicly.