Gridmaster public API

Every worked Maidenhead grid, with the percentage of Gridmaster users who worked it. Same figures as the “Most Wanted Map”. No key, no quota, JSON, CORS open.

Endpoint

GET https://gridmaster.fr/api/grids.json

Parameters

NameValuesDefault
awardaward code (sat, 6m, sat/europe, 6m/japan…) or its numeric idsat
formatlist (array of objects) or map (grid → percentage)list

Response

{
  "award": {"id": 24, "code": "sat", "name": "Satellite"},
  "updated": "2026-11-09",
  "operators": 1500,
  "grids": 4616,
  "worked": [
    {"grid": "AA00", "percent": 0},
    {"grid": "JO31", "percent": 48}
  ]
}

operators is the number of accounts the percentage is computed on, percent is the share of them that worked that grid — the very same figure the “Most Wanted Map” displays, rounded to the whole percent. Every valid 4-character grid appears once, and only grids worked at least once are listed (a grid worked by a single operator therefore shows 0). With format=map the payload is simply {"AA00": 0, "JO31": 48}.

Cache and freshness

The ranking is rebuilt once a day. Responses carry an ETag and a one-hour Cache-Control, and are served gzipped: please cache them on your side rather than polling more than once an hour.

Errors

An unknown award returns 404 with the list of valid codes: {"error": "unknown award", "awards": [...]}.