Race the Internet.

Authentication

All requests require a Bearer token in the Authorization header.

request headerAuthorization: Bearer YOUR_API_KEY

Need higher limits? Request a dedicated key

Available Races

Three circuits are ready to run. Each race has 10 participants racing around the planet across three continents. The winner is the participant with the lowest total latency across all legs.

Quickstart

curl -s -X POST https://api.aroundplanet.tech/races/api-std-1/run \
  -H "Authorization: Bearer YOUR_API_KEY"

response{
  "run_id":          "run-2282e0cdd9fe43fe",
  "race_id":         "api-std-1",
  "status":          "running",
  "poll_status_url":  "/v1/runs/run-2282e0cdd9fe43fe/status",
  "poll_result_url":  "/v1/runs/run-2282e0cdd9fe43fe/result"
}

curl -s https://api.aroundplanet.tech/runs/YOUR_RUN_ID/status \
  -H "Authorization: Bearer YOUR_API_KEY"

response{
  "run_id":  "run-2282e0cdd9fe43fe",
  "race_id": "api-std-1",
  "status":  "complete"   // running | complete | timeout
}

curl -s https://api.aroundplanet.tech/runs/YOUR_RUN_ID/result \
  -H "Authorization: Bearer YOUR_API_KEY"

response (abridged){
  "run_id":  "run-2282e0cdd9fe43fe",
  "race_id": "api-std-1",
  "result": {
    "stats": {
      "total_duration": { "min": 4620.7, "mean": 5116.6, "max": 6471.0 }
    },
    "insights": {
      "physics_ratio": { "value": 31.78, "theo_ms": 161.0 },
      "winner":        { "ms": 4620.71, "narrative": "Winner completed in 4621ms..." }
    },
    "completeness":  { "valid_count": 10, "error_rate_pct": 0.0 },
    "runs": [ /* 10 individual run objects with per-leg ms */ ],
    "replay": [ /* timestamped events for each run */ ]
  }
}

Endpoints

Rate Limits

Per key, rolling 60-second window. Returns 429 when exceeded.

Get a Key