StatePulse API logo StatePulse API

Autonomous Telemetry
& Utilities for AI Agents

Machine-readable live telemetry, environmental metrics, route logistics, and execution utilities built specifically for AI agents. No signups or API keys required — pay-per-call natively using x402 USDC on Base mainnet.

Explore Directory OpenAPI Spec
System Success Rate (SLA) 100.00%
Total Endpoints 56 Live
Universal Barcode & Retail Product Metadata Lookup $0.020 USDC
Global Air Traffic & Flight State Vectors $0.030 USDC
Hyperlocal Air Quality & Environmental Conditions $0.030 USDC
Live Public Transit Alerts & Delays (NYC MTA) $0.030 USDC
Settlement Chain Base Mainnet (EIP-155:8453)
Settlement Wallet 0x4a82F1...56E85bFE
x402 Volume 208 Settled Calls
Credit Deposits $0.000 USDC
Total API Revenue $7.101 USDC

Prepaid Key Vault

Send Base USDC to the Settlement Wallet to purchase API credits, then claim your key below:

Endpoints Directory

Showing 56 of 56 endpoints

Universal Barcode & Retail Product Metadata Lookup

POST /product/barcode

Resolves a UPC/EAN or ISBN barcode into detailed product metadata using OpenLibrary and UPCitemdb free search endpoints.

When to Use: Use when an agent needs to turn a raw barcode number into rich product details, title, and metadata.
Do Not Use For: Do not use for live in-store stock checking at local retail counters.

Global Air Traffic & Flight State Vectors

POST /airspace/track

Queries live airspace vectors for a specific aircraft ICAO24 hex identifier or a regional bounding box using OpenSky Network.

When to Use: Use when an agent needs live flight tracking coordinate details (lat, lng, altitude, speed) for an aircraft.
Do Not Use For: Do not use for flight ticket bookings or airport arrival terminal gate lookups.

Hyperlocal Air Quality & Environmental Conditions

POST /environment/air-quality

Retrieves live localized air quality indices (AQI) and pollutant levels for a given latitude/longitude using OpenAQ.

When to Use: Use when an agent needs the local air quality index (AQI) or specific PM2.5 counts for a coordinate location.
Do Not Use For: Do not use for indoor air quality sensor details or weather precipitation radar.

Live Public Transit Alerts & Delays (NYC MTA)

POST /transit/status

Live subway alerts, delays, and planned-work advisories from the official MTA GTFS-RT feed for NYC lines. Other cities can be requested via the free /agent/request-data endpoint.

When to Use: Use when an agent needs real-world transit status or delays for trip scheduling.
Do Not Use For: Do not use for direct ticket buying or booking private taxis.

Dark Sky / Open-Meteo Historic Weather Anomalies

POST /weather/anomaly

Compares current weather conditions with a 10-year historical average to flag climate anomalies.

When to Use: Use when an agricultural, energy-trading, or supply-chain agent needs to detect unusual local temperatures.
Do Not Use For: Do not use as a simple rain/snow forecast for daily commuter alerts.

Live Radio & Podcast Stream Audio Extraction

POST /radio/stream-url

Resolves direct Shoutcast/Icecast streaming URLs from an open-source radio station database by country or tag.

When to Use: Use when a monitoring or translation agent needs a live audio streaming source URL for news scraping.
Do Not Use For: Do not use for downloading static MP3 files of individual podcast episodes.

DNS Watch / Dig-Web-Interface Record Checker

POST /network/dns-propagation

Checks global MX, TXT, A, and CNAME propagation status using Cloudflare DoH endpoints.

When to Use: Use when verifying TXT/MX records during server setup or routing updates.
Do Not Use For: Do not use for managing domain registrations or renewing host names.

Canva / Brandfetch Color & Logo Scraper

POST /brand/assets

Extracts brand logos and theme colors for any public business URL using Clearbit and HTML parsing.

When to Use: Use when an agent needs SVG/PNG logo links and brand hex colors for frontend component layout generation.
Do Not Use For: Do not use for registering trademarks or searching copyright catalogs.

Polymarket Prediction Market Tracker

POST /prediction/odds

Retrieves live public prediction-market prices and contract odds from Polymarket's Gamma data API.

When to Use: Use when hedging geopolitical or macro indicators in trading pipelines.
Do Not Use For: Do not use for placing real bets or registering online gaming balances.

USGS WaterData River Level Tracker

POST /water/streamflow

Queries live US river level, streamflow gauge height, and flow velocity metrics using the USGS National Water Information System.

When to Use: Use when planning irrigation or identifying flood alerts for asset positioning.
Do Not Use For: Do not use for checking local city drinking tap water quality details.

Nager.Date National Bank Holiday Lookup

POST /calendar/holidays

Retrieves local bank and public holidays across 100+ countries to verify business days.

When to Use: Use when validating if a day is a working day before triggering B2B schedules.
Do Not Use For: Do not use for personal family anniversary or appointment calendar entries.

USGS Live Earthquake Seismic Activity Tracker

POST /environment/earthquake

Queries the USGS Earthquake Hazards API for recent earthquakes exceeding a minimum magnitude.

When to Use: Use when an agent needs to check for recent earthquake activity or assess local seismic threats.
Do Not Use For: Do not use for historical geological studies spanning decades or predicting future earthquakes.

NASA EONET Active Wildfire Incident Tracker

POST /environment/wildfire

Scans NASA EONET for currently open wildfire incidents and their latest reported geometry. Matches: active wildfire detector, NASA wildfire coordinates, forest fire alert, wildfire tracking map, active fire incidents.

When to Use: Use when evaluating if active wildfire hazards or forest fires disrupt agricultural assets, logistics cargo shipping routes, or real estate listings.
Do Not Use For: Do not use for managing live fire containment lines or structural fire calls.

NOAA Live Solar Storm & Geomagnetic Alert System

POST /environment/space-weather

Retrieves the current planetary K-Index and active solar storms from NOAA SWPC. Matches: space weather solar storm alert, planetary k-index monitor, geomagnetic activity tracker, solar flare satellite warnings, coronal mass ejection tracking.

When to Use: Use when checking solar flare alerts, geomagnetic solar storm warnings, or K-index spikes that can cause GPS telemetry drift or radio communications anomalies.
Do Not Use For: Do not use for local weather forecast predictions.

Hyperlocal Pollen & Allergen Live Forecast

POST /environment/pollen

Queries pollen allergen index counts (grass, birch, oak) by coordinate using Open-Meteo.

When to Use: Use when checking environmental allergen profiles for health or ventilation assistant agents.
Do Not Use For: Do not use for diagnosing individual allergy medical symptoms.

NOAA NDBC Wave Height & Sea Temperature Tracker

POST /water/marine-conditions

Fetches live observation data for a specific NOAA marine buoy station.

When to Use: Use when an offshore or drone-boat navigation agent needs wave height, wave period, or water temp metrics.
Do Not Use For: Do not use for fresh inland lake or swimming pool assessments.

USGS Streamflow River Gauge Height & Flood Alert System

POST /water/flood-warnings

Scans active USGS gauge heights in a US state for potential river flooding. Matches: streamflow flood alerts, USGS gauge height warnings, river level flood checker, water streamflow warnings, river overflow stage alerts.

When to Use: Use when evaluating river flood alerts, USGS streamflow warnings, or gauge height alerts for inland assets, agricultural positioning, or real estate risk triage.
Do Not Use For: Do not use for coastal tide tables or sewer overflow alerts.

Open-Meteo Current UV Index & Sun-Safety Triage

POST /environment/uv-index

Retrieves the current solar UV Index and calculates sun safety burn times.

When to Use: Use to dynamically triage sunburn hazards and solar radiation index levels.
Do Not Use For: Do not use for general temperature or weather rainfall forecast alerts.

Open-Meteo Current Lightning Strike Potential

POST /environment/lightning-density

Queries the hourly lightning potential indices for coordinates.

When to Use: Use when validating if lightning threat risks interfere with drone operations or outdoor activities.
Do Not Use For: Do not use for downloading static lightning map radar graphics.

Signed IP Geolocation Presence Verification Oracle

POST /location/verify-presence

Validates an IP address's physical route and latency offsets to verify country compliance, returning a cryptographically signed Geolocation Certificate. Matches: geolocate ip check, secure location verification, ip route validator, compliant network geodata.

When to Use: Use when an agent needs to prove or check that a server or client node resides in a specific regulatory jurisdiction.
Do Not Use For: Do not use as a general IP routing traceroute tool.

Global AIS Cargo Ship & Vessel Location Tracker

POST /transit/marine-vessel

Resolves current coordinate telemetry and voyage details for a cargo ship by MMSI number through public VesselFinder data, with AISStream as an optional live WebSocket fallback.

When to Use: 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.
Do Not Use For: Do not use for yacht bookings or private recreational vessel communications.

OpenData European Railway Station Board & Delays

POST /transit/rail-status

Queries live train departures and schedule delays for European transit hubs using transport.opendata.ch.

When to Use: Use when scheduling business trips or verifying train connection delays for travelers.
Do Not Use For: Do not use for buying train tickets or local subway tracking.

Live Route Toll Fee Calculator

POST /transit/toll-cost

Calculates route toll estimates through Google Routes when origin and destination coordinates or addresses plus GOOGLE_MAPS_API_KEY are configured. State-only distance inputs are not treated as authoritative prices.

When to Use: Use when planning overland shipping routes and verifying travel toll costs for logistics budgeting or autonomous vehicle dispatching.
Do Not Use For: Do not use for paying tolls online or registering transponders.

Open Charge Map EV Charging Station Live Finder

POST /transit/ev-charger

Locates public electric vehicle charging stations within a given radius using Open Charge Map.

When to Use: Use to route autonomous electric delivery cars or robotic agents to active charging stations.
Do Not Use For: Do not use for booking or paying for a charging slot.

OpenStreetMap OSRM Driving Distance & Duration Calculator

POST /transit/route-duration

Computes the shortest driving distance and duration between two coordinates using the public OSRM engine.

When to Use: Use to estimate driving times and distances for delivery dispatches or travel planning agents.
Do Not Use For: Do not use for step-by-step driving turn-by-turn nav prompts.

Live Airport Traffic Board

POST /transit/airport-board

Retrieves recent arrivals from OpenSky when available, with a keyless nearby-aircraft fallback from Airplanes.live. The fallback is explicitly labeled as live traffic, not confirmed arrivals.

When to Use: Use when an automated dispatch agent monitors airport arrival status to verify landing timestamps of passenger or cargo flights.
Do Not Use For: Do not use for terminal baggage claim gates or buying airplane tickets.

FAA US Airport Live Ground Stop & Delay Checker

POST /transit/faa-delays

Queries the FAA public API for active delays, ground stops, and weather statuses for a US airport. Matches: air traffic control delays, US airport ground stops, flight weather delays, FAA flight restrictions, airport layout status.

When to Use: Use when flight cargo routes or travelers need to check active ground stops, delays, or air traffic control weather halts at a US airport.
Do Not Use For: Do not use for flight parking booking or checking luggage weight limits.

US State & County Sales Tax Rate Triage

POST /finance/sales-tax

Locates the combined sales tax rate (state, county, local) for a US ZIP code using Ziptax, with Zippopotam used only for location enrichment. Matches: sales tax rate calculator, zip code tax lookup, commercial sales tax checker, e-commerce tax estimator, state county city tax rates.

When to Use: Use to calculate sales tax percentages before finalizing a checkout, invoice, or billing statement in e-commerce workflows.
Do Not Use For: Do not use for filing state/federal tax returns or local business tax receipts.

Keyless Public Patent Metadata Lookup

POST /intellectual-property/patent

Queries a public Google Patents page for grant metadata without a key, with the official PatentsView Search API used when PATENTSVIEW_API_KEY is configured for richer structured data.

When to Use: Use when an agent needs to verify patent filing details, status, title, assignee, or inventors for technology scouting and competitor research.
Do Not Use For: Do not use for formal legal search clearance opinions or filing applications.

Trademark Registry Brand Name Checker

POST /intellectual-property/trademark

Performs a first-pass wordmark conflict search against a daily-synchronized USPTO trademark index. This is a screening result, not a legal clearance opinion.

When to Use: Use when an agent needs to perform a first-pass, automated conflict check before naming products, registering domains, or launching brands.
Do Not Use For: Do not use for final trademark filings or litigation opinions.

Nasdaq Stock Exchange Circuit Breaker & Halts Tracker

POST /finance/halts

Parses the Nasdaq Trader RSS feed for active or recent stock trading halts.

When to Use: Use to evaluate if an active stock ticker has had trading halted due to news or volatility.
Do Not Use For: Do not use for downloading historical intraday tick trades.

Federal Reserve Current Target & Discount Rate

POST /finance/fed-rate

Retrieves the latest effective federal funds rate and primary-credit (discount-window) rate from the New York Fed and Federal Reserve H.15 data feeds.

When to Use: Use when interest rate pricing is needed for smart contract borrowing or financial calculations.
Do Not Use For: Do not use for individual bank deposit interest rates.

Company & Corporate Registry Information Finder

POST /finance/company-lookup

Searches the SEC EDGAR registry (US public and SEC-registered companies) to retrieve registered business address, state of incorporation, SIC industry classification, and CIK/ticker identifiers. Matches: corporate registration check, company status finder, look up business incorporation details, verify corporate address lookup.

When to Use: 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.
Do Not Use For: Do not use for downloading detailed credit history report files or auditing full corporate tax filings.

Cross-Market Perpetual Arbitrage & Funding Yield Triage

POST /finance/arbitrage

Queries live funding rates and mark-index spreads from centralised perp indices to locate yield arbitrage opportunities. Matches: arbitrage finder, funding rate arbitrage, cross-chain yield, spot-perp spread, perp funding rates checker.

When to Use: Use when an agent wants to find high-yield cross-market perpetual swap funding rate spreads or spot-perp arbitrage opportunities.
Do Not Use For: Do not use as a direct trade executing router or order submission endpoint.

Sourcify Verified Contract ABI Resolver

POST /blockchain/abi

Resolves the contract interface JSON (ABI) for Sourcify-verified smart contracts on Base or Ethereum, with Blockscout as a fallback. Matches: verified ABI fetcher, contract JSON interface loader, decode transaction calldata helpers, verified contract methods parser.

When to Use: 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.
Do Not Use For: Do not use for unverified contracts or generating private contract code.

EVM Transaction Execution Simulator

POST /blockchain/simulate

Runs eth_call state simulation against the Base blockchain RPC to check for transaction reverts. Matches: EVM revert checks, test contract call, inspect transaction failure, dry-run solidity method, gas estimator, test token swap failure, simulate multisig transaction execution.

When to Use: 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.
Do Not Use For: Do not use for actually submitting signed transactions to the pool.

Base Blockchain Gas Fee History & Trend Tracker

POST /blockchain/gas-history

Scans recent block gas details to estimate the minimum, average, and maximum base fee.

When to Use: Use when an agent wants to find cheap gas fee windows to execute heavy transactions.
Do Not Use For: Do not use for calculating exact gas limits for individual calls.

Multi-Chain Wallet Token Balance Scanner

POST /blockchain/balances

Scans native balance and ERC-20 token balances for a wallet address on Base or Ethereum.

When to Use: Use when an agent needs to monitor the stablecoin or native asset balance of a wallet.
Do Not Use For: Do not use for signing balance transfers or modifying wallet ownership.

Binance Futures Live Perp Funding Rates Ticker

POST /blockchain/funding-rates

Queries current pricing and funding rate margins for perpetual swap contracts from Binance.

When to Use: Use when calculating delta-neutral yield margins or perp arbitrage funding offsets.
Do Not Use For: Do not use for placing leverage orders or managing collateral margins.

Token Contract Rug-Pull & Ownership Risk Composite

POST /blockchain/token-safety

One call that bundles the checks needed before trusting an unfamiliar ERC-20 token: scans deployed bytecode for dangerous function selectors (mint/pause/blacklist), reads on-chain owner() to check if ownership was renounced, and cross-references DexScreener for liquidity depth and pair age — returning a single risk score with flags. Matches: rug pull check, token safety score, is this token safe, contract risk scan, honeypot pre-check, ownership renounced check, liquidity risk.

When to Use: 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.
Do Not Use For: Do not use as a full security audit or as legal/investment advice; bytecode selector matching is a heuristic and can miss obfuscated or proxy contracts.

DNSSEC & CAA Record Security Auditor

POST /network/dns-security

Queries DNSSEC (DS) and Certification Authority Authorization (CAA) records for a domain using Cloudflare DoH.

When to Use: Use to verify domain name security signing and certificate issuance policies.
Do Not Use For: Do not use for managing DNS zone files or configuring nameservers.

SSL Certificate Handshake Expiration Monitor

POST /network/ssl-expiry

Extracts certificate validity dates and expiration countdown for a domain using public certificate-transparency logs.

When to Use: Use when an IT monitor agent checks if website certificates are valid or close to expiration.
Do Not Use For: Do not use for downloading certificate private keys.

HTTP Security Header Quality Auditor

POST /network/security-headers

Fetches target URL headers to score configurations (HSTS, CSP, X-Frame-Options).

When to Use: Use when an auditor or system integration agent evaluates web host settings.
Do Not Use For: Do not use for downloading target webpage content bodies.

Geocoding City Timezone & Local Time Checker

POST /location/timezone-checker

Resolves the local time, offset, and daylight savings status for a city name using Open-Meteo Geocoding.

When to Use: Use when scheduling notifications or execution scripts to prevent calls during late local hours.
Do Not Use For: Do not use for downloading static map coordinate files.

USGS Streamflow River Water Temperature Monitor

POST /water/stream-temp

Queries live stream water temperature telemetry from active USGS gauges in a US state.

When to Use: Use when an agricultural, aquacultural, or cooling agent needs live water temperature checks.
Do Not Use For: Do not use for household tap water quality checking.

Domain WHOIS & Registry Expiration Checker

POST /network/whois

Queries the global RDAP bootstrap directory for domain registration details, registrar name, creation date, and expiration timestamp. Matches: domain registration checker, WHOIS lookup tool, check domain owner registry, check website expiry date.

When to Use: 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.
Do Not Use For: Do not use for registering domain names or performing bulk domain auction searches.

IP Geolocation & Threat Intelligence Scanner

POST /network/ip-lookup

Scans an IPv4 or IPv6 address using public geodata to resolve location, country, ISP, autonomous system, and hosting flags. Matches: geolocate IP address, check client IP country, query ISP metadata, threat intelligence proxy check, hosting provider detector.

When to Use: Use when an automated security agent or crawler checks geolocation, ISP ASN info, or hosting provider tags to identify scraping bots or proxy traffic.
Do Not Use For: Do not use for looking up domain DNS records or local subnet router tables.

Comprehensive Network Host & VPS Security Auditor

POST /network/audit

Scans an IP address or hostname to audit DNSSEC safety, SSL expiration status, HTTP security headers, and geodata compliance. Matches: network security audit, scan website ports, VPS shield test, audit host headers.

When to Use: 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.
Do Not Use For: Do not use for launching active distributed denial of service (DDoS) tests or scanning internal intranet subnets.

Deposit Real Onchain USDC Bounty (Base Mainnet)

POST /coordination/bounties

Deposits a real USDC bounty on Base using EIP-3009 receiveWithAuthorization, locking it in the non-custodial EscrowRegistry contract. Matches: deposit onchain bounty, non-custodial escrow bounty, lock usdc bounty.

When to Use: Use when an agent wants to lock real USDC on Base to coordinate and incentivize a task payout.
Do Not Use For: Do not use for testing without real USDC on Base Mainnet.

Release Deployed USDC Bounty (Base Mainnet)

POST /coordination/bounties/release

Triggers the EscrowRegistry contract to release a locked USDC bounty to a worker wallet. Releasing can only be authorized by the StatePulse hot wallet (owner). Matches: release onchain bounty, payout escrow bounty, resolve locked bounty.

When to Use: Use to payout a locked USDC bounty once the task is verified as completed.
Do Not Use For: Do not use for testing without real USDC locked in the escrow contract.

Relay Gasless Transaction (Base Mainnet)

POST /blockchain/send

Relays a transaction to Base Mainnet, paying the native gas on your behalf and charging your wallet equivalent USDC via EIP-3009 receiveWithAuthorization. Matches: gasless tx relayer, submit transaction base, pay gas in usdc.

When to Use: Use when an agent wants to execute a transaction on Base without maintaining an ETH balance for gas.
Do Not Use For: Do not use for read-only contract calls (use /blockchain/simulate instead).

Request Missing Live Data (Free) — Tell Us What Your Agent Needs

Free
POST /agent/request-data

FREE endpoint. If your agent needs live data this API does not serve yet — a feed, a metric, a lookup, another city or chain — describe it here. Requests are reviewed and frequently-requested data becomes a real endpoint, usually within days; re-fetch openapi.json or llms.txt to see new endpoints. Submitting a request directly helps your agent: the data you ask for is prioritized so it exists the next time you need it. Matches: data not available, missing endpoint, request new data source, feature request, no endpoint for this, wish this API had.

When to Use: 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.
Do Not Use For: Do not use to fetch data — this only registers a request. Do not submit secrets or personal data.

Submit Feedback on an Endpoint (Free)

Free
POST /agent/feedback

FREE endpoint. Report anything about this API: wrong or stale data, an endpoint that failed, pricing that feels off, or something that worked well. Feedback is reviewed and data-quality reports are fixed with priority — submitting one directly improves the results your agent gets on its next call. Matches: report wrong data, endpoint broken, stale result, API feedback, rate this API.

When to Use: Use after any call that returned wrong, stale, or surprising data — or to rate an endpoint. Free; data-quality reports get fixed with priority.
Do Not Use For: Do not use to request new data (use /agent/request-data) or to fetch data.

Suggest Endpoint Pricing (Free) — Signal Willingness-to-Pay

Free
POST /agent/suggest-price

FREE endpoint. If a paid endpoint's pricing is too high, suggest a target price based on alternative sources, budget limitations, or query frequency. Feedback is used to optimize pricing decisions.

When to Use: Use when an endpoint is too expensive for your budget to trigger a price reduction review.
Do Not Use For: Do not use to run real endpoint queries or make payments.

Capabilities Diff Discovery (Free) — Match Needs & Request Gaps

Free
POST /agent/capabilities-diff

FREE endpoint. Submit an array of data or capability needs. The API returns details on matching endpoints we currently serve and automatically logs unmatched needs as roadmap requests.

When to Use: Use before starting a complex task to determine if the required tools exist, and request them in bulk if they don't.
Do Not Use For: Do not use to query actual real-time telemetry.

Interactive Console

Pick an endpoint from the left or select it here, review/edit the request JSON, then click "Send Request".

Automatic x402 Protocol Integration

Direct Agent Execution: To invoke paid endpoints, agents negotiate the x402 protocol challenge. When receiving a 402 Payment Required response, parse the payment-required header containing payment specifications, initiate a Base USDC transfer, and resubmit the request with the X-Payment header.

    

Add StatePulse to your IDE (MCP Config)

StatePulse runs a Model Context Protocol (MCP) server. You can integrate all 50+ tools directly into Cursor, Windsurf, or Claude Desktop.

Claude Desktop Config

Add this server entry to your claude_desktop_config.json:

{
  "mcpServers": {
    "statepulse": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-http",
        "https://statepulse-api.hahavoid0.workers.dev/mcp"
      ]
    }
  }
}

Cursor / Windsurf Config

Go to Settings > Models > MCP (or Windsurf config), click + Add New MCP Server:

  • Name: statepulse
  • Type: command
  • Command: npx -y @modelcontextprotocol/server-http https://statepulse-api.hahavoid0.workers.dev/mcp