Agent Data API

1. Get a key

curl -X POST https://agentdataapi.com/api/v1/auth/keys \
  -H "Content-Type: application/json" \
  -d '{"email": "you@yourcompany.com"}'
# -> {"api_key": "adk_live_...", "tier": "free", "daily_limit": 5, ...}

Free: 10 requests a minute, 5 a day, across every slice. Pro (a pass) is 60/min and 20,000/day and unlocks the history endpoints.

2. Endpoints

Grid and energy data /energy/api/v1

Slice OpenAPI: /energy/api/openapi.json. Pricing: /energy/api/v1/pricing. Health: /energy/api/v1/health.

Environmental sensors /sensors/api/v1

Slice OpenAPI: /sensors/api/openapi.json. Pricing: /sensors/api/v1/pricing. Health: /sensors/api/v1/health.

Weather alerts and forecasts /weather/api/v1

Slice OpenAPI: /weather/api/openapi.json. Pricing: /weather/api/v1/pricing. Health: /weather/api/v1/health.

News signals and trends /news/api/v1

Slice OpenAPI: /news/api/openapi.json. Pricing: /news/api/v1/pricing. Health: /news/api/v1/health.

Response envelope

{
  ...,                                   # the endpoint's own fields
  "as_of": "2026-11-09T03:05:00Z",       # the data's own timestamp (UTC)
  "next_update": "2026-11-09T03:10:00Z", # when a newer value is expected, or null
  "status": "fresh",                     # fresh | stale (upstream late, last good value) | pending (never collected)
  "data_age_s": 41,
  "source": [{"publisher": "AEMO", "licence": "...", "url": "...", "retrieved_at": "..."}]
}

Units: _micro is one millionth (prices: micro units of the stated currency), _milli one thousandth (readings), _bps basis points (tone, ratios). Coordinates are plain floats. A request never fetches upstream: handlers read what the collector stored, so a slow publisher cannot slow you down.

3. Pay per request (x402)

curl -i https://agentdataapi.com/weather/api/v1/alerts?region=TX
# HTTP/1.1 402 Payment Required
# Payment-Required: <base64>
# {"accepts": [{"scheme": "exact", "network": "eip155:8453", "amount": "2000", "payTo": "0x...", ...}],
#  "price_usd": 0.002, "alternatives": {...}}

# sign with an x402 client, then
curl https://agentdataapi.com/weather/api/v1/alerts?region=TX -H "x-payment: <signed payload>"

Networks: Base (recommended), Ethereum and Solana USDC. Settlement runs through the Coinbase facilitator; you pay no gas. A per-request response is never cached. Passes go through POST /api/v1/payments/agent-subscribe with {"plan": "pass_1d"} and return a key once that works on every slice. There are no subscriptions; for steady use see RealtimeAPI.ai. Full table: agent pricing.

4. MCP

claude mcp add --transport http agentdataapi https://agentdataapi.com/mcp \
  --header 'X-API-Key: ${AGENTDATA_API_KEY}'

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. Each is a loopback call to the REST endpoint, so tiers and limits are identical. Setup for other clients.

5. Errors and limits

Every refusal is JSON: {"detail": {"error": "...", "message": "...", ...}}. 401 carries mint_url; 403 carries upgrade with the x402 route; 429 carries Retry-After and scope (minute or day). Rate limit headers: X-RateLimit-Remaining-Minute, X-RateLimit-Remaining-Day. Payment and key-management routes never count against the daily cap.

6. Sources and licences

Attribution is included in the source array of every response, which satisfies CC BY, the open government licences and GDELT's citation requirement, and gives your agent provenance.

7. Through RealtimeAPI: 1,000 free calls a month

These endpoints are also listed on RealtimeAPI.ai as the feeds griddata, sensordata, weatherdata, newssignals. A free RealtimeAPI key gives 1,000 calls a month across every feed, one rta_live_ key for many feeds, x402 at the gateway, and edge caching with honest X-RTAPI-Data-Age headers.

curl -X POST https://api.realtimeapi.ai/keys/free -H "Content-Type: application/json" -d '{"email": "you@yourcompany.com"}'
curl https://api.realtimeapi.ai/v1/weatherdata/api/v1/alerts?region=TX -H "X-API-Key: rta_live_..."

8. Agent skill

A Claude Code style skill file describing this API: /skills/agentdataapi/SKILL.md. Install with mkdir -p ~/.claude/skills/agentdataapi && curl -fsSL https://agentdataapi.com/skills/agentdataapi/SKILL.md -o ~/.claude/skills/agentdataapi/SKILL.md, or append it to AGENTS.md.