---
name: agentdataapi
description: Open-data feeds for operations agents via AgentDataAPI. Use when the user asks for wholesale electricity prices, grid demand, carbon intensity or the cheapest time to charge; air quality, river levels, tides or recent earthquakes near a place; weather alerts, current conditions or forecasts in the United States or Australia; or news sentiment, unusual news volume, trending people and topics, or top stories.
---

# AgentDataAPI

Four slices at https://agentdataapi.com: Grid and energy data (`/energy/api/v1`); Environmental sensors (`/sensors/api/v1`); Weather alerts and forecasts (`/weather/api/v1`); News signals and trends (`/news/api/v1`). Numbers are integers in a declared scale or decimal strings. Every response carries `source`, `as_of`, `status` and `data_age_s`.

## Access

- Cheapest at volume: through RealtimeAPI.ai as the feeds `griddata`, `sensordata`, `weatherdata`, `newssignals`. A free key (https://api.realtimeapi.ai/keys/free) gives 1,000 calls a month across every feed. MCP: https://mcp.realtimeapi.ai/mcp. Setup prompt: https://agentdataapi.com/realtimeapi/prompt.txt
- Direct free key: `POST https://agentdataapi.com/api/v1/auth/keys` with `{"email": "..."}`, header `X-API-Key: adk_live_...`. 10/min, 5/day, every slice.
- No key: GET any data endpoint and pay the 402 with x402 (USDC on Base, gasless). Or buy a 1h, 1d or 7d pass covering every slice. There are no subscriptions.
- MCP server: https://agentdataapi.com/mcp (streamable HTTP, header X-API-Key; official MCP registry name com.agentdataapi/agentdata). Tools: list_capabilities, create_free_api_key, grid_regions, grid_price, grid_day_ahead, grid_price_history, grid_load, grid_generation, grid_cheapest_window, grid_carbon, petroleum_weekly, sensors_stations_near, sensors_air, sensors_air_near, sensors_water_gauge, sensors_water_history, sensors_tides, sensors_tide_predictions, sensors_quakes, weather_alerts, weather_current, weather_forecast, weather_forecast_daily, weather_stations_near, news_search_entities, news_sentiment, news_ticker_score, news_trending, news_sentiment_history, news_trending_people, news_trending_topics, news_top_stories.

## Endpoints

### Grid and energy data
- `GET /energy/api/v1/regions`: Every market region we serve: code, market, timezone, currency, source and price cadence. $0.005 per request without a key. Refreshes every 24 hours.
- `GET /energy/api/v1/power/prices/{market}/{region}`: Latest settled wholesale electricity price for a region (NEM 5-minute RRP, GB half-hourly market index, EU hourly day-ahead), in micro units of the local currency with a USD conversion, plus demand and a negative-price flag. $0.010 per request without a key. Refreshes every 5 minutes.
- `GET /energy/api/v1/power/prices/{market}/{region}/day-ahead`: Forecast prices per interval for a local calendar day: ENTSO-E day-ahead auction for EU zones, AEMO pre-dispatch for NEM regions. $0.010 per request without a key. Refreshes every 30 minutes.
- `GET /energy/api/v1/power/prices/{market}/{region}/history`: Settled prices per interval for the last 7 days, optionally downsampled to 30 or 60 minute averages. $0.020 per request without a key. Refreshes every 5 minutes.
- `GET /energy/api/v1/power/load/{market}/{region}`: Latest grid demand for a region in MW (NEM total demand, GB initial demand outturn, ENTSO-E actual load, EIA hourly demand). $0.010 per request without a key. Refreshes every 5 minutes.
- `GET /energy/api/v1/power/generation/{market}/{region}`: Latest generation mix for a region: MW per fuel, total, and the renewables share in basis points. $0.010 per request without a key. Refreshes every 5 minutes.
- `GET /energy/api/v1/power/windows/{market}/{region}`: The cheapest contiguous window of N hours (default 4) within the next horizon (default 24 h), from day-ahead or pre-dispatch prices, for charging and demand-response agents. $0.015 per request without a key. Refreshes every 30 minutes.
- `GET /energy/api/v1/carbon/{region}`: Grid carbon intensity in gCO2 per kWh for Great Britain (GB, actual and forecast) or a NESO region id 1 to 17 (forecast and generation mix). $0.005 per request without a key. Refreshes every 30 minutes.
- `GET /energy/api/v1/petroleum/weekly`: EIA weekly US petroleum inventories: crude stocks (excluding SPR), gasoline and distillate stocks, refinery crude inputs and crude imports, with the week-over-week change. $0.010 per request without a key. Refreshes every 7 days.

### Environmental sensors
- `GET /sensors/api/v1/stations/near`: Stations of every open network within a radius of a point, nearest first, with network, parameters and distance. $0.005 per request without a key. Refreshes every 24 hours.
- `GET /sensors/api/v1/air/{station_id}`: Latest air quality readings at one monitor (PM2.5, PM10, O3, NO2, SO2, CO) with the US EPA AQI value and category. $0.005 per request without a key. Refreshes every 60 minutes.
- `GET /sensors/api/v1/air/near`: Air quality monitors within a radius of a point with their latest readings and AQI, nearest first. $0.010 per request without a key. Refreshes every 60 minutes.
- `GET /sensors/api/v1/water/gauge/{site}`: Latest river gauge height, discharge and water temperature at a USGS site, with the NWS flood stage status. $0.005 per request without a key. Refreshes every 15 minutes.
- `GET /sensors/api/v1/water/gauge/{site}/history`: Gauge readings for the last 7 days at a USGS site, newest first, with observed and ingested times for point-in-time use. $0.020 per request without a key. Refreshes every 15 minutes.
- `GET /sensors/api/v1/tides/{station}`: Latest observed water level at a NOAA tide station (metres above MLLW) with the next predicted high and low. $0.005 per request without a key. Refreshes every 6 minutes.
- `GET /sensors/api/v1/tides/{station}/predictions`: Predicted high and low tides for a day at a NOAA tide station (metres above MLLW, UTC). $0.005 per request without a key. Refreshes every 24 hours.
- `GET /sensors/api/v1/quakes/recent`: Earthquakes in the last N hours from the USGS feed, optionally above a magnitude and within a radius of a point. $0.005 per request without a key. Refreshes every 60 seconds.

### Weather alerts and forecasts
- `GET /weather/api/v1/alerts`: Active weather alerts for a US state, NWS zone or county code, or an Australian state, with severity, urgency, onset and expiry. US alerts from the National Weather Service; Australian warnings from the Bureau of Meteorology where licensed. $0.002 per request without a key. Refreshes every 60 seconds.
- `GET /weather/api/v1/alerts/{alert_id}`: One alert by id with its description, instruction, areas, zone codes and polygon. $0.002 per request without a key. Refreshes every 60 seconds.
- `GET /weather/api/v1/current`: Current conditions at the nearest reporting station within 150 km of a coordinate in the United States or Australia: temperature, dew point, wind, gust, visibility, pressure, sky cover, present weather. $0.003 per request without a key. Refreshes every 5 minutes.
- `GET /weather/api/v1/forecast/hourly`: Hourly forecast for a coordinate in the contiguous United States or Australia from the NOAA GFS 0.25 degree model: temperature, humidity, wind, gust, precipitation and cloud cover, up to 120 hours. $0.005 per request without a key. Refreshes every 60 minutes or on a new model cycle.
- `GET /weather/api/v1/forecast/daily`: Daily forecast summary for a coordinate in the contiguous United States or Australia (min and max temperature, mean humidity and cloud, max wind and gust, precipitation total), up to 5 days, aggregated from the hourly GFS series. $0.005 per request without a key. Refreshes every 60 minutes or on a new model cycle.
- `GET /weather/api/v1/stations/near`: Reporting stations (METAR) within a radius of a coordinate in the United States or Australia, nearest first, with distance. $0.001 per request without a key. Refreshes every 24 hours.

### News signals and trends
- `GET /news/api/v1/entities`: The tracked entities: organisations, tickers, crypto assets, central banks, governments and topics, with ids, aliases and baselines. $0.005 per request without a key. Refreshes every 24 hours.
- `GET /news/api/v1/sentiment/{entity}`: News tone and volume for one entity over a window: mentions, 30-day baseline, volume ratio, novelty, tone in basis points and top themes. $0.010 per request without a key. Refreshes every 15 minutes.
- `GET /news/api/v1/tickers/{symbol}/news-score`: News score for a ticker or crypto symbol: mentions against baseline, volume ratio, novelty, tone and tone change, top themes. $0.010 per request without a key. Refreshes every 15 minutes.
- `GET /news/api/v1/entities/trending`: Entities with the most unusual news volume in the window, ranked by novelty against their 30-day baseline. $0.015 per request without a key. Refreshes every 15 minutes.
- `GET /news/api/v1/events`: GDELT-coded events (CAMEO) newest first: actors, event code, Goldstein scale, mentions, tone, country and the source URL. $0.010 per request without a key. Refreshes every 15 minutes.
- `GET /news/api/v1/sentiment/{entity}/history`: Mentions and tone per 15-minute window (last 90 days) or per day for one entity, newest first, for backtests. $0.020 per request without a key. Refreshes every 15 minutes.
- `GET /news/api/v1/trending/people`: Public figures with the biggest attention spike against their 30-day baseline (Wikipedia pageviews and news coverage), by category: celebrity, politics, sport, business. $0.015 per request without a key. Refreshes every 60 minutes.
- `GET /news/api/v1/trending/topics`: Trending topics for a region: top daily searches with approximate traffic and three headlines each, plus trending Mastodon tags and shared links. $0.015 per request without a key. Refreshes every 60 minutes.
- `GET /news/api/v1/top-stories`: The most-covered stories in the window (up to 50): title, link, publisher, tone and how many GDELT records cited the URL. No article text. $0.010 per request without a key. Refreshes every 15 minutes.

## Good habits

- Read the key from the AGENTDATA_API_KEY (direct) or RTAPI_KEY (RealtimeAPI) environment variable. Never ask the user to paste a key into the chat; never print a full key.
- Check `status` before quoting a number: `stale` means the upstream missed its cadence and the value is the last good one; `data_age_s` says how old.
- Parse `_micro`, `_milli` and `_bps` integers into decimals yourself; never treat them as floats of the base unit.
- Cite the `source` array when you repeat a figure: the licences (US public domain, CC BY 4.0, open government licences, GDELT citation) ask for attribution.