Skip to content
APIStead
Weather & GeospatialVerifiedPreview

Coordinates & Distance API

Distance, midpoint and bearing between coordinates.

About this API

Agents often need a straightforward geometric answer without a full mapping stack: how far apart are two points, what is the midpoint, what bearing should a route start on?

This API returns all three in one call, with kilometres, miles and nautical miles. It is pure math, so it is fast, cache-friendly and inexpensive to verify.

For AI agents

Calculate great-circle distance, midpoint and bearing between two coordinate pairs.

Scope

Straight-line geometry only. Does not route, account for roads, traffic, elevation or travel time.

Endpoints

MethodRoutePrice
GET/distance?from={lat},{lon}&to={lat},{lon}$0.001

Example request

request
GET https://apistead.qd.je/api/v1/distance?from=51.5074,-0.1278&to=40.7128,-74.0060

Example response

200 application/json
{
  "to": {
    "lat": 40.7128,
    "lon": -74.006
  },
  "from": {
    "lat": 51.5074,
    "lon": -0.1278
  },
  "midpoint": {
    "lat": 52,
    "lon": -37
  },
  "distance_km": 5570.2,
  "distance_miles": 3461.2,
  "initial_bearing_deg": 288.4,
  "distance_nautical_miles": 3007.7
}

Verification

Verified1 of 1 routes verified

APIStead paid one named route from its own wallet, received real product back, and published the on-chain USDC receipt. The badge covers that route, not the whole listing.

Last verified
13 Nov 2026

Use cases

  • Calculate the distance between two coordinates
  • Find a midpoint for a meeting or delivery
  • Get an initial bearing for a route

Agent intents

Phrases an agent can use to find this route.

calculate distance between coordinatesfind the midpoint between two pointsget bearing between two locationsmeasure a straight-line distance

Changelog

1.0.0release11 Nov 2026

Initial verified release

The route is live and settlement-verified on Base mainnet. Health checks, public receipts and agent-readable records are available.

By APIStead Labs