{"openapi":"3.1.0","info":{"title":"StatePulse API","description":"Pay-per-call live telemetry, environmental metrics, transit state vectors, and real-time utilities for AI agents. No account setup required, pay per request with x402 USDC on Base.","version":"1.0.0","contact":{"email":"support@statepulse.dev"},"termsOfService":"https://statepulse-api.hahavoid0.workers.dev/terms","x-logo":{"url":"https://statepulse-api.hahavoid0.workers.dev/logo.svg"},"x-agent-card":"https://statepulse-api.hahavoid0.workers.dev/.well-known/agent-card.json"},"servers":[{"url":"https://statepulse-api.hahavoid0.workers.dev"}],"externalDocs":{"description":"x402 and A2A metadata","url":"https://statepulse-api.hahavoid0.workers.dev/.well-known/x402.json"},"paths":{"/product/barcode":{"post":{"operationId":"lookupBarcode","summary":"Universal Barcode & Retail Product Metadata Lookup","description":"Resolves a UPC/EAN or ISBN barcode into detailed product metadata using OpenLibrary and UPCitemdb free search endpoints.","tags":["commerce","barcode","lookup"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"asset":"USDC","network":"eip155:8453","protocols":[{"x402":{}}]},"x-bazaar":{"discoverable":true,"category":"commerce","tags":["commerce","barcode","lookup"],"input":{"method":"POST","body":{"type":"object","required":["barcode"],"properties":{"barcode":{"type":"string","description":"UPC, EAN, or ISBN barcode number","examples":["9780140449136"]}}}},"output":{"type":"object","properties":{"supported":{"type":"boolean"},"result":{"type":"object"}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["barcode"],"properties":{"barcode":{"type":"string","description":"UPC, EAN, or ISBN barcode number","examples":["9780140449136"]}}},"examples":{"default":{"value":{"barcode":"9780140449136"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"supported":{"type":"boolean"},"result":{"type":"object"}}},"examples":{"default":{"value":{"supported":true,"result":{"title":"The Odyssey","brand":"Penguin Classics","category":"Books","image":"https://covers.openlibrary.org/b/id/8240502-M.jpg","metadata":{"page_count":560,"author":"Homer"}},"confidence":"high"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required"}}}},"/airspace/track":{"post":{"operationId":"trackAirspace","summary":"Global Air Traffic & Flight State Vectors","description":"Queries live airspace vectors for a specific aircraft ICAO24 hex identifier or a regional bounding box using OpenSky Network.","tags":["logistics","airspace","flight"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"asset":"USDC","network":"eip155:8453","protocols":[{"x402":{}}]},"x-bazaar":{"discoverable":true,"category":"logistics","tags":["logistics","airspace","flight"],"input":{"method":"POST","body":{"type":"object","properties":{"icao24":{"type":"string","description":"24-bit ICAO aircraft address in hex","examples":["3c6444"]},"bbox":{"type":"object","properties":{"lamin":{"type":"number","description":"Latitude minimum"},"lomin":{"type":"number","description":"Longitude minimum"},"lamax":{"type":"number","description":"Latitude maximum"},"lomax":{"type":"number","description":"Longitude maximum"}}}}}},"output":{"type":"object"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"icao24":{"type":"string","description":"24-bit ICAO aircraft address in hex","examples":["3c6444"]},"bbox":{"type":"object","properties":{"lamin":{"type":"number","description":"Latitude minimum"},"lomin":{"type":"number","description":"Longitude minimum"},"lamax":{"type":"number","description":"Latitude maximum"},"lomax":{"type":"number","description":"Longitude maximum"}}}}},"examples":{"default":{"value":{"icao24":"3c6444"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"examples":{"default":{"value":{"supported":true,"result":{"icao24":"3c6444","callsign":"DLH456","origin_country":"Germany","longitude":-122.301,"latitude":47.443,"altitude_m":11200,"on_ground":false,"velocity_mps":242.5,"heading":184},"confidence":"high"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required"}}}},"/environment/air-quality":{"post":{"operationId":"getAirQuality","summary":"Hyperlocal Air Quality & Environmental Conditions","description":"Retrieves live localized air quality indices (AQI) and pollutant levels for a given latitude/longitude using OpenAQ.","tags":["environment","air-quality","lookup"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"asset":"USDC","network":"eip155:8453","protocols":[{"x402":{}}]},"x-bazaar":{"discoverable":true,"category":"environment","tags":["environment","air-quality","lookup"],"input":{"method":"POST","body":{"type":"object","required":["lat","lng"],"properties":{"lat":{"type":"number","examples":[34.05]},"lng":{"type":"number","examples":[-118.24]}}}},"output":{"type":"object"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["lat","lng"],"properties":{"lat":{"type":"number","examples":[34.05]},"lng":{"type":"number","examples":[-118.24]}}},"examples":{"default":{"value":{"lat":34.05,"lng":-118.24}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"examples":{"default":{"value":{"supported":true,"result":{"aqi":42,"label":"Good","coordinates":{"lat":34.05,"lng":-118.24},"measurements":[{"parameter":"pm25","value":9.8,"unit":"µg/m³"}]},"confidence":"medium"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required"}}}},"/transit/status":{"post":{"operationId":"getTransitStatus","summary":"Global Public Transit Alerts & Delays","description":"Check transit delays, active alerts, and schedule status updates for supported cities and lines.","tags":["transit","commute","alerts"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"asset":"USDC","network":"eip155:8453","protocols":[{"x402":{}}]},"x-bazaar":{"discoverable":true,"category":"transit","tags":["transit","commute","alerts"],"input":{"method":"POST","body":{"type":"object","required":["city","line"],"properties":{"city":{"type":"string","examples":["nyc"]},"line":{"type":"string","examples":["L"]}}}},"output":{"type":"object"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["city","line"],"properties":{"city":{"type":"string","examples":["nyc"]},"line":{"type":"string","examples":["L"]}}},"examples":{"default":{"value":{"city":"nyc","line":"L"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"examples":{"default":{"value":{"supported":true,"result":{"city":"nyc","line":"L","status":"Good Service","delays":false,"alerts":[]},"confidence":"medium"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required"}}}},"/weather/anomaly":{"post":{"operationId":"getWeatherAnomaly","summary":"Dark Sky / Open-Meteo Historic Weather Anomalies","description":"Compares current weather conditions with a 10-year historical average to flag climate anomalies.","tags":["weather","anomaly","environment"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"asset":"USDC","network":"eip155:8453","protocols":[{"x402":{}}]},"x-bazaar":{"discoverable":true,"category":"weather","tags":["weather","anomaly","environment"],"input":{"method":"POST","body":{"type":"object","required":["lat","lng"],"properties":{"lat":{"type":"number","examples":[40.71]},"lng":{"type":"number","examples":[-74]}}}},"output":{"type":"object"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["lat","lng"],"properties":{"lat":{"type":"number","examples":[40.71]},"lng":{"type":"number","examples":[-74]}}},"examples":{"default":{"value":{"lat":40.71,"lng":-74}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"examples":{"default":{"value":{"supported":true,"result":{"current_temp_c":24.2,"historical_mean_temp_c":21,"deviation_percentage":15.2,"anomaly_status":"above_average"},"confidence":"high"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required"}}}},"/radio/stream-url":{"post":{"operationId":"getRadioStream","summary":"Live Radio & Podcast Stream Audio Extraction","description":"Resolves direct Shoutcast/Icecast streaming URLs from an open-source radio station database by country or tag.","tags":["media","radio","audio"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"asset":"USDC","network":"eip155:8453","protocols":[{"x402":{}}]},"x-bazaar":{"discoverable":true,"category":"media","tags":["media","radio","audio"],"input":{"method":"POST","body":{"type":"object","required":["country"],"properties":{"country":{"type":"string","examples":["Morocco"]},"genre":{"type":"string","examples":["news"]}}}},"output":{"type":"object"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["country"],"properties":{"country":{"type":"string","examples":["Morocco"]},"genre":{"type":"string","examples":["news"]}}},"examples":{"default":{"value":{"country":"Morocco","genre":"news"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"examples":{"default":{"value":{"supported":true,"result":{"station_name":"Chada FM","stream_url":"http://stream.chadafm.ma:8000/;","bitrate":128},"confidence":"high"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required"}}}},"/network/dns-propagation":{"post":{"operationId":"checkDnsPropagation","summary":"DNS Watch / Dig-Web-Interface Record Checker","description":"Checks global MX, TXT, A, and CNAME propagation status using Cloudflare DoH endpoints.","tags":["network","dns","utilities"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"asset":"USDC","network":"eip155:8453","protocols":[{"x402":{}}]},"x-bazaar":{"discoverable":true,"category":"network","tags":["network","dns","utilities"],"input":{"method":"POST","body":{"type":"object","required":["domain","type"],"properties":{"domain":{"type":"string","examples":["google.com"]},"type":{"type":"string","examples":["MX"]}}}},"output":{"type":"object"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domain","type"],"properties":{"domain":{"type":"string","examples":["google.com"]},"type":{"type":"string","examples":["MX"]}}},"examples":{"default":{"value":{"domain":"google.com","type":"MX"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"examples":{"default":{"value":{"supported":true,"result":{"domain":"google.com","type":"MX","records":["10 smtp.google.com"]},"confidence":"high"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required"}}}},"/brand/assets":{"post":{"operationId":"getBrandAssets","summary":"Canva / Brandfetch Color & Logo Scraper","description":"Extracts brand logos and theme colors for any public business URL using Clearbit and HTML parsing.","tags":["brand","design","utilities"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"asset":"USDC","network":"eip155:8453","protocols":[{"x402":{}}]},"x-bazaar":{"discoverable":true,"category":"brand","tags":["brand","design","utilities"],"input":{"method":"POST","body":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","examples":["spotify.com"]}}}},"output":{"type":"object"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","examples":["spotify.com"]}}},"examples":{"default":{"value":{"domain":"spotify.com"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"examples":{"default":{"value":{"supported":true,"result":{"logo":"https://logo.clearbit.com/spotify.com","colors":["#1db954"]},"confidence":"high"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required"}}}},"/prediction/odds":{"post":{"operationId":"getPredictionOdds","summary":"PredictIt / ElectionBettingOdds Market Tracker","description":"Retrieves live betting market prices and contract odds for global geopolitical events using PredictIt.","tags":["prediction","market","utilities"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"asset":"USDC","network":"eip155:8453","protocols":[{"x402":{}}]},"x-bazaar":{"discoverable":true,"category":"prediction","tags":["prediction","market","utilities"],"input":{"method":"POST","body":{"type":"object","properties":{"market_id":{"type":"number","description":"PredictIt market ID","examples":[7000]}}}},"output":{"type":"object"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"market_id":{"type":"number","description":"PredictIt market ID","examples":[7000]}}},"examples":{"default":{"value":{"market_id":7000}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"examples":{"default":{"value":{"supported":true,"result":{"market_name":"U.S. General Election Outcome","contracts":[{"name":"Democratic Party","price":0.52}]},"confidence":"high"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required"}}}},"/water/streamflow":{"post":{"operationId":"getWaterStreamflow","summary":"USGS WaterData River Level Tracker","description":"Queries live US river level, streamflow gauge height, and flow velocity metrics using the USGS National Water Information System.","tags":["water","logistics","agriculture"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"asset":"USDC","network":"eip155:8453","protocols":[{"x402":{}}]},"x-bazaar":{"discoverable":true,"category":"water","tags":["water","logistics","agriculture"],"input":{"method":"POST","body":{"type":"object","required":["state"],"properties":{"state":{"type":"string","examples":["CA"]}}}},"output":{"type":"object"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["state"],"properties":{"state":{"type":"string","examples":["CA"]}}},"examples":{"default":{"value":{"state":"CA"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"examples":{"default":{"value":{"supported":true,"result":{"state":"CA","stations":[{"name":"Sacramento River","flow_cfs":9400,"height_ft":12.2}]},"confidence":"high"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required"}}}},"/calendar/holidays":{"post":{"operationId":"getHolidays","summary":"Nager.Date National Bank Holiday Lookup","description":"Retrieves local bank and public holidays across 100+ countries to verify business days.","tags":["holidays","calendar","utilities"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"asset":"USDC","network":"eip155:8453","protocols":[{"x402":{}}]},"x-bazaar":{"discoverable":true,"category":"holidays","tags":["holidays","calendar","utilities"],"input":{"method":"POST","body":{"type":"object","required":["year","country_code"],"properties":{"year":{"type":"number","examples":[2026]},"country_code":{"type":"string","examples":["US"]}}}},"output":{"type":"object"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["year","country_code"],"properties":{"year":{"type":"number","examples":[2026]},"country_code":{"type":"string","examples":["US"]}}},"examples":{"default":{"value":{"year":2026,"country_code":"US"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"examples":{"default":{"value":{"supported":true,"result":{"holidays":[{"date":"2026-01-01","name":"New Year's Day"}]},"confidence":"high"}}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required"}}}}}}