DXconditions.live provides a public read-only DX Cluster JSON feed for amateur radio projects. The feed is generated from a DX Cluster Telnet stream and published as lightweight JSON. Please use it fairly, cache responses, and include attribution where practical.

API EndpointJSON

Current public endpoint:

https://api.dxconditions.live/cluster/spots.json Open Feed

Usage RulesFair Use

1Read-only feed

The endpoint is intended for reading recent DX Cluster spots. Do not treat it as a write API or control interface.

2Cache responses

Please cache responses for at least 30–60 seconds. Polling every few seconds is unnecessary and may be rate-limited.

3Use reasonable request rates

For normal projects, one request per minute is sufficient. Bulk scraping or high-frequency polling is not permitted.

4Attribution appreciated

When displaying the data publicly, please credit: “Source: DXconditions.live Cluster API”.

5Data is provided as-is

DX Cluster spots are user-submitted and may contain errors, duplicates, delays, wrong modes, or invalid frequencies.

6No availability guarantee

The service is operated as a best-effort amateur radio project. Endpoint, format, and availability may change.

Response FormatSchema

Content
JSON array of recent DX Cluster spots
Frequency
Frequency is provided in kHz
Time
UTC timestamp in ISO 8601 format where available
Mode / Band
Mode and band are best-effort parser hints and may be missing or corrected later

ExampleJSON 

[
  {
    "spotter": "DL1ABC",
    "spotted": "K1ABC",
    "frequency": 14074.0,
    "message": "FT8 CQ",
    "when": "2026-05-10T12:34:00Z",
    "add": {
      "mode": "FT8",
      "band": 20
    }
  }
]

Recommended Client BehaviourIntegration 

Recommended polling interval:
  60 seconds or slower

Recommended local cache:
  30–60 seconds minimum

Suggested attribution:
  Source: DXconditions.live Cluster API

Endpoint:
  https://api.dxconditions.live/cluster/spots.json

Server-side fetching is recommended for public projects. Browser-side use depends on the response headers sent by the API endpoint.