{"openapi":"3.1.0","info":{"title":"Data Lookup API (x402-seller)","version":"e9e0490","description":"Pay-per-call data API for AI agents via the x402 protocol. Every endpoint costs $0.001 in USDC on Base — no accounts, no API keys. Call any endpoint, receive a 402 with payment requirements, retry with a signed payment header."},"servers":[{"url":"https://x402-seller.onrender.com"}],"tags":[{"name":"geo"},{"name":"energy"},{"name":"finance"},{"name":"weather"},{"name":"geology"},{"name":"hazards"},{"name":"environment"},{"name":"space"},{"name":"blockchain"},{"name":"government"},{"name":"ocean"},{"name":"water"},{"name":"risk"},{"name":"fire"},{"name":"transparency"},{"name":"demographics"},{"name":"routing"}],"paths":{"/geo/lookup":{"get":{"operationId":"geoLookup","summary":"Forward geocode an address to coordinates and timezone","description":"Forward geocode a free-text address, place name, or city (e.g. \"Tokyo, Japan\") into geographic coordinates — latitude and longitude — plus its IANA timezone. Use this to convert a location description into coordinates for mapping, distance, or timezone-aware lookups, or as the first step before coordinate-based endpoints like weather forecasts.","tags":["geo"],"x-price":"$0.001","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.001","currency":"USDC"},"parameters":[{"name":"address","in":"query","required":true,"description":"Address or place name to geocode","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"lat":{"type":"number"},"lng":{"type":"number"},"timezone":{"type":"string"},"display_name":{"type":"string"}}},"example":{"query":"Tokyo, Japan","lat":35.6762,"lng":139.6503,"timezone":"Asia/Tokyo","display_name":"Tokyo, Japan"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/geo/reverse":{"get":{"operationId":"geoReverse","summary":"Reverse geocode coordinates to a place name and timezone","description":"Reverse geocode GPS coordinates (latitude/longitude) into a place name/address and IANA timezone.","tags":["geo"],"x-price":"$0.001","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.001","currency":"USDC"},"parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude","schema":{"type":"string"}},{"name":"lng","in":"query","required":true,"description":"Longitude","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"lat":{"type":"number"},"lng":{"type":"number"},"timezone":{"type":"string"},"display_name":{"type":"string"}}},"example":{"lat":35.6762,"lng":139.6503,"timezone":"Asia/Tokyo","display_name":"Tokyo, Japan"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/oil/price":{"get":{"operationId":"oilPrice","summary":"Latest WTI or Brent crude oil spot price","description":"Current crude oil price in USD per barrel — WTI or Brent spot price from the U.S. Energy Information Administration (EIA). Reflects the latest official daily figure, not live or real-time trading data; lags the market by several business days.","tags":["energy","finance"],"x-price":"$0.005","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.005","currency":"USDC"},"parameters":[{"name":"benchmark","in":"query","required":false,"description":"Which crude oil benchmark to fetch","schema":{"type":"string","enum":["wti","brent"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"commodity":{"type":"string"},"benchmark":{"type":"string"},"price":{"type":"number"},"unit":{"type":"string"},"date":{"type":"string"},"source":{"type":"string"}}},"example":{"commodity":"crude oil","benchmark":"WTI","price":73.2,"unit":"Dollars per Barrel","date":"2026-07-15","source":"U.S. Energy Information Administration (EIA)"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/gas/price":{"get":{"operationId":"gasPrice","summary":"Latest Henry Hub natural gas spot price","description":"Latest Henry Hub natural gas spot price (USD/MMBtu), sourced from the U.S. Energy Information Administration. Data lags several business days behind the market; not live trading data.","tags":["energy","finance"],"x-price":"$0.001","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.001","currency":"USDC"},"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"commodity":{"type":"string"},"benchmark":{"type":"string"},"price":{"type":"number"},"unit":{"type":"string"},"date":{"type":"string"},"source":{"type":"string"}}},"example":{"commodity":"natural gas","benchmark":"Henry Hub","price":3.12,"unit":"Dollars per Million Btu","date":"2026-07-15","source":"U.S. Energy Information Administration (EIA)"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/electricity/price":{"get":{"operationId":"electricityPrice","summary":"Latest US retail electricity price","description":"Current average U.S. retail price of electricity, in cents per kilowatt-hour (cents/kWh) — e.g. \"what's the electricity price right now\". Reflects the latest monthly data (not real-time), averaged across all sectors combined (not sector-specific), sourced from the U.S. Energy Information Administration (EIA). Optional 'state' param (2-letter code) returns that state's average instead of the national figure.","tags":["energy"],"x-price":"$0.001","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.001","currency":"USDC"},"parameters":[{"name":"state","in":"query","required":false,"description":"2-letter US state code, or 'US' for national average","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string"},"price":{"type":"number"},"unit":{"type":"string"},"date":{"type":"string"},"source":{"type":"string"}}},"example":{"region":"U.S. Total","price":12.5,"unit":"cents per kilowatt-hour","date":"2026-04","source":"U.S. Energy Information Administration (EIA)"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/weather/forecast":{"get":{"operationId":"weatherForecast","summary":"Official US weather forecast by coordinates","description":"Official U.S. National Weather Service (NWS) forecast for the next period — the nearest upcoming forecast window, e.g. today, tonight, or tomorrow — at a given latitude/longitude. US locations only. Use /geo/lookup first if you only have an address.","tags":["weather"],"x-price":"$0.01","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.01","currency":"USDC"},"parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude (US locations only)","schema":{"type":"string"}},{"name":"lng","in":"query","required":true,"description":"Longitude (US locations only)","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"period":{"type":"string"},"temperature":{"type":"number"},"temperatureUnit":{"type":"string"},"shortForecast":{"type":"string"},"detailedForecast":{"type":"string"},"windSpeed":{"type":"string"},"windDirection":{"type":"string"},"source":{"type":"string"}}},"example":{"location":"LWX","period":"Tonight","temperature":68,"temperatureUnit":"F","shortForecast":"Partly Cloudy","detailedForecast":"Partly cloudy, with a low around 68.","windSpeed":"5 mph","windDirection":"SW","source":"National Weather Service (NOAA)"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/nuclear/outages":{"get":{"operationId":"nuclearOutages","summary":"Daily US nuclear power plant outage data","description":"Current U.S. nuclear power outage levels, updated daily: nationwide total generating capacity, megawatts offline, and percent outage. Aggregate figure for the whole U.S. reactor fleet, not broken out by individual plant or reactor. Sourced from the U.S. Nuclear Regulatory Commission via EIA.","tags":["energy"],"x-price":"$0.001","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.001","currency":"USDC"},"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string"},"capacityMw":{"type":"number"},"outageMw":{"type":"number"},"percentOutage":{"type":"number"},"source":{"type":"string"}}},"example":{"date":"2026-07-15","capacityMw":96731,"outageMw":3200,"percentOutage":3.3,"source":"U.S. Energy Information Administration (EIA) / Nuclear Regulatory Commission"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/earthquakes/recent":{"get":{"operationId":"earthquakesRecent","summary":"Recent significant earthquakes worldwide","description":"Check for recent significant earthquakes, quakes, or seismic activity anywhere in the world, from the past 7 days, sourced from USGS (US Geological Survey). Answers questions like \"was there an earthquake near me\", \"how strong was the recent quake in X\", or \"list major earthquakes this week\". Optional 'minmagnitude' filters by minimum magnitude (default 4.5), and 'limit' caps the number of results (default 10, max 50).","tags":["geology","hazards"],"x-price":"$0.001","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.001","currency":"USDC"},"parameters":[{"name":"minmagnitude","in":"query","required":false,"description":"Minimum earthquake magnitude","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max number of results (max 50)","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"number"},"earthquakes":{"type":"array"},"source":{"type":"string"}}},"example":{"count":1,"earthquakes":[{"place":"12 km ESE of Anza, CA","magnitude":4.6,"time":"2026-07-15T19:00:38.550Z","depthKm":10.9,"lat":33.494,"lng":-116.561,"url":"https://earthquake.usgs.gov/earthquakes/eventpage/ci41439016"}],"source":"U.S. Geological Survey (USGS)"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/currency/rate":{"get":{"operationId":"currencyRate","summary":"Official daily currency exchange rate","description":"Currency exchange rate for converting between any two currencies (forex/FX rate), drawn from a set of 30+ major currencies, sourced from the European Central Bank's official daily reference rates. Updates once per business day (~16:00 CET) — not a live or intraday feed.","tags":["finance"],"x-price":"$0.008","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.008","currency":"USDC"},"parameters":[{"name":"from","in":"query","required":false,"description":"3-letter currency code (default EUR)","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"3-letter currency code (default USD)","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"},"rate":{"type":"number"},"date":{"type":"string"},"source":{"type":"string"}}},"example":{"from":"USD","to":"JPY","rate":157.23,"date":"2026-07-15","source":"European Central Bank (ECB)"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/air/quality":{"get":{"operationId":"airQuality","summary":"Current US air quality index readings","description":"Current U.S. EPA Air Quality Index (AQI) and pollution levels for a specific location, given latitude/longitude — use to check smog, air pollution, or whether it's safe to be outside. Sourced from the EPA AirNow program (federal/state/local/tribal agencies); covers the US, Canada, and Mexico only. Data is preliminary and unvalidated per EPA data use guidelines — not for regulatory use.","tags":["environment","weather"],"x-price":"$0.001","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.001","currency":"USDC"},"parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude","schema":{"type":"string"}},{"name":"lng","in":"query","required":true,"description":"Longitude","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"reportingArea":{"type":"string"},"stateCode":{"type":"string"},"date":{"type":"string"},"hour":{"type":"number"},"readings":{"type":"array"},"preliminary":{"type":"boolean"},"attribution":{"type":"string"},"source":{"type":"string"}}},"example":{"reportingArea":"San Francisco","stateCode":"CA","date":"2026-07-16","hour":14,"readings":[{"pollutant":"PM2.5","aqi":42,"category":"Good"},{"pollutant":"O3","aqi":38,"category":"Good"}],"preliminary":true,"attribution":"Data owned by federal, state, local, and tribal air quality agencies, distributed via the U.S. EPA AirNow program.","source":"U.S. EPA AirNow"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/space/asteroids":{"get":{"operationId":"spaceAsteroids","summary":"Near-Earth asteroids by closest approach date","description":"Near-Earth asteroids (NEOs) making their closest approach to Earth on a given date (default: today), sorted by distance -- also called close-approach or flyby data. Includes each asteroid's estimated size, relative velocity, and miss distance. Sourced from NASA JPL's Near Earth Object Web Service (NeoWs).","tags":["space"],"x-price":"$0.001","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.001","currency":"USDC"},"parameters":[{"name":"date","in":"query","required":false,"description":"YYYY-MM-DD, defaults to today","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string"},"count":{"type":"number"},"asteroids":{"type":"array"},"source":{"type":"string"}}},"example":{"date":"2026-07-16","count":1,"asteroids":[{"name":"465633 (2009 JR5)","hazardous":false,"diameterKmMin":0.19,"diameterKmMax":0.43,"velocityKph":28123.5,"missDistanceKm":4576123.9}],"source":"NASA JPL Near Earth Object Web Service (NeoWs)"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/chain/balance":{"get":{"operationId":"chainBalance","summary":"Base mainnet wallet ETH and ERC20 balance","description":"Check a wallet's live balance on Base mainnet: native ETH (e.g. to confirm it has enough for gas) plus an optional ERC20 token balance (e.g. USDC) when a token contract address is supplied. Sourced from Base's official public RPC.","tags":["blockchain"],"x-price":"$0.012","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.012","currency":"USDC"},"parameters":[{"name":"address","in":"query","required":true,"description":"Wallet address (0x...)","schema":{"type":"string"}},{"name":"token","in":"query","required":false,"description":"Optional ERC20 token contract address to also check","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"},"network":{"type":"string"},"ethBalance":{"type":"number"},"token":{"type":["object","null"]},"source":{"type":"string"}}},"example":{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","network":"base","ethBalance":1.2345,"token":null,"source":"Base mainnet public RPC"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/route/hazards":{"get":{"operationId":"routeHazards","summary":"Driving route with active wildfires and weather alerts along it","description":"Driving route between two US points, cross-checked against live hazards along the way: distance and duration, plus any active NIFC wildfires within a corridor of the route and any National Weather Service alerts in force along it. Returns the fires and alerts actually near the path, with distances, rather than a route and a separate hazard lookup.","tags":["geo","routing","fire","weather","risk"],"x-price":"$0.05","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.05","currency":"USDC"},"parameters":[{"name":"from","in":"query","required":true,"description":"Origin as \"lat,lng\"","schema":{"type":"string"}},{"name":"to","in":"query","required":true,"description":"Destination as \"lat,lng\"","schema":{"type":"string"}},{"name":"corridorKm","in":"query","required":false,"description":"How far either side of the route to look for wildfires, km (1-100, default 25)","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"route":{"type":"object","properties":{"distanceKm":{"type":"number"},"durationMinutes":{"type":"number"},"from":{"type":"object"},"to":{"type":"object"},"samplePoints":{"type":"number"}}},"wildfires":{"type":"object","properties":{"corridorKm":{"type":"number"},"countNearRoute":{"type":"number"},"nearest":{"type":["object","null"]},"fires":{"type":"array"}}},"weatherAlerts":{"type":"object","properties":{"sampledPoints":{"type":"number"},"count":{"type":["number","null"]},"alerts":{"type":"array"}}},"hazardsFound":{"type":"boolean"},"source":{"type":"string"},"attribution":{"type":"string"},"disclaimer":{"type":"string"}}},"example":{"route":{"distanceKm":195.3,"durationMinutes":146.7,"from":{"lat":34.0522,"lng":-118.2437,"nearestRoad":"West 1st Street"},"to":{"lat":32.7157,"lng":-117.1611,"nearestRoad":"Broadway"},"samplePoints":27},"wildfires":{"corridorKm":25,"countNearRoute":1,"nearest":{"name":"Border 2","distanceKm":18.4,"bearingFromRoute":"SE","acres":6625,"percentContained":95,"state":"US-CA"},"fires":[{"name":"Border 2","distanceKm":18.4,"bearingFromRoute":"SE","acres":6625,"percentContained":95,"state":"US-CA"}]},"weatherAlerts":{"sampledPoints":3,"count":1,"alerts":[{"event":"Wind Advisory","headline":"Wind Advisory until 8 PM PDT","severity":"Moderate","expires":"2026-08-02T20:00:00-07:00"}]},"hazardsFound":true,"source":"Routing by LocationIQ (data (c) OpenStreetMap contributors, ODbL 1.0); wildfire incidents from NIFC WFIGS; alerts from NOAA National Weather Service","attribution":"Data (c) OpenStreetMap contributors, ODbL 1.0. Routing by LocationIQ.com. Wildfire incident data courtesy of the National Interagency Fire Center (WFIGS).","disclaimer":"Not for emergency, evacuation or life-safety decisions. Hazard proximity is measured to sampled points along the route, not a continuous corridor."}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/space/weather":{"get":{"operationId":"spaceWeather","summary":"Current geomagnetic storm level, solar flare activity and NOAA space weather alerts","description":"Current space weather conditions from NOAA SWPC in one call: planetary Kp index mapped to the official NOAA G-scale geomagnetic storm level, the latest GOES solar X-ray flare with both its current and peak class, and active SWPC alerts and warnings from the last 24 hours. Useful for satellite operations, GPS accuracy, HF radio, polar aviation routes and power-grid impact monitoring.","tags":["space","weather","risk"],"x-price":"$0.51","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.51","currency":"USDC"},"parameters":[{"name":"alertWindowHours","in":"query","required":false,"description":"How far back to include SWPC alerts, in hours (1-168, default 24)","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"geomagnetic":{"type":"object","properties":{"kpIndex":{"type":["number","null"]},"estimatedKp":{"type":["number","null"]},"stormLevel":{"type":["string","null"]},"stormLabel":{"type":["string","null"]},"measuredAt":{"type":["string","null"]}}},"solarFlare":{"type":["object","null"],"properties":{"currentClass":{"type":["string","null"]},"peakClass":{"type":["string","null"]},"significance":{"type":["string","null"]},"beganAt":{"type":["string","null"]},"peakAt":{"type":["string","null"]},"endedAt":{"type":["string","null"]},"ongoing":{"type":"boolean"},"satellite":{"type":["number","null"]}}},"alerts":{"type":"array"},"alertWindowHours":{"type":"number"},"alertsInWindow":{"type":"number"},"alertsExcludedOutsideWindow":{"type":"number"},"alertsAvailable":{"type":"boolean"},"source":{"type":"string"},"attribution":{"type":"string"},"disclaimer":{"type":"string"}}},"example":{"geomagnetic":{"kpIndex":0,"estimatedKp":0,"stormLevel":"G0","stormLabel":"None","measuredAt":"2026-07-30T22:13:00Z"},"solarFlare":{"currentClass":"C2.1","peakClass":"M1.9","significance":"moderate","beganAt":"2026-07-30T15:53:00Z","peakAt":"2026-07-30T17:00:00Z","endedAt":null,"ongoing":true,"satellite":18},"alerts":[{"productId":"ALTPX1","issuedAt":"2026-07-30T19:03:19Z","code":"ALTPX1","summary":"Proton Event 10MeV Integral Flux exceeded 10pfu"}],"alertWindowHours":24,"alertsInWindow":3,"alertsExcludedOutsideWindow":114,"alertsAvailable":true,"source":"NOAA Space Weather Prediction Center (SWPC)","attribution":"Space weather data from NOAA SWPC (public domain).","disclaimer":"Not an official NOAA product. For authoritative alerts see swpc.noaa.gov."}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/treasury/debt":{"get":{"operationId":"treasuryDebt","summary":"US national debt to the penny","description":"Current total U.S. national debt outstanding — how much the U.S. government owes right now — from the Treasury's 'Debt to the Penny' data: total public debt outstanding, debt held by the public, and intragovernmental holdings. Updated each business day by the U.S. Treasury.","tags":["finance","government"],"x-price":"$0.001","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.001","currency":"USDC"},"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string"},"totalDebt":{"type":"number"},"debtHeldByPublic":{"type":"number"},"intragovernmentalHoldings":{"type":"number"},"unit":{"type":"string"},"source":{"type":"string"}}},"example":{"date":"2026-07-17","totalDebt":39581848442144.38,"debtHeldByPublic":31816915417245.04,"intragovernmentalHoldings":7764933024899.34,"unit":"US dollars","source":"U.S. Department of the Treasury, Fiscal Data (Debt to the Penny)"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/ocean/tides":{"get":{"operationId":"oceanTides","summary":"US tide predictions and observed water levels","description":"U.S. coastal tide data from NOAA — when's the next high or low tide, or what's the water level right now: high/low tide predictions for the next 48 hours (product=predictions, default), or the latest observed water level (product=water_level). Identify the location by NOAA CO-OPS station ID, or just pass lat+lng and the nearest station is used automatically (distanceKm in the response says how far it is). Heights in feet above MLLW datum, times in GMT.","tags":["ocean","weather"],"x-price":"$0.001","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.001","currency":"USDC"},"parameters":[{"name":"station","in":"query","required":false,"description":"NOAA CO-OPS station ID (e.g. 9414290 for San Francisco); omit to resolve by lat/lng instead","schema":{"type":"string"}},{"name":"lat","in":"query","required":false,"description":"Latitude — used with lng to find the nearest NOAA station when no station ID is given","schema":{"type":"string"}},{"name":"lng","in":"query","required":false,"description":"Longitude — used with lat to find the nearest NOAA station when no station ID is given","schema":{"type":"string"}},{"name":"product","in":"query","required":false,"description":"predictions = next 48h high/low tides (default); water_level = latest observed reading","schema":{"type":"string","enum":["predictions","water_level"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"station":{"type":"string"},"stationName":{"type":["string","null"]},"lat":{"type":["number","null"]},"lng":{"type":["number","null"]},"distanceKm":{"type":"number","description":"Distance from the requested lat/lng to the station used; only present when resolved by lat/lng"},"product":{"type":"string"},"datum":{"type":"string"},"units":{"type":"string"},"timeZone":{"type":"string"},"tides":{"type":"array","description":"High/low tide predictions for the next 48 hours; present only when product=predictions"},"time":{"type":"string","description":"Observation time (GMT); present only when product=water_level"},"heightFt":{"type":"number","description":"Observed water level in feet above MLLW; present only when product=water_level"},"preliminary":{"type":"boolean","description":"True if the reading is preliminary/unverified; present only when product=water_level"},"source":{"type":"string"}}},"example":{"station":"9414290","stationName":"San Francisco","lat":37.8063,"lng":-122.4659,"distanceKm":6.51,"product":"predictions","datum":"MLLW","units":"feet","timeZone":"GMT","tides":[{"time":"2026-07-20 11:43","heightFt":4.222,"type":"H"}],"source":"NOAA Center for Operational Oceanographic Products and Services (CO-OPS)"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/water/streamflow":{"get":{"operationId":"waterStreamflow","summary":"Real-time US river streamflow and gauge height","description":"Real-time river and stream conditions at a USGS stream gauge — current streamflow/discharge (cubic feet per second) and gauge height/water level/stage (feet), i.e. how much water is flowing and how high it is right now. Data is provisional and subject to revision. Requires a USGS site number (e.g. 09380000 = Colorado River at Lees Ferry, AZ).","tags":["water","environment"],"x-price":"$0.001","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.001","currency":"USDC"},"parameters":[{"name":"site","in":"query","required":true,"description":"USGS site number (e.g. 09380000)","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"siteName":{"type":["string","null"]},"lat":{"type":["number","null"]},"lng":{"type":["number","null"]},"streamflowCfs":{"type":["number","null"]},"gaugeHeightFt":{"type":["number","null"]},"time":{"type":["string","null"]},"provisional":{"type":"boolean"},"attribution":{"type":"string"},"source":{"type":"string"}}},"example":{"site":"09380000","siteName":"COLORADO RIVER AT LEES FERRY, AZ","lat":36.8643,"lng":-111.5879,"streamflowCfs":8770,"gaugeHeightFt":9.51,"time":"2026-07-20T21:15:00.000-07:00","provisional":true,"attribution":"Provisional data subject to revision. See https://waterdata.usgs.gov/nwis/help/?provisional","source":"U.S. Geological Survey (USGS) National Water Information System"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/water/flood-risk":{"get":{"operationId":"waterFloodRisk","summary":"US river level vs official NWS flood stages, with flood category and trend","description":"Flood risk at a US river gauge: current water level measured against the official National Weather Service flood stages (action, minor, moderate, major), how many feet remain before each one is reached, and NOAA's own observed and forecast flood category. Answers \"is this river near flooding\". Takes a USGS site number or an NWS gauge ID. Not every gauge has official flood stages.","tags":["water","environment","risk"],"x-price":"$0.31","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.31","currency":"USDC"},"parameters":[{"name":"site","in":"query","required":false,"description":"USGS site number (e.g. 01646500)","schema":{"type":"string"}},{"name":"lid","in":"query","required":false,"description":"NWS gauge ID (e.g. BRKM2), as an alternative to site","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":["string","null"]},"gauge":{"type":"object"},"observed":{"type":"object"},"forecast":{"type":"object"},"floodStagesFt":{"type":"object"},"feetBelowStage":{"type":"object"},"nextThreshold":{"type":["object","null"]},"trend":{"type":["string","null"]},"usgs":{"type":["object","null"]},"source":{"type":"string"}}},"example":{"site":"01646500","gauge":{"lid":"BRKM2","name":"Potomac River near Washington DC (Little Falls)","matchedBy":"coordinates","matchDistanceKm":0.004},"observed":{"stageFt":2.89,"floodCategory":"no_flooding","time":"2026-07-26T06:45:00Z"},"forecast":{"stageFt":2.9,"floodCategory":"no_flooding","time":"2026-07-26T12:00:00Z"},"floodStagesFt":{"action":5,"minor":10,"moderate":12,"major":14},"feetBelowStage":{"action":2.11,"minor":7.11,"moderate":9.11,"major":11.11},"nextThreshold":{"name":"action","stageFt":5,"feetAway":2.11},"trend":"rising","usgs":{"streamflowCfs":2300,"gaugeHeightFt":2.89},"source":"NOAA/NWS National Water Prediction Service; USGS National Water Information System"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/fire/risk":{"get":{"operationId":"fireRisk","summary":"Active US wildfires near a location, with fire weather and smoke","description":"Active US wildfires near a location, with distance, bearing, size in acres and containment percent for the nearest and largest, plus any National Weather Service Red Flag Warning in force and current air quality as a smoke indicator. Answers \"is there a wildfire near this place right now\". Official incident data, not a legal or emergency source.","tags":["fire","environment","risk"],"x-price":"$0.39","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.39","currency":"USDC"},"parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude","schema":{"type":"string"}},{"name":"lng","in":"query","required":true,"description":"Longitude","schema":{"type":"string"}},{"name":"radiusKm","in":"query","required":false,"description":"Search radius in km (default 100, max 500)","schema":{"type":"string"}},{"name":"minAcres","in":"query","required":false,"description":"Ignore fires smaller than this (default 10)","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"object"},"activeFireCount":{"type":"number"},"countTruncatedUpstream":{"type":"boolean"},"nearest":{"type":["object","null"]},"largest":{"type":["object","null"]},"listTruncated":{"type":"boolean"},"fires":{"type":"array"},"belowMinAcresCount":{"type":"number"},"nearestBelowMinAcres":{"type":["object","null"]},"fireWeather":{"type":["object","null"]},"airQuality":{"type":["object","null"]},"criteria":{"type":"string"},"disclaimer":{"type":"string"},"attribution":{"type":"string"},"source":{"type":"string"}}},"example":{"location":{"lat":34.0522,"lng":-118.2437,"radiusKm":100,"minAcres":10},"activeFireCount":2,"countTruncatedUpstream":false,"nearest":{"name":"SUMMIT","distanceKm":42.1,"bearing":"NE","acres":2690,"percentContained":35,"discovered":"2026-07-21T18:04:00.000Z","lastUpdated":"2026-07-26T17:21:56.140Z","state":"US-CA","cause":"Undetermined","complexity":null},"largest":{"name":"SUMMIT","distanceKm":42.1,"bearing":"NE","acres":2690,"percentContained":35},"listTruncated":false,"fires":[{"name":"SUMMIT","distanceKm":42.1,"bearing":"NE","acres":2690,"percentContained":35}],"belowMinAcresCount":8,"nearestBelowMinAcres":{"name":"LAC-260688","distanceKm":21.4,"bearing":"E","acres":0.01,"percentContained":null},"fireWeather":{"redFlagWarning":true,"alerts":[{"event":"Red Flag Warning","headline":"Red Flag Warning in effect","severity":"Severe","expires":"2026-07-27T03:00:00Z"}]},"airQuality":{"aqi":55,"category":"Moderate","pollutant":"PM2.5","reportingArea":"Los Angeles"},"criteria":"Wildfire incidents over 10 acres, not fully contained, still open, and updated within 14 days.","disclaimer":"Incident data is dynamic, provisional and not a legal document. NIFC gives no warranty as to accuracy or completeness. Not for emergency, evacuation or life-safety decisions.","attribution":"Wildfire incident data courtesy of the National Interagency Fire Center (WFIGS), sourced from IRWIN and the interagency wildland fire community.","source":"National Interagency Fire Center (WFIGS); National Weather Service (NOAA); U.S. EPA AirNow"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/payments/history":{"get":{"operationId":"paymentsHistory","summary":"This seller's own recent USDC settlement history on Base","description":"This seller's own recent USDC settlement history on Base mainnet — every payment received, with transaction hash, payer address, amount, and block number. Use it to confirm whether a specific payment settled, or to audit real payment volume; verifiable on any Base block explorer. Bounded to a recent rolling window (default 24h, max 72h) to keep responses fast. Optional 'address' param filters to one payer wallet.","tags":["finance","transparency"],"x-price":"$0.001","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.001","currency":"USDC"},"parameters":[{"name":"hours","in":"query","required":false,"description":"Lookback window in hours, default 24, max 72","schema":{"type":"string"}},{"name":"address","in":"query","required":false,"description":"Optional: filter to payments from this one payer wallet (0x...)","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"payTo":{"type":"string"},"windowHours":{"type":"number"},"filteredByPayer":{"type":"string"},"count":{"type":"number"},"payments":{"type":"array"},"note":{"type":"string"},"source":{"type":"string"}}},"example":{"payTo":"0xbd61dfb01f81c91f02b0ccd51b0220e0c8918639","windowHours":24,"count":1,"payments":[{"txHash":"0x2b4e98bfedc3311d02fbf673fc6a62475600aca34db837744e685661478ae001","from":"0x6bae57ad66659cdf660e0874d948226696299c71","amountUsdc":0.001,"block":48989927}],"note":"Settlements to this seller's own wallet on Base mainnet, USDC only, over the last 24 hour(s) (max 72). Independently verifiable on any Base block explorer.","source":"Base mainnet public RPC (on-chain USDC Transfer event logs)"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/census/demographics":{"get":{"operationId":"censusDemographics","summary":"US Census ACS 5-Year demographics by ZIP code","description":"US Census Bureau American Community Survey (ACS) 5-Year estimates for a ZIP code: total population, median household income, median age, and total housing units. ZIP codes map to Census ZCTAs (Census-drawn approximations); some ZIPs (PO-box-only or very new) have no ZCTA match and return 404. Reflects a rolling 5-year survey window, not real-time.","tags":["geo","government","demographics"],"x-price":"$0.001","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.001","currency":"USDC"},"parameters":[{"name":"zip","in":"query","required":true,"description":"5-digit US ZIP code","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"zip":{"type":"string"},"zcta":{"type":"string"},"name":{"type":["string","null"]},"population":{"type":["number","null"]},"medianHouseholdIncome":{"type":["number","null"]},"medianAge":{"type":["number","null"]},"housingUnits":{"type":["number","null"]},"vintage":{"type":"string"},"source":{"type":"string"}}},"example":{"zip":"10001","zcta":"10001","name":"ZCTA5 10001","population":30511,"medianHouseholdIncome":129852,"medianAge":35.8,"housingUnits":18356,"vintage":"2020-2024","source":"U.S. Census Bureau American Community Survey (ACS) 5-Year Estimates"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}},"/sec/filings-search":{"get":{"operationId":"secFilingsSearch","summary":"Full-text search across all SEC EDGAR filings since 2001","description":"Full-text search across every SEC EDGAR filing since 2001 (10-K, 10-Q, 8-K, and more) by keyword, company name, or topic. Returns matching filings: company name, ticker (if available), CIK, form type, filing date, accession number, SIC code, and a direct link to the filing. Optional forms filters by comma-separated form type(s); startdt/enddt filter by filing date (YYYY-MM-DD).","tags":["finance","government"],"x-price":"$0.05","x-payment-info":{"protocol":"x402","scheme":"exact","network":"eip155:8453","price":"$0.05","currency":"USDC"},"parameters":[{"name":"q","in":"query","required":true,"description":"Search phrase; quote for an exact phrase match","schema":{"type":"string"}},{"name":"forms","in":"query","required":false,"description":"Comma-separated SEC form types, e.g. '10-K,8-K'","schema":{"type":"string"}},{"name":"startdt","in":"query","required":false,"description":"Filing date range start, YYYY-MM-DD","schema":{"type":"string"}},{"name":"enddt","in":"query","required":false,"description":"Filing date range end, YYYY-MM-DD","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max number of results (default 10, max 50)","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"totalMatches":{"type":"number"},"totalMatchesApproximate":{"type":"boolean"},"count":{"type":"number"},"filings":{"type":"array"},"source":{"type":"string"}}},"example":{"query":"chip shortage","totalMatches":227,"totalMatchesApproximate":false,"count":1,"filings":[{"company":"STRATTEC SECURITY CORP","ticker":"STRT","cik":933034,"formType":"10-K","filingDate":"2022-09-08","accessionNumber":"0001564590-22-031301","sic":"3714","filingUrl":"https://www.sec.gov/Archives/edgar/data/933034/0001564590-22-031301-index.htm"}],"source":"U.S. Securities and Exchange Commission (SEC) EDGAR Full-Text Search"}}}},"402":{"description":"Payment Required — x402 protocol. Retry the request with a signed X-PAYMENT header; payment requirements are in this response's body."}}}}}}