# 0mod API Gateway

> HTTP 402 payment-gated microservices for autonomous AI agents. Edge-computed on
> Cloudflare Workers, settled in USDC on Base (`eip155:8453`) via the x402
> protocol. 10 SKUs across **Data** (primary), **AI**, **Finance**, **Blockchain**
> and **Trading**: web scraping, PII redaction, RDAP domain lookup, DEX pricing,
> image OCR, and CEX-DEX market-microstructure telemetry (spreads, dislocations,
> execution latency, pre-trade impact simulation). No API key.
>
> Service version: `2.0.0`.

**Prices are authoritative and dynamic. Fetch them from
[https://api.0mod.com/api/v1/discovery](https://api.0mod.com/api/v1/discovery) —
never hardcode them.**

## Key links

- [Agent guide (agents.md)](https://api.0mod.com/agents.md): endpoint list, when-to-use guide, pricing rules, and a minimal x402 client using `EVM_PRIVATE_KEY` + `@x402/fetch`.
- [Agent skill (skill.md)](https://api.0mod.com/skill.md): compact skill card for agent frameworks (groups, when-to-use, invocation contract).
- [Discovery](https://api.0mod.com/api/v1/discovery): authoritative per-SKU prices (`atomicUnits` + `readableUsdc`), categories, tags, params, and request/response examples.
- [Payment walkthrough (repo doc)](https://github.com/zeromodern/x402-api/blob/main/docs/payments.md): the real 402 → sign → retry → 200 flow with a captured `PAYMENT-REQUIRED` challenge.
- [Agent manifest](https://api.0mod.com/.well-known/agent.json): agent-json manifest (tools, pricing, schemas, tags).
- [MCP server card](https://api.0mod.com/.well-known/mcp.json): MCP tools + input schemas.
- [A2A agent card](https://api.0mod.com/.well-known/agent-card.json): A2A skills + examples.
- [OpenAPI 3.1](https://api.0mod.com/openapi.json): full request/response schemas.

## When to use

- **Web & content ingestion** — Use when you must read a live web page, or shrink a public image into a token-cheap context window before an LLM call.
  SKUs: `/api/v1/stealth-dom`, `/api/v1/image-ocr-shrink`
- **Privacy, lookup & market utilities** — Use when you must redact PII/PCI before sending text to a model, check a domain, or pull real-time DEX pricing.
  SKUs: `/api/v1/airgap-scrub`, `/api/v1/domain-check`, `/api/v1/dex-price-summary`
- **Crypto market-microstructure telemetry** — Use when you need CEX-DEX spread/basis telemetry, arbitrage dislocation events, fill-latency benchmarks, or a pre-trade impact simulation. Query `/api/v1/crypto/coverage` (free) first to confirm the pair/date window.
  SKUs: `/api/v1/crypto/coverage`, `/api/v1/crypto/spread-candles`, `/api/v1/crypto/dislocations`, `/api/v1/crypto/execution-latency`, `/api/v1/crypto/impact-simulation`

## Endpoints

- [`POST /api/v1/stealth-dom`](https://api.0mod.com/api/v1/stealth-dom): Stealth DOM — headless edge web scraper for AI agents. Fetches any public URL and returns raw HTML or clean Markdown (up to 10,000 chars); SSRF-validated, runs at the Cloudflare edge in ~70ms, no API key. _(Data)_
- [`POST /api/v1/airgap-scrub`](https://api.0mod.com/api/v1/airgap-scrub): Airgap Scrub — pre-LLM PII/PCI redaction for AI agents. Scrubs SSNs, credit cards, phones, addresses, emails and ZIPs before text reaches an LLM or log sink; stateless with zero data retention, optional Workers AI deep redaction, no API key. _(Data, AI)_
- [`POST /api/v1/domain-check`](https://api.0mod.com/api/v1/domain-check): Domain Check — global RDAP/WHOIS lookup for AI agents. Resolves availability, status, registrar, registration/expiry dates and nameservers for .com, .net, .org and global TLDs from the Cloudflare edge; no API key. _(Data)_
- [`POST /api/v1/dex-price-summary`](https://api.0mod.com/api/v1/dex-price-summary): DEX Price Summary — real-time DEX market data for AI agents. Returns token price, 24h volume, liquidity and top pair stats across chains (DexScreener) for trading bots and research agents; no API key. _(Data, Finance, Trading)_
- [`POST /api/v1/image-ocr-shrink`](https://api.0mod.com/api/v1/image-ocr-shrink): Image OCR Shrink — vision OCR-to-markdown for AI agents. Extracts clean text and table markdown from public image URLs with Workers AI Vision Llama 3.2, saving ~95% of the tokens a raw image would consume; no API key. _(Data, AI)_
- [`GET /api/v1/crypto/coverage`](https://api.0mod.com/api/v1/crypto/coverage): Crypto Coverage — free CEX-DEX telemetry discovery for AI agents. Returns supported pairs, earliest/latest timestamps, slice interval and the full telemetry endpoint map; no API key, no payment — use it to plan your query window. _(Data, Finance, Blockchain, Trading)_
- [`GET /api/v1/crypto/spread-candles`](https://api.0mod.com/api/v1/crypto/spread-candles): Spread Candles — cross-venue CEX-DEX spread OHLC for AI agents. Returns 15-minute raw/net spread bps candles, average net spread, book depth and dislocation counts for pairs like AERO/USD, ETH/USD and cbBTC/USD on Base; historical R2 slices, no API key. _(Data, Finance, Blockchain, Trading)_
- [`GET /api/v1/crypto/dislocations`](https://api.0mod.com/api/v1/crypto/dislocations): Dislocations — CEX-DEX arbitrage events for AI agents. Returns synchronized cross-venue dislocation events (Coinbase vs Aerodrome Base DEX) with buy/sell venue, prices, raw/net bps, estimated profit and liquidity depth; real-time-sliced, no API key. _(Data, Finance, Blockchain, Trading)_
- [`GET /api/v1/crypto/execution-latency`](https://api.0mod.com/api/v1/crypto/execution-latency): Execution Latency — cross-venue fill-speed benchmarks for AI agents. Returns p50/p90/p99/min/max latencies, fill rate and per-venue broadcast timings for Coinbase REST vs Aerodrome DEX; empirical execution-quality telemetry for routing decisions, no API key. _(Data, Finance, Trading)_
- [`POST /api/v1/crypto/impact-simulation`](https://api.0mod.com/api/v1/crypto/impact-simulation): Impact Simulation — pre-trade slippage simulator for AI agents. Runs a read-only PAPER order against the LIVE L2 book and returns expected VWAP fill price, slippage in bps, fillable size and fill probability; no order is placed, no custody touched, no API key. _(Data, Finance, Trading)_

## Optional

- [Health](https://api.0mod.com/health): ungated status probe.
- [Crypto coverage](https://api.0mod.com/api/v1/crypto/coverage): free crypto telemetry coverage + date windows.