Try an endpoint
Every endpoint below is documented with its exact JSON schema in openapi.json. Copy the AgentCash command and run it, or POST the JSON body directly with x402 payment headers.
Universal Barcode & Retail Product Metadata Lookup
Use when an agent needs to turn a raw barcode number into rich product details, title, and metadata.
POST /product/barcode — $0.020 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/product/barcode -m POST -b '{"barcode":"9780140449136"}'Global Air Traffic & Flight State Vectors
Use when an agent needs live flight tracking coordinate details (lat, lng, altitude, speed) for an aircraft.
POST /airspace/track — $0.030 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/airspace/track -m POST -b '{"icao24":"3c6444"}'Hyperlocal Air Quality & Environmental Conditions
Use when an agent needs the local air quality index (AQI) or specific PM2.5 counts for a coordinate location.
POST /environment/air-quality — $0.030 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/environment/air-quality -m POST -b '{"lat":34.05,"lng":-118.24}'Live Public Transit Alerts & Delays (NYC MTA)
Use when an agent needs real-world transit status or delays for trip scheduling.
POST /transit/status — $0.030 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/transit/status -m POST -b '{"city":"nyc","line":"L"}'Dark Sky / Open-Meteo Historic Weather Anomalies
Use when an agricultural, energy-trading, or supply-chain agent needs to detect unusual local temperatures.
POST /weather/anomaly — $0.030 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/weather/anomaly -m POST -b '{"lat":40.71,"lng":-74}'Live Radio & Podcast Stream Audio Extraction
Use when a monitoring or translation agent needs a live audio streaming source URL for news scraping.
POST /radio/stream-url — $0.010 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/radio/stream-url -m POST -b '{"country":"Morocco","genre":"news"}'DNS Watch / Dig-Web-Interface Record Checker
Use when verifying TXT/MX records during server setup or routing updates.
POST /network/dns-propagation — $0.010 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/network/dns-propagation -m POST -b '{"domain":"google.com","type":"MX"}'Canva / Brandfetch Color & Logo Scraper
Use when an agent needs SVG/PNG logo links and brand hex colors for frontend component layout generation.
POST /brand/assets — $0.020 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/brand/assets -m POST -b '{"domain":"spotify.com"}'Polymarket Prediction Market Tracker
Use when hedging geopolitical or macro indicators in trading pipelines.
POST /prediction/odds — $0.020 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/prediction/odds -m POST -b '{}'USGS WaterData River Level Tracker
Use when planning irrigation or identifying flood alerts for asset positioning.
POST /water/streamflow — $0.030 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/water/streamflow -m POST -b '{"state":"CA"}'Nager.Date National Bank Holiday Lookup
Use when validating if a day is a working day before triggering B2B schedules.
POST /calendar/holidays — $0.010 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/calendar/holidays -m POST -b '{"year":2026,"country_code":"US"}'USGS Live Earthquake Seismic Activity Tracker
Use when an agent needs to check for recent earthquake activity or assess local seismic threats.
POST /environment/earthquake — $0.020 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/environment/earthquake -m POST -b '{"min_magnitude":4}'NASA EONET Active Wildfire Incident Tracker
Use when evaluating if active wildfire hazards or forest fires disrupt agricultural assets, logistics cargo shipping routes, or real estate listings.
POST /environment/wildfire — $0.050 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/environment/wildfire -m POST -b '{"state":"CA"}'NOAA Live Solar Storm & Geomagnetic Alert System
Use when checking solar flare alerts, geomagnetic solar storm warnings, or K-index spikes that can cause GPS telemetry drift or radio communications anomalies.
POST /environment/space-weather — $0.050 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/environment/space-weather -m POST -b '{}'Hyperlocal Pollen & Allergen Live Forecast
Use when checking environmental allergen profiles for health or ventilation assistant agents.
POST /environment/pollen — $0.020 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/environment/pollen -m POST -b '{"lat":52.52,"lng":13.405}'NOAA NDBC Wave Height & Sea Temperature Tracker
Use when an offshore or drone-boat navigation agent needs wave height, wave period, or water temp metrics.
POST /water/marine-conditions — $0.030 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/water/marine-conditions -m POST -b '{"buoy_id":"46042"}'USGS Streamflow River Gauge Height & Flood Alert System
Use when evaluating river flood alerts, USGS streamflow warnings, or gauge height alerts for inland assets, agricultural positioning, or real estate risk triage.
POST /water/flood-warnings — $0.050 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/water/flood-warnings -m POST -b '{"state":"CA"}'Open-Meteo Current UV Index & Sun-Safety Triage
Use to dynamically triage sunburn hazards and solar radiation index levels.
POST /environment/uv-index — $0.020 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/environment/uv-index -m POST -b '{"lat":34.05,"lng":-118.24}'Open-Meteo Current Lightning Strike Potential
Use when validating if lightning threat risks interfere with drone operations or outdoor activities.
POST /environment/lightning-density — $0.020 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/environment/lightning-density -m POST -b '{"lat":34.05,"lng":-118.24}'Signed IP Geolocation Presence Verification Oracle
Use when an agent needs to prove or check that a server or client node resides in a specific regulatory jurisdiction.
POST /location/verify-presence — $0.500 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/location/verify-presence -m POST -b '{"ip":"8.8.8.8","expected_country":"US"}'Global AIS Cargo Ship & Vessel Location Tracker
Use when a shipping agent or logistics bot needs to verify the real-time position, speed, destination port, or current heading of an ocean cargo container vessel using AIS global transponder feeds.
POST /transit/marine-vessel — $0.150 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/transit/marine-vessel -m POST -b '{"mmsi":"205792000"}'OpenData European Railway Station Board & Delays
Use when scheduling business trips or verifying train connection delays for travelers.
POST /transit/rail-status — $0.020 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/transit/rail-status -m POST -b '{"station":"Zurich HB"}'Live Route Toll Fee Calculator
Use when planning overland shipping routes and verifying travel toll costs for logistics budgeting or autonomous vehicle dispatching.
POST /transit/toll-cost — $0.080 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/transit/toll-cost -m POST -b '{"origin":{"lat":40.7128,"lng":-74.006},"destination":{"lat":40.758,"lng":-73.9855}}'Open Charge Map EV Charging Station Live Finder
Use to route autonomous electric delivery cars or robotic agents to active charging stations.
POST /transit/ev-charger — $0.020 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/transit/ev-charger -m POST -b '{"lat":34.05,"lng":-118.24}'OpenStreetMap OSRM Driving Distance & Duration Calculator
Use to estimate driving times and distances for delivery dispatches or travel planning agents.
POST /transit/route-duration — $0.020 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/transit/route-duration -m POST -b '{"start_lat":34.05,"start_lng":-118.24,"end_lat":34.14,"end_lng":-118.14}'Live Airport Traffic Board
Use when an automated dispatch agent monitors airport arrival status to verify landing timestamps of passenger or cargo flights.
POST /transit/airport-board — $0.050 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/transit/airport-board -m POST -b '{"airport_icao":"EDDF"}'FAA US Airport Live Ground Stop & Delay Checker
Use when flight cargo routes or travelers need to check active ground stops, delays, or air traffic control weather halts at a US airport.
POST /transit/faa-delays — $0.050 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/transit/faa-delays -m POST -b '{"airport_code":"SFO"}'US State & County Sales Tax Rate Triage
Use to calculate sales tax percentages before finalizing a checkout, invoice, or billing statement in e-commerce workflows.
POST /finance/sales-tax — $0.040 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/finance/sales-tax -m POST -b '{"zip_code":"90210"}'Keyless Public Patent Metadata Lookup
Use when an agent needs to verify patent filing details, status, title, assignee, or inventors for technology scouting and competitor research.
POST /intellectual-property/patent — $0.120 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/intellectual-property/patent -m POST -b '{"patent_number":"10000000"}'Trademark Registry Brand Name Checker
Use when an agent needs to perform a first-pass, automated conflict check before naming products, registering domains, or launching brands.
POST /intellectual-property/trademark — $0.100 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/intellectual-property/trademark -m POST -b '{"word":"Apple"}'Nasdaq Stock Exchange Circuit Breaker & Halts Tracker
Use to evaluate if an active stock ticker has had trading halted due to news or volatility.
POST /finance/halts — $0.020 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/finance/halts -m POST -b '{}'Federal Reserve Current Target & Discount Rate
Use when interest rate pricing is needed for smart contract borrowing or financial calculations.
POST /finance/fed-rate — $0.020 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/finance/fed-rate -m POST -b '{}'Company & Corporate Registry Information Finder
Use when an agent or B2B compliance checker needs to verify that a business is active, lookup its registered corporate office address, or retrieve its incorporation/registration ID.
POST /finance/company-lookup — $0.100 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/finance/company-lookup -m POST -b '{"company_name":"Apple","country_code":"us"}'Cross-Market Perpetual Arbitrage & Funding Yield Triage
Use when an agent wants to find high-yield cross-market perpetual swap funding rate spreads or spot-perp arbitrage opportunities.
POST /finance/arbitrage — $0.250 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/finance/arbitrage -m POST -b '{"min_funding_rate":0.0001}'Sourcify Verified Contract ABI Resolver
Use when an on-chain coding or execution agent needs to inspect a contract's verified ABI interface or methods to encode call arguments or decode transaction event logs dynamically.
POST /blockchain/abi — $0.005 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/blockchain/abi -m POST -b '{"address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","chain":"base"}'EVM Transaction Execution Simulator
Use when an on-chain coding agent or auto-trader needs to check if a contract transaction (e.g. Uniswap swap, lending deposit, claim tokens) will succeed, revert, or fail before paying network transaction gas fees.
POST /blockchain/simulate — $0.050 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/blockchain/simulate -m POST -b '{"to":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","data":"0x70a082310000000000000000000000000000000000000000000000000000000000000000"}'Base Blockchain Gas Fee History & Trend Tracker
Use when an agent wants to find cheap gas fee windows to execute heavy transactions.
POST /blockchain/gas-history — $0.001 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/blockchain/gas-history -m POST -b '{"blocks":20}'Multi-Chain Wallet Token Balance Scanner
Use when an agent needs to monitor the stablecoin or native asset balance of a wallet.
POST /blockchain/balances — $0.001 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/blockchain/balances -m POST -b '{"wallet":"0x4a82F147c8A4339409C9097Adc1EedFd56E85bFE"}'Binance Futures Live Perp Funding Rates Ticker
Use when calculating delta-neutral yield margins or perp arbitrage funding offsets.
POST /blockchain/funding-rates — $0.002 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/blockchain/funding-rates -m POST -b '{"symbol":"BTCUSDT"}'Token Contract Rug-Pull & Ownership Risk Composite
Use before an agent trades, bridges, or holds an unfamiliar ERC-20 token — surfaces mint/pause/blacklist risk, ownership renouncement, and liquidity depth in one call.
POST /blockchain/token-safety — $0.050 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/blockchain/token-safety -m POST -b '{"address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}'DNSSEC & CAA Record Security Auditor
Use to verify domain name security signing and certificate issuance policies.
POST /network/dns-security — $0.010 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/network/dns-security -m POST -b '{"domain":"google.com"}'SSL Certificate Handshake Expiration Monitor
Use when an IT monitor agent checks if website certificates are valid or close to expiration.
POST /network/ssl-expiry — $0.010 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/network/ssl-expiry -m POST -b '{"domain":"google.com"}'HTTP Security Header Quality Auditor
Use when an auditor or system integration agent evaluates web host settings.
POST /network/security-headers — $0.020 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/network/security-headers -m POST -b '{"url":"https://google.com"}'Geocoding City Timezone & Local Time Checker
Use when scheduling notifications or execution scripts to prevent calls during late local hours.
POST /location/timezone-checker — $0.020 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/location/timezone-checker -m POST -b '{"city":"Tokyo"}'USGS Streamflow River Water Temperature Monitor
Use when an agricultural, aquacultural, or cooling agent needs live water temperature checks.
POST /water/stream-temp — $0.020 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/water/stream-temp -m POST -b '{"state":"CA"}'Domain WHOIS & Registry Expiration Checker
Use when an IT monitor agent or security bot needs to verify domain registration dates, registrar details, or check if a domain is close to expiration.
POST /network/whois — $0.040 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/network/whois -m POST -b '{"domain":"google.com"}'IP Geolocation & Threat Intelligence Scanner
Use when an automated security agent or crawler checks geolocation, ISP ASN info, or hosting provider tags to identify scraping bots or proxy traffic.
POST /network/ip-lookup — $0.020 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/network/ip-lookup -m POST -b '{"ip":"8.8.8.8"}'Comprehensive Network Host & VPS Security Auditor
Use when a server monitoring agent or compliance bot needs a complete security profile of a web server or agent VPS in a single call.
POST /network/audit — $0.100 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/network/audit -m POST -b '{"host":"google.com"}'Onchain Transaction Preflight — Bundled GO/NO-GO Check
Use as the single pre-send check before an autonomous agent or auto-trader broadcasts an onchain transaction: confirms it won't revert, the sender can pay gas, and gas is reasonable — in one call.
POST /agent/preflight — $0.030 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/agent/preflight -m POST -b '{"wallet":"0x4a82F147c8A4339409C9097Adc1EedFd56E85bFE","to":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","data":"0x70a082310000000000000000000000000000000000000000000000000000000000000000","chain":"base"}'Deposit Real Onchain USDC Bounty (Base Mainnet)
Use when an agent wants to lock real USDC on Base to coordinate and incentivize a task payout.
POST /coordination/bounties — $0.010 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/coordination/bounties -m POST -b '{"title":"Solve Maze Task","description":"Submit exit path coordinates","reward_usdc":"10.00","duration_days":7,"sender":"0x742d35Cc6634C0532925a3b844Bc454e4438f44e","nonce":"0x0000000000000000000000000000000000000000000000000000000000000001","valid_before":1800000000,"signature":"0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","bounty_id":"0x000000000000000000000000000000000000000000000000000000000000000a"}'Release Deployed USDC Bounty (Base Mainnet)
Use to payout a locked USDC bounty once the task is verified as completed.
POST /coordination/bounties/release — $0.010 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/coordination/bounties/release -m POST -b '{"bounty_id":"0x000000000000000000000000000000000000000000000000000000000000000a","worker_wallet":"0x976EA74026E726554dB657fa54763abd0C3a0aa9"}'Relay Gasless Transaction (Base Mainnet)
Use when an agent wants to execute a transaction on Base without maintaining an ETH balance for gas.
POST /blockchain/send — $0.010 USDC
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/blockchain/send -m POST -b '{"target_contract":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","calldata":"0x095ea7b300000000000000000000000055014c5b9781682b3cd1eedfd56e85bfe4a33251ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff","max_gas_fee_usdc":"0.50","sender":"0x742d35Cc6634C0532925a3b844Bc454e4438f44e","nonce":"0x0000000000000000000000000000000000000000000000000000000000000002","valid_before":1800000000,"signature":"0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"}'Request Missing Live Data (Free) — Tell Us What Your Agent Needs
Use whenever this API (or any API) lacks the live data your agent needs. It is free and directly increases the chance the data exists on your next run.
POST /agent/request-data — free
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/agent/request-data -m POST -b '{"requested_data":"Live transit alerts for London Underground lines","example_query":"{\"city\":\"london\",\"line\":\"victoria\"}","category":"transit","max_price_usd":0.02}'Submit Feedback on an Endpoint (Free)
Use after any call that returned wrong, stale, or surprising data — or to rate an endpoint. Free; data-quality reports get fixed with priority.
POST /agent/feedback — free
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/agent/feedback -m POST -b '{"feedback":"Funding rates matched Bybit exactly — reliable.","endpoint":"/finance/arbitrage","rating":5}'Suggest Endpoint Pricing (Free) — Signal Willingness-to-Pay
Use when an endpoint is too expensive for your budget to trigger a price reduction review.
POST /agent/suggest-price — free
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/agent/suggest-price -m POST -b '{"endpoint_path":"/blockchain/simulate","suggested_price_usd":0.05,"reason":"Alternative provider charges $0.04","agent_wallet":"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"}'Capabilities Diff Discovery (Free) — Match Needs & Request Gaps
Use before starting a complex task to determine if the required tools exist, and request them in bulk if they don't.
POST /agent/capabilities-diff — free
npx agentcash@latest fetch https://statepulse-api.hahavoid0.workers.dev/agent/capabilities-diff -m POST -b '{"needs":["US bank holidays","DNS propagation","real-time stock pricing"],"agent_wallet":"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"}'