Guide

Aroni docs

Aroni is a live map of Nigeria. It brings together who has electricity right now, weather and air in every state, the news, security incidents, prices, markets, government contracts, treaties, radio and more, each pinned to where it happens.

Quick start

1. Open aroni.live on a phone or computer. No account and no app needed.
2. The scoreboard at the top shows Nigeria's population, births, deaths and GDP, counting live.
3. Aroni opens on the globe with every layer off. Switch layers on from the icons on the left (on a phone, the Layers tab).
4. Tap anything on the map, such as a state, an LGA, a pin or a cable, to open its card.
5. Open a panel from the dock at the bottom for lists, statistics and downloads.
6. Search for a state, LGA or town with the search box, or press /.

The interface

Scoreboard

Population, births and deaths today, GDP and the NGX All-Share, always visible. Population figures run from the UN World Population Prospects rates, GDP from the IMF World Economic Outlook.

Layer rail

Icons down the left edge open each group of layers (Nigeria live, Security, Economy, Connections, Space and Display). Every layer starts off; switch on what you want, or use ALL for a whole group. A badge shows how many are on.

Map

Four base maps: Dark, Streets (a full street map), Sat (cloud-free satellite imagery) and Lite (no tiles at all, for very slow connections). Switch between a flat 2D map of the region and a 3D globe you can zoom all the way out on. Layers that link Nigeria to other countries open the globe for you.

Cards

Tap a state, LGA, pin, cable or country for its details and the source behind them.

Panels

Icons down the right edge open News, Alerts, Light, Weather, Prices, Markets, Projects, Treaties, Stats and Radio. On a phone they are tabs along the bottom that open a sheet.

Read-out

Along the bottom: the position under your cursor, the state it is in, and the zoom level.

Ticker

The latest headlines scroll along the bottom edge.

Map layers

Panels

Light reports

Nobody publishes live power data for Nigeria, so Aroni asks the people who know: those in the area right now.

• One tap. Pick your area and tap Light is on or No light.
• Three devices must agree. An area's status changes when 3 separate devices report the same thing within 15 minutes, so one person cannot flip it alone.
• Bot check. Each report passes Cloudflare Turnstile, which usually needs no clicking.
• Limits. One report per area per device every 10 minutes, at most 6 an hour per device, and a loose cap per network, since many phones share one mobile network address.
• No identity. A device is a random id stored on that phone, and network addresses are only kept as a salted hash that changes daily. See Privacy.
• Expiry. Without new reports an area goes back to unknown after 6 hours. Reports are deleted after 30 days.

Security data

The Security layer is built automatically from security news headlines. Aroni:

• groups reports of the same incident from several outlets and counts it once;
• classifies it as terrorism, kidnapping, banditry, killings and attacks, communal clashes, cult clashes and robbery, or a security operation, from the headline's wording;
• reads the number reported killed or kidnapped, ignoring ages and keeping militants killed by troops separate from victims;
• places it at an LGA when the headline names a town or LGA (774 LGAs), otherwise at the state.

Sources & freshness

Every card and panel names its source and says how old the data is. Data on Aroni arrives in three ways:

• Live on request: news, markets, air quality and statistics are fetched from the source when someone opens Aroni, and briefly cached at the edge (60 seconds for markets, 5 minutes for news).
• On a schedule: a background worker updates weather and exchange rates every 30 minutes, alerts every 15 minutes, checks radio stations 4 times an hour, and records the NGX close on weekdays at 15:40 Nigeria time.
• Official datasets: contracts, treaties, cables and bases are checked automatically (every 3 hours or daily) and published when the source changes. Prices follow the NBS monthly release.

Low data & offline

• On 2G or with data saver on, Aroni starts on the Lite map, which downloads no map tiles.
• The first visit is about 600 KB on a slow connection. Repeat visits are around 40 KB, because the app is kept on your device.
• Heavy datasets (contracts, treaties, bases, cables, LGA shapes) only download when you open their layer or panel.
• Recently viewed map tiles are kept, so places you have looked at open even with a poor signal.

Radio

Stations play straight from the broadcaster's own stream; Aroni never re-hosts or relays audio. Four times an hour Aroni checks every station: it listens twice, 12 seconds apart, and if the audio is identical it is a recording (for example an advert or an off-air loop), not live radio, and the station is hidden until it is live again. If a station fails to start, the player moves to the next one.

Moderation

Everything publishes automatically. An admin can still remove a headline or alert, add one, edit where it is pinned, or set a state's travel advisory. Removed items disappear from the map and the feeds for everyone.

Keyboard shortcuts

API reference

Conventions

Aroni's endpoints are the same ones the site uses. They are free to read for personal and research use.

• Base URL: https://aroni.live. All responses are JSON.
• Status: every response has ok. When a source fails, ok is false and the data is empty. Aroni never fills in made-up values.
• Timestamps: ISO 8601 in UTC (fetched_at, generated).
• Caching: responses carry Cache-Control; asking more often than that returns the same data.
• Browsers: endpoints do not send CORS headers, so call them from a server or script, not from another website's page.
• Responsible use: cache on your side, keep to a request a minute, and credit the original source named in each response.

News

curl https://aroni.live/api/news

const res = await fetch("https://aroni.live/api/news");
const { ok, items } = await res.json();
for (const n of items) console.log(n.source, n.title);

import requests
data = requests.get("https://aroni.live/api/news", timeout=30).json()
for n in data["items"]:
    print(n["source"], n["title"])

{
  "ok": true,
  "fetched_at": "2026-10-16T10:20:00.000Z",
  "sources": 16,
  "failed": [],
  "items": [
    { "title": "…", "link": "https://…", "source": "Premium Times",
      "date": 1792145400000, "topic": "security" }
  ]
}

Markets

{
  "ok": true,
  "fetched_at": "…",
  "world": [
    { "symbol": "^GSPC", "name": "S&P 500", "group": "Indices", "price": 7744.06,
      "change": 25.12, "pct": 0.325, "currency": "USD", "time": "…", "series": [7694.6, …] }
  ],
  "ngx": { … }
}

Air quality

{ "ok": true, "fetched_at": "…",
  "points": [ { "code": "KN", "aqi": 200, "pm25": 78, "pm10": 185.8 } ] }

Statistics

{ "ok": true, "source": "World Bank Open Data", "updated": "2026-10-08",
  "items": [ { "id": "FP.CPI.TOTL.ZG", "label": "Inflation (consumer prices)",
               "kind": "pct", "group": "Economy", "value": 23.01, "year": 2025 } ] }

Radio stations

{ "ok": true, "checked": true, "source": "Radio Browser",
  "stations": [ { "name": "METRO FM LAGOS", "url": "https://…/radio.mp3", "codec": "MP3",
                  "bitrate": 64, "place": "Lagos", "state": "LA", "lat": 6.5, "lon": 3.38 } ] }

Light report

{ "area_id": 12, "has_light": true,
  "device_id": "random-uuid-kept-on-the-phone", "token": "turnstile-token" }

Datasets

Whole datasets as static JSON files, refreshed automatically. Each file says where it came from (source, source_url) and when it was built (generated).

More

How it is built

Questions

Why is my area's light status "unknown"?

Not enough people have reported in the last few hours. It takes 3 devices agreeing within 15 minutes.

Why is a recent treaty or contract missing?

Aroni shows what the official source has published. Treaties are often registered with the UN years after signing, and contract portals publish with a delay. Several states do not publish contracts at all.

Why is a radio station missing?

It may be off air, playing a recording, or using a stream service that inserts adverts. Those are hidden until they are live again.

Can I use this data?

Yes, for personal, research and journalistic use. Credit Aroni and the original source, and follow that source's licence.

Something is wrong. Who do I tell?

Email [email protected].