Almighty

Air quality sensor

Your particle sensor's PM2.5 and PM10 readings, with temperature and humidity, show on Almighty's Air quality layer as a contributor sensor, next to the official monitors.

1. Register in the Almighty app

There is no sign-up on this website. Open Almighty (the iPhone and iPad app, the Android app or the web app) and go to Settings → Contribute → Join Almighty Contribute. Sign in with Apple or with a code sent to your email (not as a guest), choose a display name and accept the contributor terms.

Then tap Add a station, choose Air quality sensor, give it a name and set its place on the map. The app shows the station's key, which starts alm_st_. Copy it straight away: it is shown once only. If you lose it, make a new key in the app (the old one stops working).

Everyone else sees your station's place rounded to about 1 km, never the exact spot. What it sends is shared under CC BY 4.0 and credited "Data © Almighty contributors (CC BY 4.0)".

2a. A sensor.community (Luftdaten) sensor

The sensor.community firmware (NodeMCU with an SDS011, SPS30, PMS or HPM particle sensor, and optionally a BME280, BMP280, DHT22, SHT3x or HTU21D) can send a copy of every reading to another server as well as to sensor.community. Keep sending to sensor.community too if you like.

  1. Open the sensor's configuration page (its address on your network, or the feinstaubsensor-… Wi-Fi network it makes when it can't connect), then Configuration → APIs.
  2. Tick Send data to own API and fill in:
    Serverapi.almighty.live
    Path/v1/contribute/airquality/sensor-community
    Port80 (or 443 with HTTPS ticked, where your firmware has it)
    Useralmighty (anything)
    Passwordyour station key, alm_st_…
  3. Save and restart. Within a few minutes the app shows the station as online.

If your firmware has no User and Password fields, put the key in the path instead: /v1/contribute/airquality/sensor-community/alm_st_…, with no user or password. Anyone who can read your sensor's settings can see the key, so keep the configuration page on your own network.

The firmware sends every 145 seconds by default; Almighty keeps one reading a minute at most. "P1" is PM10 and "P2" is PM2.5 in the firmware's names.

2b. Any other sensor: a small JSON request

Send an HTTP POST with the key in the X-Station-Key header and a JSON body. Values are µg/m³ for particles, °C and % for temperature and humidity. Every field but one particle reading is optional; time is ISO 8601 or Unix seconds (left out: now).

curl -X POST http://api.almighty.live/v1/contribute/airquality \
  -H "X-Station-Key: alm_st_…" \
  -H "Content-Type: application/json" \
  -d '{"pm25": 7.1, "pm10": 12.3, "temperature": 14.2, "humidity": 80.1, "time": "2026-10-20T10:00:00Z"}'

Almighty answers {"ok": true, "accepted": 1}. A reading it can't use gets a 400 and the reason.

3. Checks on your readings

Limits

Help

Questions, or something not working? Email bonnyjames0@gmail.com with your station's name (never its key). See also Contribute to Almighty and Open data.