boring-api · geo

Pure-library spatial math and timezone lookup. Distance, bearing, polygons, point-in-polygon, timezone-by-coords. No external API calls — all computed in-Worker.

OpenAPI · Health · boring-api.com

This is an x402-paid API. Calls require a USDC micropayment on Base mainnet. Agents discover endpoints automatically via /openapi.json and the 402 challenge response.

Endpoints

POST /distance — Great-circle distance between two points (meters).
POST /distance-matrix — Distance matrix for N origins × M destinations.
POST /bbox — Bounding box of a circle around a point.
POST /point-in-polygon — Test whether a point is inside a polygon (GeoJSON).
POST /polygon-area — Compute the area of a GeoJSON polygon in square meters.
POST /polygon-centroid — Compute the centroid (center of mass) of a GeoJSON polygon.
POST /nearest — Find the nearest candidate point to an origin.
POST /bearing — Initial bearing from A to B in degrees (0=N, 90=E).
POST /destination — Point reached by traveling distance+bearing from origin.
GET /timezone — IANA timezone for a coordinate (e.g. America/New_York).