{"currency":"USDC","protocol":"x402","pricing_page":"https://agentdataapi.com/ai-pricing","subscriptions":{},"free_via_realtimeapi":{"free_calls_per_month":1000,"feeds":{"grid":{"feed":"griddata","feed_url":"https://realtimeapi.ai/feeds/griddata","gateway":"https://api.realtimeapi.ai/v1/griddata"},"sensors":{"feed":"sensordata","feed_url":"https://realtimeapi.ai/feeds/sensordata","gateway":"https://api.realtimeapi.ai/v1/sensordata"},"weather":{"feed":"weatherdata","feed_url":"https://realtimeapi.ai/feeds/weatherdata","gateway":"https://api.realtimeapi.ai/v1/weatherdata"},"news":{"feed":"newssignals","feed_url":"https://realtimeapi.ai/feeds/newssignals","gateway":"https://api.realtimeapi.ai/v1/newssignals"}},"mcp":"https://mcp.realtimeapi.ai/mcp","free_key":"POST https://api.realtimeapi.ai/keys/free","setup_page":"https://agentdataapi.com/realtimeapi","setup_prompt":"https://agentdataapi.com/realtimeapi/prompt.txt"},"passes":{"pass_1h":{"price_usd":1.0,"tier":"pro","duration_hours":1,"endpoint":"POST /api/v1/payments/agent-subscribe","body":{"plan":"pass_1h"}},"pass_1d":{"price_usd":3.0,"tier":"pro","duration_hours":24,"endpoint":"POST /api/v1/payments/agent-subscribe","body":{"plan":"pass_1d"}},"pass_7d":{"price_usd":8.0,"tier":"pro","duration_hours":168,"endpoint":"POST /api/v1/payments/agent-subscribe","body":{"plan":"pass_7d"}}},"per_request":{"grid_regions":{"method":"GET","path":"/energy/api/v1/regions","price_usd":0.005,"price_micro":5000,"description":"Every market region we serve: code, market, timezone, currency, source and price cadence.","cadence":"Refreshes every 24 hours."},"grid_price":{"method":"GET","path":"/energy/api/v1/power/prices/{market}/{region}","price_usd":0.01,"price_micro":10000,"description":"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.","cadence":"Refreshes every 5 minutes."},"grid_day_ahead":{"method":"GET","path":"/energy/api/v1/power/prices/{market}/{region}/day-ahead","price_usd":0.01,"price_micro":10000,"description":"Forecast prices per interval for a local calendar day: ENTSO-E day-ahead auction for EU zones, AEMO pre-dispatch for NEM regions.","cadence":"Refreshes every 30 minutes."},"grid_price_history":{"method":"GET","path":"/energy/api/v1/power/prices/{market}/{region}/history","price_usd":0.02,"price_micro":20000,"description":"Settled prices per interval for the last 7 days, optionally downsampled to 30 or 60 minute averages.","cadence":"Refreshes every 5 minutes.","cache_ttl_s":1800},"grid_load":{"method":"GET","path":"/energy/api/v1/power/load/{market}/{region}","price_usd":0.01,"price_micro":10000,"description":"Latest grid demand for a region in MW (NEM total demand, GB initial demand outturn, ENTSO-E actual load, EIA hourly demand).","cadence":"Refreshes every 5 minutes."},"grid_generation":{"method":"GET","path":"/energy/api/v1/power/generation/{market}/{region}","price_usd":0.01,"price_micro":10000,"description":"Latest generation mix for a region: MW per fuel, total, and the renewables share in basis points.","cadence":"Refreshes every 5 minutes."},"grid_cheapest_window":{"method":"GET","path":"/energy/api/v1/power/windows/{market}/{region}","price_usd":0.015,"price_micro":15000,"description":"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.","cadence":"Refreshes every 30 minutes."},"grid_carbon":{"method":"GET","path":"/energy/api/v1/carbon/{region}","price_usd":0.005,"price_micro":5000,"description":"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).","cadence":"Refreshes every 30 minutes."},"petroleum_weekly":{"method":"GET","path":"/energy/api/v1/petroleum/weekly","price_usd":0.01,"price_micro":10000,"description":"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.","cadence":"Refreshes every 7 days."},"sensors_stations_near":{"method":"GET","path":"/sensors/api/v1/stations/near","price_usd":0.005,"price_micro":5000,"description":"Stations of every open network within a radius of a point, nearest first, with network, parameters and distance.","cadence":"Refreshes every 24 hours."},"sensors_air":{"method":"GET","path":"/sensors/api/v1/air/{station_id}","price_usd":0.005,"price_micro":5000,"description":"Latest air quality readings at one monitor (PM2.5, PM10, O3, NO2, SO2, CO) with the US EPA AQI value and category.","cadence":"Refreshes every 60 minutes."},"sensors_air_near":{"method":"GET","path":"/sensors/api/v1/air/near","price_usd":0.01,"price_micro":10000,"description":"Air quality monitors within a radius of a point with their latest readings and AQI, nearest first.","cadence":"Refreshes every 60 minutes."},"sensors_water_gauge":{"method":"GET","path":"/sensors/api/v1/water/gauge/{site}","price_usd":0.005,"price_micro":5000,"description":"Latest river gauge height, discharge and water temperature at a USGS site, with the NWS flood stage status.","cadence":"Refreshes every 15 minutes."},"sensors_water_history":{"method":"GET","path":"/sensors/api/v1/water/gauge/{site}/history","price_usd":0.02,"price_micro":20000,"description":"Gauge readings for the last 7 days at a USGS site, newest first, with observed and ingested times for point-in-time use.","cadence":"Refreshes every 15 minutes.","cache_ttl_s":1800},"sensors_tides":{"method":"GET","path":"/sensors/api/v1/tides/{station}","price_usd":0.005,"price_micro":5000,"description":"Latest observed water level at a NOAA tide station (metres above MLLW) with the next predicted high and low.","cadence":"Refreshes every 6 minutes."},"sensors_tide_predictions":{"method":"GET","path":"/sensors/api/v1/tides/{station}/predictions","price_usd":0.005,"price_micro":5000,"description":"Predicted high and low tides for a day at a NOAA tide station (metres above MLLW, UTC).","cadence":"Refreshes every 24 hours."},"sensors_quakes":{"method":"GET","path":"/sensors/api/v1/quakes/recent","price_usd":0.005,"price_micro":5000,"description":"Earthquakes in the last N hours from the USGS feed, optionally above a magnitude and within a radius of a point.","cadence":"Refreshes every 60 seconds."},"weather_alerts":{"method":"GET","path":"/weather/api/v1/alerts","price_usd":0.002,"price_micro":2000,"description":"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.","cadence":"Refreshes every 60 seconds."},"weather_alert":{"method":"GET","path":"/weather/api/v1/alerts/{alert_id}","price_usd":0.002,"price_micro":2000,"description":"One alert by id with its description, instruction, areas, zone codes and polygon.","cadence":"Refreshes every 60 seconds."},"weather_current":{"method":"GET","path":"/weather/api/v1/current","price_usd":0.003,"price_micro":3000,"description":"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.","cadence":"Refreshes every 5 minutes."},"weather_forecast_hourly":{"method":"GET","path":"/weather/api/v1/forecast/hourly","price_usd":0.005,"price_micro":5000,"description":"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.","cadence":"Refreshes every 60 minutes or on a new model cycle.","cache_ttl_s":1800},"weather_forecast_daily":{"method":"GET","path":"/weather/api/v1/forecast/daily","price_usd":0.005,"price_micro":5000,"description":"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.","cadence":"Refreshes every 60 minutes or on a new model cycle.","cache_ttl_s":1800},"weather_stations_near":{"method":"GET","path":"/weather/api/v1/stations/near","price_usd":0.001,"price_micro":1000,"description":"Reporting stations (METAR) within a radius of a coordinate in the United States or Australia, nearest first, with distance.","cadence":"Refreshes every 24 hours."},"news_entities":{"method":"GET","path":"/news/api/v1/entities","price_usd":0.005,"price_micro":5000,"description":"The tracked entities: organisations, tickers, crypto assets, central banks, governments and topics, with ids, aliases and baselines.","cadence":"Refreshes every 24 hours."},"news_sentiment":{"method":"GET","path":"/news/api/v1/sentiment/{entity}","price_usd":0.01,"price_micro":10000,"description":"News tone and volume for one entity over a window: mentions, 30-day baseline, volume ratio, novelty, tone in basis points and top themes.","cadence":"Refreshes every 15 minutes."},"news_ticker_score":{"method":"GET","path":"/news/api/v1/tickers/{symbol}/news-score","price_usd":0.01,"price_micro":10000,"description":"News score for a ticker or crypto symbol: mentions against baseline, volume ratio, novelty, tone and tone change, top themes.","cadence":"Refreshes every 15 minutes."},"news_trending":{"method":"GET","path":"/news/api/v1/entities/trending","price_usd":0.015,"price_micro":15000,"description":"Entities with the most unusual news volume in the window, ranked by novelty against their 30-day baseline.","cadence":"Refreshes every 15 minutes."},"news_events":{"method":"GET","path":"/news/api/v1/events","price_usd":0.01,"price_micro":10000,"description":"GDELT-coded events (CAMEO) newest first: actors, event code, Goldstein scale, mentions, tone, country and the source URL.","cadence":"Refreshes every 15 minutes."},"news_sentiment_history":{"method":"GET","path":"/news/api/v1/sentiment/{entity}/history","price_usd":0.02,"price_micro":20000,"description":"Mentions and tone per 15-minute window (last 90 days) or per day for one entity, newest first, for backtests.","cadence":"Refreshes every 15 minutes.","cache_ttl_s":1800},"news_trending_people":{"method":"GET","path":"/news/api/v1/trending/people","price_usd":0.015,"price_micro":15000,"description":"Public figures with the biggest attention spike against their 30-day baseline (Wikipedia pageviews and news coverage), by category: celebrity, politics, sport, business.","cadence":"Refreshes every 60 minutes."},"news_trending_topics":{"method":"GET","path":"/news/api/v1/trending/topics","price_usd":0.015,"price_micro":15000,"description":"Trending topics for a region: top daily searches with approximate traffic and three headlines each, plus trending Mastodon tags and shared links.","cadence":"Refreshes every 60 minutes."},"news_top_stories":{"method":"GET","path":"/news/api/v1/top-stories","price_usd":0.01,"price_micro":10000,"description":"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.","cadence":"Refreshes every 15 minutes."}},"how_to_pay":["1. GET the endpoint with no X-API-Key. You receive HTTP 402 with a Payment-Required header and a JSON body whose accepts[] lists the USDC amount, network (Base recommended) and payTo address.","2. Sign that amount with your wallet (EIP-3009 transferWithAuthorization on Base; the x402 client libraries do this). No gas is spent by you.","3. Repeat the request with the signed payload in the x-payment header. The facilitator settles on-chain and the response is the data (per request) or a key (pass).","4. Running a job? Buy a 1 hour, 1 day or 7 day pass: POST /api/v1/payments/agent-subscribe with {\"plan\": \"pass_1d\"} returns an adk_live_ key valid for every data slice (energy, sensors, weather, news).","5. Steady use? The same endpoints are on RealtimeAPI.ai (feeds griddata, sensordata, weatherdata, newssignals) where a free key gives 1,000 calls a month across every feed: https://agentdataapi.com/realtimeapi"],"notes":["Per-request responses carry Cache-Control: private, no-store.","Passes return an adk_live_ key once and cover every slice; per-request payments do not return a key. There are no subscriptions.","Every response carries a source array naming the publisher, licence and URL of the data, plus as_of and status."]}