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.
- 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. - Tick Send data to own API and fill in:
Server api.almighty.livePath /v1/contribute/airquality/sensor-communityPort 80(or443with HTTPS ticked, where your firmware has it)User almighty(anything)Password your station key, alm_st_… - 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
- Particles must be between 0 and 1,000 µg/m³, temperature between −60 and 60 °C and humidity between 0 and 100 %. Anything else is refused.
- Low-cost sensors read high in fog and very damp air. Readings above 98 % humidity, or with PM2.5 above PM10, are kept but marked, and they lower the station's quality score.
- The colour on the map is the European Air Quality Index, worked out by Almighty from your PM2.5 and PM10. The card says it is a contributor's low-cost sensor, not an official monitor.
Limits
- One reading a minute per station is kept; a sensor sending more often gets 429 for the extra ones.
- Requests are small: at most 8 KB each.
- On a very busy day Almighty may stop taking new readings of this kind until midnight (UTC): your device gets an answer of 429 and can simply carry on; nothing is wrong with it.
- A station that sends nothing for two hours shows as offline in the app, and you can get a notification about it (Settings → Contribute → Notifications).
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.