{"schema_version":"v1","name_for_human":"AurAgrid L402 Oracle","name_for_model":"auragrid_oracle","description_for_model":"AurAgrid serves 13 data endpoints computed from its own Bitcoin and Lightning nodes or from U.S. public-domain sources (EIA, NOAA, USGS); each response carries provenance. Endpoints with access 'free' need no payment and are rate-limited per IP (see terms_url); only use endpoints whose status is 'live'. Endpoints with access 'paid' use L402 Lightning payments. On a 402 Payment Required, extract the invoice and macaroon from the WWW-Authenticate header, pay the invoice with a Lightning node, and replay the request with 'Authorization: L402 <macaroon>:<preimage>'. Prices may be USD-pegged and change with the BTC price: GET the endpoint's quote_url right before paying and accept an invoice within the quote's tolerance_pct. A paid token stays valid for the endpoint's token_ttl_seconds, so reuse it instead of paying again. For repeated use, a plan (30-day pass or multi-feed bundle) sells one token that opens its paths for token_ttl_seconds. Every paid endpoint has a free sample (sample_url: its delayed or daily copy, real data with its true as_of). A paid endpoint whose data is past its stale limit answers 503 with stale=true and its as_of, and issues no invoice; check status_url first. Endpoints with method 'derived' are computed by AurAgrid from its stored feeds; provenance.derivation gives the formula and provenance.inputs each input's as_of. Successful /api/v1/ data responses carry X-AurAgrid-Signature-V2 and X-AurAgrid-Timestamp headers (send a random X-AurAgrid-Nonce to bind the signature to your request); verify them as described in `signature` against the published pubkey, pinned out-of-band.","api":{"type":"openapi","url":"https://84.12.79.124/openapi.json"},"terms_url":"https://84.12.79.124/terms","status_url":"https://84.12.79.124/status.json","links":{"manifest":"https://84.12.79.124/agent-manifest.json","openapi":"https://84.12.79.124/openapi.json","llms_txt":"https://84.12.79.124/llms.txt","l402_services":"https://84.12.79.124/.well-known/l402-services","status":"https://84.12.79.124/status.json","terms":"https://84.12.79.124/terms","checkout":"https://84.12.79.124/buy"},"contact":"auragridcorp@gmail.com","endpoints_count":13,"endpoints":[{"path":"/api/v1/batch/btc-fees","name":"Bitcoin Fee and Mempool Monitor","tier":"bitcoin","description":"Fee estimates for 1-144 block targets, mempool size and minimum fee, and the last block's fee percentiles, refreshed every minute from AurAgrid's own Bitcoin Core node.","access":"paid","auth":"L402","status":"live","method":"measured","update_interval_seconds":60,"stale_after_seconds":900,"source":"AurAgrid's own Bitcoin Core node (mainnet)","source_url":"bitcoin-core-rpc:estimatesmartfee,getmempoolinfo,getblockstats","source_terms_url":"/terms","license":"AurAgrid's own computation from public Bitcoin network data; use under AurAgrid's /terms","attribution":"Computed by AurAgrid from its own Bitcoin Core node.","price_sats":8,"token_ttl_seconds":3600,"pricing":"usd_pegged","usd_price":0.005,"quote_url":"/api/v1/price/batch/btc-fees","price_usd_approx":0.0048,"sample_url":"/api/v1/batch/btc-fees-delayed"},{"path":"/api/v1/batch/btc-fees-delayed","name":"Bitcoin Fee and Mempool Monitor (10 min delayed)","tier":"bitcoin","description":"The same data as btc-fees, at least 10 minutes old.","access":"free","auth":"none","status":"live","method":"measured","update_interval_seconds":60,"stale_after_seconds":1800,"source":"AurAgrid's own Bitcoin Core node (mainnet)","source_url":"bitcoin-core-rpc:estimatesmartfee,getmempoolinfo,getblockstats","source_terms_url":"/terms","license":"AurAgrid's own computation from public Bitcoin network data; use under AurAgrid's /terms","attribution":"Computed by AurAgrid from its own Bitcoin Core node.","copy_of":"/api/v1/batch/btc-fees","delay":"10 minutes","rate_limit":"30 requests/minute per IP"},{"path":"/api/v1/batch/ln-network","name":"Lightning Network Monitor","tier":"bitcoin","description":"Lightning nodes, channels, capacity, channel-size and routing-fee percentiles, disabled share and policy churn, refreshed hourly from AurAgrid's own LND node's gossip graph.","access":"paid","auth":"L402","status":"live","method":"measured","update_interval_seconds":3600,"stale_after_seconds":10800,"source":"AurAgrid's own LND node (Lightning mainnet gossip graph)","source_url":"lnd-rest:/v1/graph/info,/v1/graph","source_terms_url":"/terms","license":"AurAgrid's own computation from public Lightning gossip; use under AurAgrid's /terms","attribution":"Computed by AurAgrid from the public Lightning gossip graph seen by its own LND node.","price_sats":17,"token_ttl_seconds":3600,"pricing":"usd_pegged","usd_price":0.01,"quote_url":"/api/v1/price/batch/ln-network","price_usd_approx":0.0102,"sample_url":"/api/v1/batch/ln-network-daily"},{"path":"/api/v1/batch/ln-network-daily","name":"Lightning Network Monitor (daily)","tier":"bitcoin","description":"The same data as ln-network, as of the end of the previous UTC day.","access":"free","auth":"none","status":"live","method":"measured","update_interval_seconds":86400,"stale_after_seconds":172800,"source":"AurAgrid's own LND node (Lightning mainnet gossip graph)","source_url":"lnd-rest:/v1/graph/info,/v1/graph","source_terms_url":"/terms","license":"AurAgrid's own computation from public Lightning gossip; use under AurAgrid's /terms","attribution":"Computed by AurAgrid from the public Lightning gossip graph seen by its own LND node.","copy_of":"/api/v1/batch/ln-network","delay":"previous UTC day","rate_limit":"30 requests/minute per IP"},{"path":"/api/v1/batch/earthquakes","name":"Global Earthquake Activity","tier":"hazards","description":"M2.5+ earthquakes in the last 24 h and M4.5+ in the last 7 days: counts by magnitude, largest events, tsunami-flagged and PAGER-alert events (USGS real-time feeds).","access":"free","auth":"none","status":"live","method":"measured","update_interval_seconds":600,"stale_after_seconds":3600,"source":"U.S. Geological Survey (USGS) Earthquake Hazards Program real-time feeds","source_url":"https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/2.5_day.geojson","source_terms_url":"https://www.usgs.gov/information-policies-and-instructions/copyrights-and-credits","license":"U.S. public domain (USGS); credit the U.S. Geological Survey","attribution":"Credit: U.S. Geological Survey. Public domain; USGS does not endorse AurAgrid.","rate_limit":"30 requests/minute per IP"},{"path":"/api/v1/energy/grid","name":"U.S. Grid Demand and Generation Mix","tier":"energy","description":"Hourly demand, forecast, interchange and generation by fuel with renewable/carbon-free shares for the Lower 48, EIA regions and every balancing authority (U.S. EIA-930).","access":"free","auth":"none","status":"live","method":"measured","update_interval_seconds":900,"stale_after_seconds":21600,"source":"U.S. Energy Information Administration (EIA), Hourly Electric Grid Monitor (EIA-930)","source_url":"https://api.eia.gov/v2/electricity/rto/","source_terms_url":"https://www.eia.gov/about/copyrights_reuse.php","license":"U.S. government work, public domain; credit the U.S. Energy Information Administration","attribution":"Source: U.S. Energy Information Administration. Public domain; EIA does not endorse AurAgrid.","rate_limit":"30 requests/minute per IP"},{"path":"/api/v1/batch/spr-stockpile","name":"U.S. Strategic Petroleum Reserve Monitor","tier":"energy","description":"Weekly SPR and commercial crude stocks with 1/4/52-week changes, 52-week range and history (U.S. EIA Weekly Petroleum Status Report).","access":"free","auth":"none","status":"live","method":"measured","update_interval_seconds":21600,"stale_after_seconds":864000,"source":"U.S. Energy Information Administration (EIA), Weekly Petroleum Status Report","source_url":"https://api.eia.gov/v2/petroleum/stoc/wstk/","source_terms_url":"https://www.eia.gov/about/copyrights_reuse.php","license":"U.S. government work, public domain; credit the U.S. Energy Information Administration","attribution":"Source: U.S. Energy Information Administration. Public domain; EIA does not endorse AurAgrid.","rate_limit":"30 requests/minute per IP"},{"path":"/api/v1/batch/lng-supply-chain","name":"U.S. LNG Export Monitor","tier":"energy","description":"Monthly U.S. LNG exports by terminal and destination country, export prices, and month/year changes (U.S. EIA; about three months' publication lag).","access":"free","auth":"none","status":"live","method":"measured","update_interval_seconds":43200,"stale_after_seconds":3888000,"source":"U.S. Energy Information Administration (EIA), natural gas exports by point of exit","source_url":"https://api.eia.gov/v2/natural-gas/move/poe2/","source_terms_url":"https://www.eia.gov/about/copyrights_reuse.php","license":"U.S. government work, public domain; credit the U.S. Energy Information Administration","attribution":"Source: U.S. Energy Information Administration. Public domain; EIA does not endorse AurAgrid.","rate_limit":"30 requests/minute per IP"},{"path":"/api/v1/batch/maritime-weather","name":"Marine Weather Observations","tier":"maritime","description":"Latest wind, gust, wave height/period/direction, pressure and air/sea temperature from ~850 NOAA NDBC buoys and coastal stations worldwide (updated continuously).","access":"free","auth":"none","status":"live","method":"measured","update_interval_seconds":600,"stale_after_seconds":10800,"source":"NOAA National Data Buoy Center (NDBC)","source_url":"https://www.ndbc.noaa.gov/data/latest_obs/latest_obs.txt","source_terms_url":"https://www.weather.gov/disclaimer","license":"U.S. public domain (NOAA/NWS); no implied endorsement by NOAA","attribution":"Source: NOAA National Data Buoy Center. Public domain; NOAA does not endorse AurAgrid.","rate_limit":"30 requests/minute per IP"},{"path":"/api/v1/derived/fee-timing","name":"Bitcoin Fee-Timing Signal","tier":"bitcoin","description":"Where the current 6-block fee sits in its 24-hour and 7-day distribution, the 6-hour trend, the lowest fees observed and the UTC hours with the lowest median fee over 7 days. Descriptive statistics from AurAgrid's own node, not a forecast.","access":"free","auth":"none","status":"preview","method":"derived","inputs":["/api/v1/batch/btc-fees"],"update_interval_seconds":60,"stale_after_seconds":900,"source":"Derived by AurAgrid (see provenance.derivation)","license":"AurAgrid's own computation; use under AurAgrid's /terms","rate_limit":"30 requests/minute per IP","proposed_price_usd":0.02,"pricing_note":"Free preview; a price is proposed and awaits the owner's approval."},{"path":"/api/v1/derived/area-risk","name":"Seismic and Marine Flags Near a Point","tier":"hazards","description":"Earthquake counts (M2.5+ 24 h, M4.5+ 7 days) and the highest measured waves, wind and gusts from NOAA buoys within radius_km of lat/lon, with threshold flags. Measured values only.","access":"free","auth":"none","status":"preview","method":"derived","inputs":["/api/v1/batch/earthquakes","/api/v1/batch/maritime-weather"],"update_interval_seconds":600,"stale_after_seconds":3600,"source":"Derived by AurAgrid (see provenance.derivation)","license":"Derived from U.S. public-domain data (USGS, NOAA); credit both, no implied endorsement","rate_limit":"30 requests/minute per IP","proposed_price_usd":0.02,"pricing_note":"Free preview; a price is proposed and awaits the owner's approval.","parameters":{"lat":"latitude, -90..90","lon":"longitude, -180..180","radius_km":"10..2000 (default 500)"}},{"path":"/api/v1/derived/energy-snapshot","name":"U.S. Energy Snapshot","tier":"energy","description":"Lower-48 electricity demand and generation shares, SPR and commercial crude stocks, and U.S. LNG exports in one document, each part with its own as_of and stale flag.","access":"free","auth":"none","status":"preview","method":"derived","inputs":["/api/v1/energy/grid","/api/v1/batch/spr-stockpile","/api/v1/batch/lng-supply-chain"],"update_interval_seconds":43200,"stale_after_seconds":3888000,"source":"Derived by AurAgrid (see provenance.derivation)","license":"Derived from EIA data (public domain); credit EIA, no implied endorsement","rate_limit":"30 requests/minute per IP","proposed_price_usd":0.02,"pricing_note":"Free preview; a price is proposed and awaits the owner's approval."},{"path":"/api/v1/derived/grid-carbon","name":"U.S. Grid Carbon Intensity","tier":"energy","description":"Direct CO2 intensity (g/kWh) of the Lower 48 and every EIA-930 region and balancing authority, from the hourly generation mix and EIA's 2023 per-fuel emission rates.","access":"free","auth":"none","status":"preview","method":"derived","inputs":["/api/v1/energy/grid"],"update_interval_seconds":900,"stale_after_seconds":21600,"source":"Derived by AurAgrid (see provenance.derivation)","license":"Derived from EIA data (public domain); credit EIA, no implied endorsement","rate_limit":"30 requests/minute per IP","proposed_price_usd":0.03,"pricing_note":"Free preview; a price is proposed and awaits the owner's approval."}],"plans":[{"name":"lightning-operator","title":"Lightning Operator Bundle - Bitcoin fees + Lightning network (30 days)","kind":"bundle","paths":["/api/v1/bundle/btc-fees","/api/v1/bundle/ln-network"],"token_ttl_seconds":2592000,"auth":"L402","pricing":"static","price_sats":5000,"price_usd_approx":3.0102,"quote_url":"/api/v1/price/bundle/btc-fees","samples":["/api/v1/batch/btc-fees-delayed","/api/v1/batch/ln-network-daily"]}],"checkout_url":"https://84.12.79.124/buy","payment_protocol":"L402","signature":{"scheme":"auragrid_attest_v2","header":"X-AurAgrid-Signature-V2","timestamp_header":"X-AurAgrid-Timestamp","nonce_request_header":"X-AurAgrid-Nonce","message_lines":["auragrid_attest_v2","<METHOD>","<path?query as sent>","<sha256 hex of body>","<unix timestamp>","<nonce or ->"],"message_join":"newline","format":"LND signmessage (zbase32 recoverable ECDSA); recover the key and compare it to pubkey","enabled":true,"pubkey":"038041ef6643bb59d9ec73568a952183b261683968cb4000b547302fa464cf8228"}}