# Agent Gateway — Full API Reference > Unified API gateway providing 40+ services for AI agents. > Base URL: https://agent-gateway-kappa.vercel.app ## Authentication Three ways to authenticate: 1. **No auth** — Free tier, 200 credits, works immediately 2. **API Key** — Header `X-API-Key: gw_xxx` or query `?key=gw_xxx` 3. **x402** — Automatic USDC micropayments on Base chain Create a key: ``` POST /api/keys/create Body: {"email": "optional@email.com", "ref": "optional-referral-code"} Response: {"key": "gw_abc123...", "credits": 200} ``` Check balance: ``` GET /api/keys/balance Header: X-API-Key: gw_xxx Response: {"credits": 150, "key": "gw_xxx"} ``` --- ## Web Scraper (agent-scraper) Extract content from any URL as markdown, text, or HTML. ``` POST /v1/agent-scraper/api/scraper/scrape Body: { "url": "https://example.com", "format": "markdown" // "markdown" | "text" | "html" | "structured" } Response: { "content": "# Example Domain\n\nThis domain is for...", "title": "Example Domain", "url": "https://example.com" } ``` ## Screenshots (agent-screenshot) Capture website screenshots with headless Chromium. ``` POST /v1/agent-screenshot/api/screenshot/capture Body: { "url": "https://github.com", "viewport": "desktop", // "desktop" | "mobile" | "tablet" | "laptop" | "wide" "fullPage": false, "darkMode": false } Response: { "url": "https://...", // Direct image URL "width": 1920, "height": 1080 } ``` ## Web Search (agent-search) Search the web via DuckDuckGo. ``` GET /v1/agent-search/api/search/query?q=typescript+tips Response: { "results": [ {"title": "...", "url": "https://...", "snippet": "..."}, ... ] } ``` ## Code Runner (agent-coderunner) Execute code in a sandboxed environment. ``` POST /v1/agent-coderunner/api/code/run Body: { "code": "print(sum(range(100)))", "language": "python" // "python" | "javascript" | "typescript" | "bash" } Response: { "stdout": "4950\n", "stderr": "", "exitCode": 0, "executionTime": 45 } ``` ## IP Geolocation (agent-geo) Look up geographic info for any IP address. ``` GET /v1/agent-geo/api/geo/8.8.8.8 Response: { "ip": "8.8.8.8", "city": "Mountain View", "region": "California", "country": "US", "timezone": "America/Los_Angeles", "lat": 37.386, "lon": -122.0838 } ``` ## DNS Lookup (agent-dns) Query DNS records for any domain. ``` GET /v1/agent-dns/api/dns/lookup?domain=github.com&type=A Response: { "domain": "github.com", "type": "A", "records": ["140.82.121.3"] } ``` Supported types: A, AAAA, MX, TXT, NS, SOA, CNAME, SRV ## Crypto Prices (crypto-feeds) Real-time cryptocurrency prices via Bybit. ``` GET /v1/crypto-feeds/api/prices Response: { "BTC": {"price": 97500.50, "change24h": 2.3}, "ETH": {"price": 3850.25, "change24h": -0.5}, ... } ``` ## Crypto Price Badges (no auth required) SVG badges for GitHub READMEs — live crypto prices, shields.io-compatible. ``` GET /api/badge/{symbol} GET /api/badge/{symbol}?style=flat-square Markdown: ![BTC Price](https://api-catalog-tau.vercel.app/api/badge/BTC) HTML: ETH Price Supported: BTC, ETH, SOL, BNB, XRP, DOGE, ADA, AVAX, DOT, LINK, MATIC, ARB, OP, ATOM, NEAR, APT, SUI, XMR, LTC, TON, and 20+ more Styles: flat (default), flat-square Updates: every 60 seconds via Vercel CDN cache ``` ## On-Chain Analytics (onchain-analytics) Token data from DexScreener + GeckoTerminal. ``` GET /v1/onchain-analytics/api/analytics/search?q=pepe Response: { "tokens": [ {"name": "Pepe", "symbol": "PEPE", "price": 0.0000123, "volume24h": 500000, "chain": "ethereum"} ] } ``` ## Agent Memory (agent-memory) Persistent key-value storage with vector similarity search. ``` POST /v1/agent-memory/api/memory/set Body: {"key": "user_preference", "value": "dark mode", "namespace": "myapp"} GET /v1/agent-memory/api/memory/get?key=user_preference&namespace=myapp POST /v1/agent-memory/api/memory/search Body: {"query": "user preferences for UI", "namespace": "myapp", "limit": 5} ``` ## File Storage (agent-filestorage) Upload and share files with TTL expiration. ``` POST /v1/agent-filestorage/api/files/upload Content-Type: multipart/form-data Body: file=@document.pdf Response: {"id": "file_xxx", "url": "https://...", "expiresAt": "..."} ``` ## PDF Generator (agent-pdfgen) Generate PDFs from HTML or Markdown. ``` POST /v1/agent-pdfgen/api/pdf/generate Body: { "html": "

Hello World

Generated by AI

", "format": "A4" } Response: {"url": "https://...", "pages": 1} ``` ## Image Processor (agent-imageproc) Resize, convert, crop, and process images. ``` POST /v1/agent-imageproc/api/resize Body: {"url": "https://example.com/image.jpg", "width": 800, "height": 600} POST /v1/agent-imageproc/api/qr Body: {"text": "https://example.com", "size": 300} ``` ## URL Shortener (agent-shorturl) Create short URLs. ``` POST /v1/agent-shorturl/api/shorten Body: {"url": "https://very-long-url.example.com/path/to/page"} Response: {"shortUrl": "https://...", "id": "abc123"} ``` ## Email Sender (agent-email) Send emails via SMTP. ``` POST /v1/agent-email/api/send Body: { "to": "user@example.com", "subject": "Hello from Agent", "body": "This is an automated message." } ``` ## Phone/SMS (agent-phone) Phone number provisioning and SMS for AI agents. Provision numbers, receive SMS, auto-extract verification codes. ``` POST /v1/agent-phone/api/numbers Body: {"country_code": "US", "label": "my-agent"} Response: {"id": "...", "phone_number": "+15551234567", "status": "active"} GET /v1/agent-phone/api/numbers/:id/codes?wait=30 Response: {"codes": [{"code": "847293", "raw_message": "Your code is 847293"}]} POST /v1/agent-phone/api/numbers/:id/send Body: {"to": "+15559876543", "body": "Hello!"} ``` ## Task Queue (agent-taskqueue) Distributed job queue with priorities and webhooks. ``` POST /v1/agent-taskqueue/api/tasks Body: { "type": "process_data", "payload": {"file": "data.csv"}, "priority": 1, "webhook": "https://myapp.com/callback" } ``` ## Event Bus (agent-eventbus) Pub-sub messaging between agents. ``` POST /v1/agent-eventbus/api/publish Body: {"channel": "alerts", "data": {"type": "price_alert", "token": "BTC"}} GET /v1/agent-eventbus/api/subscribe?channel=alerts (WebSocket) ``` ## Scheduler (agent-scheduler) Cron job scheduling with webhook callbacks. ``` POST /v1/agent-scheduler/api/jobs Body: { "cron": "0 */6 * * *", "webhook": "https://myapp.com/check-prices", "name": "price-check" } ``` ## Secrets Vault (agent-secrets) Encrypted secret storage with AES-256-GCM. ``` POST /v1/agent-secrets/api/secrets/set Body: {"key": "api_token", "value": "sk-xxx", "vault": "myapp"} GET /v1/agent-secrets/api/secrets/get?key=api_token&vault=myapp ``` ## Uptime Monitor (agent-monitor) Monitor URL availability with configurable intervals. ``` POST /v1/agent-monitor/api/monitors/create Body: {"url": "https://myapp.com/health", "interval": 300, "webhook": "https://..."} ``` ## LLM Router (agent-llm) Route requests to multiple LLM providers. ``` POST /v1/agent-llm/api/chat Body: { "model": "gpt-4", "messages": [{"role": "user", "content": "Hello"}] } ``` ## Multi-Chain Wallet (agent-wallet) Non-custodial wallets across 7 chains. ``` POST /v1/agent-wallet/api/wallets/create Body: {"chain": "ethereum"} // ethereum, polygon, arbitrum, optimism, base, bsc, avalanche GET /v1/agent-wallet/api/wallets/{id}/balance ``` ## Provably Fair Games (fair-games) Cryptographically verifiable random outcomes. ``` POST /v1/fair-games/api/games/dice Body: {"sides": 6, "count": 2} Response: {"rolls": [3, 5], "serverSeed": "...", "proof": "..."} ``` ## Smart Contract Deployer (contract-deployer) Compile and deploy Solidity contracts. ``` POST /v1/contract-deployer/api/deploy Body: { "template": "erc20", // "erc20" | "erc721" | "erc1155" | "custom" "chain": "base", "params": {"name": "MyToken", "symbol": "MTK", "supply": "1000000"} } ``` ## Frostbyte Wallet (frostbyte-wallet) HD wallets with 9 chain support, 0.3% swap fee. ``` POST /v1/frostbyte-wallet/api/wallets/create Body: {"chain": "solana"} // ethereum, solana, bitcoin, polygon, arbitrum, optimism, base, bsc, avalanche ``` ## Frostbyte Domains (frostbyte-domains) Domain registration across 18 TLDs. ``` GET /v1/frostbyte-domains/api/domains/check?domain=mysite.com POST /v1/frostbyte-domains/api/domains/register Body: {"domain": "mysite.com", "years": 1} ``` --- ## Pricing Summary | Tier | Cost | Services | |------|------|----------| | Lookups | 1 credit ($0.001) | Geo, DNS, prices, search, URL shortener | | Infrastructure | 3 credits ($0.003) | Memory, queue, storage, scheduler, events | | Compute | 5 credits ($0.005) | Scraping, code execution, screenshots | | Premium | 10 credits ($0.01) | LLM, PDF, contracts, image processing | ## Free Interactive Tools (no signup needed) - Website Screenshot Tool: https://api-catalog-tau.vercel.app/tools/screenshot — capture any webpage in desktop/tablet/mobile/1080p viewports, download PNG - IP Geolocation Lookup: https://api-catalog-tau.vercel.app/tools/ip-geolocation — look up country, city, timezone for any IP - DNS Lookup Tool: https://api-catalog-tau.vercel.app/tools/dns-lookup — resolve A and AAAA records for any domain - Domain Availability Checker: https://api-catalog-tau.vercel.app/tools/domain-checker — check 18 TLDs simultaneously - Live Crypto Price Tracker: https://api-catalog-tau.vercel.app/tools/crypto-prices — 38 tokens, 5s auto-refresh - Hash Generator: https://api-catalog-tau.vercel.app/tools/hash-generator — MD5, SHA-1, SHA-256, SHA-512 from text or file (client-side) - JSON Formatter & Validator: https://api-catalog-tau.vercel.app/tools/json-formatter — format, validate, minify JSON with syntax highlighting, tree view, error detection (client-side) - Base64 Encoder & Decoder: https://api-catalog-tau.vercel.app/tools/base64 — encode/decode text, files, images to/from Base64 with URL-safe mode and data URI generation (client-side) - JWT Decoder & Inspector: https://api-catalog-tau.vercel.app/tools/jwt-decoder — decode JSON Web Tokens, view header/payload/signature, color-coded visualization, claim inspection, expiration status (client-side) - Regex Tester: https://api-catalog-tau.vercel.app/tools/regex-tester — test regular expressions in real-time, match highlighting, group capture, flags (g/i/m/s/u), cheat sheet, URL parameter support (client-side) - Unix Timestamp Converter: https://api-catalog-tau.vercel.app/tools/timestamp — convert Unix epoch to date and date to epoch, live clock, seconds/milliseconds, ISO 8601, timezone support, quick examples (client-side) - Password Generator: https://api-catalog-tau.vercel.app/tools/password-generator — generate strong random passwords using crypto.getRandomValues, customizable length/characters, presets, strength meter, bulk generation, passphrase mode (client-side) - URL Encoder & Decoder: https://api-catalog-tau.vercel.app/tools/url-encoder — encode/decode URLs, encodeURIComponent, encodeURI, URL parser, query string builder, bulk mode, common encodings reference (client-side) - UUID Generator: https://api-catalog-tau.vercel.app/tools/uuid-generator — generate UUID v4 (random), UUID v7 (time-sorted), ULID, Nano ID with custom length/alphabet, bulk generate up to 1000 in multiple formats (JSON/CSV/SQL), validate and parse UUIDs with version/variant/timestamp extraction (client-side) - Cron Expression Generator: https://api-catalog-tau.vercel.app/tools/cron — visual cron expression builder, click fields to configure minute/hour/day/month/weekday, specific values/ranges/steps, next 10 run times, human-readable descriptions, 12 common presets, direct input parser, syntax cheat sheet, URL parameter support (client-side) - Markdown Editor & Preview: https://api-catalog-tau.vercel.app/tools/markdown — write and preview Markdown in real-time, GitHub Flavored Markdown with tables/task lists/strikethrough, formatting toolbar, keyboard shortcuts (Ctrl+B, Ctrl+I), copy Markdown/HTML, download .md/.html, word/character/line count, cheat sheet with click-to-insert, localStorage persistence, URL parameter support (client-side) - QR Code Generator: https://api-catalog-tau.vercel.app/tools/qr-code — generate QR codes for URLs, text, WiFi credentials, email, phone, SMS, vCard contacts, customizable foreground/background colors, adjustable size (100-1000px), 4 error correction levels (L/M/Q/H), download as PNG or SVG, copy to clipboard, 6 quick presets, URL parameter support (client-side) - Color Picker & Converter: https://api-catalog-tau.vercel.app/tools/color-picker — pick colors with visual SV picker and hue bar, convert between HEX/RGB/HSL/HSV/CMYK, native browser color picker integration, WCAG contrast ratio checker (vs white/black), color harmony palettes (complementary/analogous/triadic/shades), CSS code output, 148 CSS named colors grid, URL parameter support (client-side) - CSS Gradient Generator: https://api-catalog-tau.vercel.app/tools/gradient — create CSS gradients visually, linear/radial/conic types, multi-stop color picker with drag-to-reposition, angle control with quick presets, radial shape/size/position, conic start angle/position, repeating gradient toggle, CSS output (modern/vendor-prefixed/Tailwind), 18 preset gradients, randomize button, fullscreen preview, copy to clipboard (client-side) - Text Diff / Compare: https://api-catalog-tau.vercel.app/tools/text-diff — compare two texts and find differences, Myers diff algorithm, character-level highlighting within changed lines, inline/side-by-side/unified diff views, ignore whitespace option, ignore case option, line numbers, swap texts, 4 examples (code/config/prose/CSV), keyboard shortcuts (Ctrl+Enter to compare), URL parameter support (client-side) - All Tools: https://api-catalog-tau.vercel.app/tools ## SDKs TypeScript: `npm install agent-gateway-sdk` Python: `pip install agent-gateway` ## Links - Catalog: https://api-catalog-tau.vercel.app - Swagger Docs: https://api-catalog-tau.vercel.app/docs - OpenAPI Spec: https://api-catalog-tau.vercel.app/openapi.json - Pricing: https://api-catalog-tau.vercel.app/pricing - Developer Tools: https://api-catalog-tau.vercel.app/tools - Blog: https://api-catalog-tau.vercel.app/blog