
 ██████╗ ███████╗
 ╚════██╗██╔════╝
  █████╔╝███████╗
 ██╔═══╝ ╚════██║
 ███████╗███████║
 ╚══════╝╚══════╝

> pay-per-call api. agents only.

───── SYSTEM ──────────────────────────────────────

networks

base + solana

asset

USDC on base + solana

base treasury

0x2b6D4988Db4723E6908Db86Ab2b8dFBc51FC32C5

solana treasury

TW6ntaGzvj63ZgPjszd4FCGmVTGfzv1MAYZbjYcyWhn

solana mint

USDC (EPjFWd…Dt1v)

facilitator

api.cdp.coinbase.com

endpoints

ever-expanding

───── DISCOVER ────────────────────────────────────

GET/discoverhtml catalogGET/api/directoryjson catalogGET/api/openapiopenapi 3.1GET/llms.txtllm manifestGET/.well-known/x402service descGET/.well-known/mcp/server-card.jsonmcp card

───── SDKs ───────────────────────────────────────

npm@2sio/sdktypescript clientnpm@2sio/mcpmcp serverpip2siopython clientgo2s-io/sdk/packages/gogo clientgit2s-io/sdksource + examples

───── PAYING ENDPOINTS ────────────────────────────

[ai]

POST/api/ai/describe-imageT2$0.0180

Describe an image.

POST/api/ai/extractT2$0.030

Extract structured data from a webpage.

POST/api/ai/screenshotT2$0.00750

Render a URL as a screenshot.

POST/api/ai/summarizeT2$0.02250

Summarize a webpage.

POST/api/ai/translateT2$0.00750

Translate text.

[airport]

GET/api/airport/lookupT0$0.0010

Look up an airport by 3-letter IATA (e.g.

GET/api/airport/nearT0$0.0010

Airports within a radius of a coordinate, sorted by distance.

[barcode]

POST/api/barcode/generateT0$0.0010

Generate QR / Aztec / Data Matrix / PDF417 codes from structured payloads (url, wifi, vcard, vevent, email, sms, tel, geo, bitcoin, json, text).

[census]

GET/api/census/zipcodeT0$0.0010

US Census ACS 5-year demographics for a ZIP code (ZCTA).

[climate]

GET/api/climate/station-nearT0$0.0010

Find NOAA GHCN-Daily weather stations near a coordinate.

[countdown]

GET/api/countdown/gifT0$0.0060

Animated countdown GIF from the current UTC time to endDate.

[crypto]

GET/api/crypto/address-validateT0$0.0010

Validate a cryptocurrency address with full checksum verification (not just regex).

GET/api/crypto/gas-oracleT0$0.0010

Live EVM gas oracle.

[dns]

GET/api/dns/lookupT0$0.0010

Resolve a hostname over public DNS and return parsed records.

[domain]

GET/api/domain/whoisT0$0.0010

Modern WHOIS via RDAP.

[earth]

GET/api/earth/nowT0$0.00120

Situational awareness for a coordinate: recent earthquakes (USGS) and active wildfires (NIFC) within a configurable radius.

[finance]

GET/api/finance/company-factsT0$0.00480

Curated XBRL financial metrics for a US public company by stock ticker.

GET/api/finance/insider-tradesT0$0.00720

Recent SEC Form 4 insider transactions for a US public company by ticker.

GET/api/finance/sec-filingsT0$0.00360

Recent SEC EDGAR filings for a US publicly-traded company by stock ticker.

GET/api/finance/thirteen-fT0$0.00720

Parsed institutional holdings from a 13F-HR filing.

[geo]

GET/api/geo/ipT0$0.0010

Geolocate an IPv4/IPv6 address to country, region, city, and coordinates.

[geocode]

GET/api/geocode/addressT0$0.0010

Forward geocoding — free-text address or place name → latitude/longitude plus structured address components (houseNumber, road, suburb, city, county, state, postcode, country, cou…

GET/api/geocode/reverseT0$0.0010

Reverse geocoding — latitude/longitude → nearest formatted address plus structured components (houseNumber, road, suburb, city, county, state, postcode, country, countryCode).

[gov]

GET/api/gov/epa-facilitiesT0$0.00240

EPA Facility Registry Service (FRS) — every regulated facility known to the EPA across all programs (RCRA hazardous waste, NPDES water discharge, SDWA drinking water, TRI toxic re…

GET/api/gov/fda-animalvet-eventsT0$0.00240

FDA animal and veterinary adverse event reports, newest first.

GET/api/gov/fda-device-eventsT0$0.00240

FDA medical device adverse event reports (MAUDE), newest first by date received.

GET/api/gov/fda-drug-eventsT0$0.00240

Adverse drug event reports from FDA's Adverse Event Reporting System (FAERS) — 9M+ records since 1968 covering serious adverse events, hospitalizations, deaths, and disabilities.

GET/api/gov/fda-food-recallsT0$0.00240

FDA food recall enforcement reports, newest first by report date.

GET/api/gov/fda-recallsT0$0.00240

FDA drug recall enforcement reports, newest first.

GET/api/gov/federal-register-recentT0$0.00240

Newest Federal Register documents by publication date — chronological feed for compliance change-detection.

GET/api/gov/house-votesT0$0.00240

US House of Representatives roll-call votes, newest first by action date.

GET/api/gov/senate-votesT0$0.00240

US Senate roll-call votes, newest first by vote date.

GET/api/gov/usaspending-awardsT0$0.00240

Search federal awards (contracts, grants, loans, direct payments) from USAspending.gov.

GET/api/gov/usgs-waterT0$0.00240

Real-time water data from USGS NWIS stream / river / groundwater gauges within a bounding box around lat/lon.

[hash]

POST/api/hash/computeT0$0.0010

Compute one or more cryptographic digests (MD5, SHA-1, SHA-2 family, SHA-3 family, BLAKE2) of a string or hex/base64-encoded byte buffer.

[image]

POST/api/image/compressT0$0.00240

Compress an image.

[ipinfo]

POST/api/ipinfo/bulkT0$0.0060

Geolocate up to 100 IPv4/IPv6 addresses in a single call.

[law]

GET/api/law/attorney-lookupT0$0.00360

Find US attorneys by name in CourtListener's RECAP corpus (PACER-derived attorney directory).

GET/api/law/case-searchT0$0.00360

Search US court opinions (SCOTUS, federal circuits, state appellate/supreme — ~9M opinions).

POST/api/law/case-verifyT0$0.0060

Verify US legal case citations in a passage of text.

GET/api/law/federal-registerT0$0.0010

Search the US Federal Register — proposed rules, final rules, notices, and presidential documents.

GET/api/law/judge-lookupT0$0.00360

Find US federal + state appellate judges by name in CourtListener's People DB.

POST/api/law/opinionT0$0.00480

Fetch the full text of a US court opinion by CourtListener opinion ID OR by citation.

POST/api/law/sanctions-checkT0$0.00480

Fuzzy-match a name (person, company, vessel, aircraft) against the US Treasury OFAC Specially Designated Nationals list.

[papers]

GET/api/papers/searchT0$0.00240

Unified scientific literature search across arXiv (preprints), PubMed (biomedical), and Semantic Scholar (cross-field, with citation counts).

[patents]

GET/api/patents/detailT0$0.00180

Full US patent application file-wrapper detail by application number.

GET/api/patents/documentsT0$0.00180

List every document in the file wrapper for a US patent application.

GET/api/patents/searchT0$0.00180

Search US patent applications and grants via the USPTO Open Data Portal.

[phone]

GET/api/phone/normalizeT0$0.0010

Parse, validate and canonicalize a phone number using Google's libphonenumber metadata.

[poi]

GET/api/poi/nearT0$0.0010

Find points of interest near a coordinate.

[quakes]

GET/api/quakes/recentT0$0.0010

Recent earthquakes near a coordinate.

[space]

GET/api/space/weatherT0$0.0010

Current space weather from NOAA SWPC public feeds.

[sunrise]

GET/api/sunrise/computeT0$0.0010

Compute sunrise, sunset, solar noon, and civil/nautical/astronomical twilight times for a coordinate + date.

[tides]

GET/api/tides/nowT0$0.0010

Next high/low tide predictions near a coordinate.

[url]

GET/api/url/cleanT0$0.001080

Fetch any URL and return the article content as clean markdown (with optional plain-text version).

GET/api/url/unfurlT0$0.0010

Fetch any URL and extract structured page metadata: title, description, og:image, canonical, favicon, site name, author, published time, language, and the first ~500 chars of body…

[vehicle]

GET/api/vehicle/complaintsT0$0.00240

NHTSA consumer complaints for a US vehicle by (make, model, modelYear).

GET/api/vehicle/decode-wmiT0$0.00240

Decode a 3-character World Manufacturer Identifier (the first three characters of a VIN) to the assigning manufacturer.

GET/api/vehicle/investigationsT0$0.00240

Chronological feed of NHTSA ODI (Office of Defects Investigation) investigations, newest first.

GET/api/vehicle/manufacturersT0$0.00240

Paginated list of every motor vehicle manufacturer NHTSA tracks via vPIC.

GET/api/vehicle/modelsT0$0.00240

Enumerate every model a manufacturer sold in a given model year via NHTSA's vPIC taxonomy database.

GET/api/vehicle/recallsT0$0.00240

NHTSA recall campaigns for a US vehicle by (make, model, modelYear).

GET/api/vehicle/vin-decodeT0$0.00240

Decode a 17-character VIN to manufacturer-supplied vehicle metadata via NHTSA's vPIC database.

[weather]

GET/api/weather/zipT0$0.00120

Current weather conditions for a US ZIP code (temperature, wind, humidity, conditions).

[wikipedia]

GET/api/wikipedia/summaryT0$0.0010

Fetch a Wikipedia article summary in any of 30 supported languages.

───── PROTOCOL ────────────────────────────────────

1. call any endpoint with no auth.

2. receive 402 with x402 PaymentRequirements.

3. sign for the chain you hold — EIP-3009 (Base) or SPL transfer (Solana).

4. retry with PAYMENT-SIGNATURE header (X-PAYMENT also accepted for v1 clients).

5. get 200 + tx hash on chain.

no signup, no API keys. the only identity 2s recognizes is the wallet that signed the x402 payment. anyone with USDC on Base or Solana can call any endpoint immediately — same dollar price across both rails.

───── SAFETY ──────────────────────────────────────

tier 0 — endpoints backed by free / public-domain sources or our own datasets. ssrf-guarded url fetches, 8s upstream timeout, 512KB body cap on html, redirect-loop guard, private-ip rejection.

tier 2 — endpoints backed by paid LLM / render / OCR providers. per-call max_tokens and payload-size caps. each endpoint declares a daily upstream budget; calls beyond the cap return HTTP 503 SPEND_CAP with Retry-After until the rolling window slides.

───────────────────────────────────────────────────

2s · usdc on base + solana · settled via x402.org