{"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"}},"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":"/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":"/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":"/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":"/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":"/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":"/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":"/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":"/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":"/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."}},"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."]}