# Clawdia Agent Gateway

> Unified API gateway providing 40+ services for AI agents. Web scraping, screenshots, code execution, crypto data, agent memory, file storage, and more.

## Base URL

https://agent-gateway-kappa.vercel.app

## Authentication

- Free tier: 200 credits, no API key needed
- API key: Pass as `X-API-Key` header or `?key=` query parameter
- x402: Automatic USDC micropayments on Base (no key needed)
- Create key: POST /api/keys/create

## Gateway Endpoints

- GET /api/services — List all available services
- POST /api/keys/create — Create API key (free, 200 credits)
- GET /api/keys/balance — Check credit balance
- GET /api/payments/info — Payment addresses (USDC, XMR)
- GET /api/analytics — Public usage analytics
- GET /health — Health check

## Services (40+)

All services are accessed via /v1/{service-id}/{endpoint}

### Web Tools
- agent-scraper: Web scraping — POST /v1/agent-scraper/api/scraper/scrape {url, format: "markdown"|"text"|"html"}
- agent-screenshot: Screenshots — POST /v1/agent-screenshot/api/screenshot/capture {url, viewport: "desktop"|"mobile"|"tablet"}
- agent-search: Web search — GET /v1/agent-search/api/search/query?q={query}
- agent-dns: DNS lookup — GET /v1/agent-dns/api/dns/lookup?domain={domain}&type={A|MX|TXT}
- agent-geo: IP geolocation — GET /v1/agent-geo/api/geo/{ip}
- agent-shorturl: URL shortener — POST /v1/agent-shorturl/api/shorten {url}

### Code Execution
- agent-coderunner: Run code — POST /v1/agent-coderunner/api/code/run {code, language: "python"|"javascript"|"typescript"|"bash"}

### Crypto & DeFi
- crypto-feeds: Real-time prices — GET /v1/crypto-feeds/api/prices
- crypto-badge: SVG price badge for READMEs (no auth) — GET /api/badge/{symbol} → ![BTC](https://api-catalog-three.vercel.app/api/badge/BTC)
- onchain-analytics: Token analytics — GET /v1/onchain-analytics/api/analytics/search?q={token}
- defi-trading: Hyperliquid DEX — GET /v1/defi-trading/api/prices
- agent-wallet: Multi-chain wallets — POST /v1/agent-wallet/api/wallets/create
- poison-guard: Address poisoning detection — POST /v1/poison-guard/api/analyze {address}
- contract-deployer: Deploy Solidity contracts — POST /v1/contract-deployer/api/deploy
- token-launchpad: Deploy ERC-20 tokens — POST /v1/token-launchpad/api/deploy

### Agent Infrastructure
- agent-memory: Key-value + vector search — POST /v1/agent-memory/api/memory/set {key, value}
- agent-taskqueue: Job queue — POST /v1/agent-taskqueue/api/tasks {type, payload}
- agent-eventbus: Pub-sub messaging — POST /v1/agent-eventbus/api/publish {channel, data}
- agent-scheduler: Cron scheduling — POST /v1/agent-scheduler/api/jobs {cron, webhook}
- agent-filestorage: File storage — POST /v1/agent-filestorage/api/files/upload
- agent-secrets: Encrypted vault — POST /v1/agent-secrets/api/secrets/set {key, value}
- agent-logdrain: Centralized logging — POST /v1/agent-logdrain/api/logs/ingest [{level, message}]
- agent-registry: Agent discovery — POST /v1/agent-registry/api/agents/register {name, url}
- agent-identity: DIDs & signing — POST /v1/agent-identity/api/identities/create

### Media Processing
- agent-pdfgen: HTML/Markdown to PDF — POST /v1/agent-pdfgen/api/pdf/generate {html}
- agent-imageproc: Image processing — POST /v1/agent-imageproc/api/resize {url, width, height}
- agent-paste: Paste bin — POST /v1/agent-paste/api/pastes {content, language}

### Communication
- agent-email: Send email — POST /v1/agent-email/api/send {to, subject, body}
- agent-webhooks: Webhook relay — POST /v1/agent-webhooks/api/hooks/create {url}
- agent-monitor: Uptime monitoring — POST /v1/agent-monitor/api/monitors/create {url, interval}
- webhook-inspector: Test webhooks — POST /v1/webhook-inspector/api/bins/create

### Gaming
- fair-games: Provably fair games — POST /v1/fair-games/api/games/dice {bet, sides}

### AI
- agent-llm: LLM router — POST /v1/agent-llm/api/chat {model, messages}
- defi-mcp: MCP server for DeFi — connects via Model Context Protocol

### Domains & Wallet
- frostbyte-wallet: Multi-chain HD wallets (9 chains) — POST /v1/frostbyte-wallet/api/wallets/create
- frostbyte-domains: Domain registration (18 TLDs) — GET /v1/frostbyte-domains/api/domains/check?domain={domain}

## Free Interactive Tools (no signup needed)

- Website Screenshot Tool (4 viewports): https://api-catalog-three.vercel.app/tools/screenshot
- IP Geolocation Lookup: https://api-catalog-three.vercel.app/tools/ip-geolocation
- DNS Lookup Tool: https://api-catalog-three.vercel.app/tools/dns-lookup
- Domain Availability Checker (18 TLDs): https://api-catalog-three.vercel.app/tools/domain-checker
- Live Crypto Price Tracker (38 tokens): https://api-catalog-three.vercel.app/tools/crypto-prices
- Hash Generator (MD5, SHA-256, SHA-512 — client-side): https://api-catalog-three.vercel.app/tools/hash-generator
- JSON Formatter & Validator (beautify, minify, tree view — client-side): https://api-catalog-three.vercel.app/tools/json-formatter
- Base64 Encoder & Decoder (text, files, images, URL-safe — client-side): https://api-catalog-three.vercel.app/tools/base64
- JWT Decoder & Inspector (decode header, payload, claims, expiration — client-side): https://api-catalog-three.vercel.app/tools/jwt-decoder
- Regex Tester (test regex patterns, match highlighting, group capture, cheat sheet — client-side): https://api-catalog-three.vercel.app/tools/regex-tester
- Unix Timestamp Converter (epoch to date, date to epoch, live clock, seconds/milliseconds, ISO 8601 — client-side): https://api-catalog-three.vercel.app/tools/timestamp
- Password Generator (strong random passwords, crypto-secure, customizable length/characters, bulk generate — client-side): https://api-catalog-three.vercel.app/tools/password-generator
- URL Encoder & Decoder (encode/decode URLs, encodeURIComponent, URL parser, query string builder — client-side): https://api-catalog-three.vercel.app/tools/url-encoder
- UUID Generator (UUID v4, v7, ULID, Nano ID, bulk generate, validate, parse — client-side): https://api-catalog-three.vercel.app/tools/uuid-generator
- Cron Expression Generator (visual cron builder, next run times, presets, cheat sheet — client-side): https://api-catalog-three.vercel.app/tools/cron
- Markdown Editor & Preview (live GFM rendering, tables, task lists, toolbar, export HTML — client-side): https://api-catalog-three.vercel.app/tools/markdown
- QR Code Generator (URLs, text, WiFi, email, phone, vCard, custom colors, PNG/SVG download — client-side): https://api-catalog-three.vercel.app/tools/qr-code
- Color Picker & Converter (HEX, RGB, HSL, HSV, CMYK, palette generator, contrast checker, CSS output — client-side): https://api-catalog-three.vercel.app/tools/color-picker
- CSS Gradient Generator (linear/radial/conic, multi-stop color picker, angle control, vendor prefixes, Tailwind output, 18 presets — client-side): https://api-catalog-three.vercel.app/tools/gradient
- CSS Box Shadow Generator (multiple layers, inset, blur/spread/offset, color with opacity, 16 presets, vendor prefixes — client-side): https://api-catalog-three.vercel.app/tools/box-shadow
- Text Diff / Compare (Myers diff algorithm, character-level highlighting, inline/side-by-side/unified views, ignore whitespace/case — client-side): https://api-catalog-three.vercel.app/tools/text-diff
- All Tools: https://api-catalog-three.vercel.app/tools

## SDKs

- TypeScript: npm install agent-gateway-sdk
- Python: pip install agent-gateway

## Links

- API Catalog: https://api-catalog-three.vercel.app
- Interactive Docs (Swagger): https://api-catalog-three.vercel.app/docs
- OpenAPI Spec: https://api-catalog-three.vercel.app/openapi.json
- Pricing: https://api-catalog-three.vercel.app/pricing
- Playground: https://api-catalog-three.vercel.app/playground
- Developer Tools: https://api-catalog-three.vercel.app/tools
- Blog & Tutorials: https://api-catalog-three.vercel.app/blog

## Pricing

- Free tier: 200 credits (no signup)
- Lookups (geo, DNS, prices): 1 credit ($0.001)
- Infrastructure (memory, queue, storage): 3 credits ($0.003)
- Compute (scraping, code, screenshots): 5 credits ($0.005)
- Premium (LLM, PDF, contracts): 10 credits ($0.01)
- x402 auto-pay: USDC on Base, per-request
- USDC top-up: 500 credits per $1
- XMR accepted