# x402 Agent Hub

> Pay-per-call x402 v2 API hub (Base Mainnet (USDC) — eip155:8453) for trading agents, SDR/research agents, and marketing/coding agents.

- OpenAPI 3.1 Discovery Spec: https://x402-agent-hub.x402-agent-hub.workers.dev/openapi.json
- Remote Streamable HTTP MCP Endpoint: https://x402-agent-hub.x402-agent-hub.workers.dev/mcp
- Static MCP Server Card: https://x402-agent-hub.x402-agent-hub.workers.dev/.well-known/mcp/server-card.json
- Payment Protocol: x402 v2 (exact EVM scheme, USDC on eip155:8453, payTo 0x1721E9841257A34DbDBA407D4DBA3a727a02d072)
- Authentication: None (zero API keys; pay per request via HTTP 402 PAYMENT-REQUIRED / PAYMENT-SIGNATURE headers)

## Paid Endpoints

- `GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/trading/sessions` ($0.005 USD): Live ICT Killzones (Asian, London Open, NY Open, London Close), 60m Silver Bullet windows, CFD rollover spread-widening alerts, and triple-swap flags. Optional query: `?at=<ISO-8601>`.
- `GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/trading/microstructure` ($0.010 USD): Tick-calibrated ECN spreads, round-turn commissions, M1 ATR, spread-to-ATR cost ratios (M1–H1), scalping viability, and live MT5 closed-bar FVGs. Optional query: `?symbol=XAUUSD`.
- `POST https://x402-agent-hub.x402-agent-hub.workers.dev/v1/trading/prop-risk` ($0.010 USD): Prop-firm lot-size calculator accounting for ECN spread/commission friction + daily/max drawdown auto-lock guard. JSON body: `{ "symbol": "XAUUSD", "accountBalanceUsd": 100000, "riskPercent": 0.5, "stopLossPriceDistance": 4.5 }`.
- `POST https://x402-agent-hub.x402-agent-hub.workers.dev/v1/crypto/token-audit` ($0.010 USD): Institutional Onchain Token Rug, Honeypot, Tax & DEX Liquidity Execution Audit across Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche & Solana, plus a live simulated buy -> sell round trip (measured taxes + sellability) on Base, Ethereum, BSC, Arbitrum, Optimism & Polygon. JSON body: `{ "tokenAddress": "0x940181a94A35A4569E4529A3CDfB74e38FD98631", "chain": "base", "intendedOrderUsd": 2500 }`.
- `POST https://x402-agent-hub.x402-agent-hub.workers.dev/v1/web/extract` ($0.005 USD): Convert any public URL to clean, token-efficient LLM Markdown. JSON body: `{ "url": "https://example.com" }`.
- `POST https://x402-agent-hub.x402-agent-hub.workers.dev/v1/web/lead-enrich` ($0.015 USD): Business domain lead enricher with Brand Sanitizer, Phantom Lead Shield (wa.me/linktr.ee/marketplace detector), E.164 WhatsApp/mobile extraction (PSTN landline filter), emails, socials, and CMS/pixel stack. JSON body: `{ "url": "https://example.com" }`.
- `POST https://x402-agent-hub.x402-agent-hub.workers.dev/v1/web/seo-audit` ($0.020 USD): Instant 0–100 Technical SEO & Website Modernization Audit with prioritized fixes. JSON body: `{ "url": "https://example.com" }`.
- `POST https://x402-agent-hub.x402-agent-hub.workers.dev/v1/web/outreach-dossier` ($0.050 USD): All-in-one B2B SDR Outreach Dossier combining Brand Sanitizer, Phantom Lead Shield, E.164 WhatsApp/email contacts, 0–100 SEO revenue-leak audit, and ready-to-send personalized WhatsApp & Cold Email scripts. JSON body: `{ "url": "https://example.com", "agencyOffer": "Next.js conversion redesign & AI WhatsApp booking" }`.
- `POST https://x402-agent-hub.x402-agent-hub.workers.dev/v1/render/card` ($0.025 USD): Deterministic 1200x630 OpenGraph banner, 1080x1350 social KPI slide, or trading signal sparkline card in `json`, `svg`, or `png`. JSON body: `{ "template": "trading_signal", "title": "XAUUSD NY Open", "sparkline": [40, 44, 51, 63, 68] }`.

## Onchain Read API (pay only for successful calls)

- `GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/chain/balance?chain=base&address=0x1721E9841257A34DbDBA407D4DBA3a727a02d072` ($0.002 USD): Native coin balance of any address on Base, Ethereum, Arbitrum, Optimism, Polygon, BSC or Avalanche, with raw wei and formatted units plus the block it was read at. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.
- `GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/chain/token-balance?chain=base&address=0x1721E9841257A34DbDBA407D4DBA3a727a02d072&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` ($0.002 USD): ERC-20 token balance of any address on 7 EVM chains, returned raw and decimal-formatted with the token symbol, so agents never mis-scale USDC (6) vs 18-decimal tokens. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.
- `GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/chain/token-info?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` ($0.002 USD): ERC-20 token metadata on 7 EVM chains: name, symbol, decimals and formatted total supply in one call. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.
- `GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/chain/tx?chain=base&hash=0x4f9955a6481d1386b261c3a9e68bc385df78d40190fe8cef895942283e33d985` ($0.002 USD): Status of any transaction on 7 EVM chains: pending / success / reverted, confirmations, block time, from/to, value and the all-in fee (including the OP-stack L1 data fee on Base and Optimism). Use it to confirm a payment or deployment landed. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.
- `GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/chain/address-info?chain=base&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` ($0.003 USD): Classify any address on 7 EVM chains before interacting with it: EOA, EIP-7702-delegated EOA or contract, code size, nonce, native balance, and proxy detection (EIP-1967 implementation/admin/beacon slots, legacy ZeppelinOS proxies such as USDC, and EIP-1167 minimal proxies). You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.
- `GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/chain/ens?name=vitalik.eth` ($0.002 USD): Resolve an ENS name to an address, or an address to its primary ENS name, via the Ethereum mainnet Universal Resolver (CCIP-read / offchain names supported). Pass exactly one of 'name' or 'address'. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.
- `GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/chain/portfolio?address=0x1721E9841257A34DbDBA407D4DBA3a727a02d072&chains=base%2Cethereum%2Carbitrum` ($0.005 USD): One call returns an address's native coin, USDC and USDT balances on Base, Ethereum, Arbitrum, Optimism, Polygon, BSC and Avalanche (or a 'chains' subset), plus a total stablecoin USD figure, instead of 21 separate reads. Chains whose RPC fails are listed in chainsFailed. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.

## Company Data API (SEC EDGAR) (pay only for successful calls)

- `GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/company/search?q=apple&limit=5` ($0.002 USD): Search ~10,000 SEC-registered US public companies by ticker or name and get the ticker, legal name and CIK to use with the other company tools. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.
- `GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/company/profile?ticker=AAPL` ($0.002 USD): Official SEC profile of a US public company: legal name, tickers, exchanges, SIC industry, state of incorporation, fiscal year end, website, business address, former names, and direct links to its latest annual, quarterly and current reports. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.
- `GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/company/financials?ticker=AAPL&period=annual&limit=3` ($0.005 USD): Reported fundamentals for US-GAAP filers from SEC XBRL data: revenue, operating income, net income, diluted EPS, operating cash flow, capex, free cash flow, total assets/liabilities, equity, cash, margins and YoY revenue growth for the last 1-12 annual or quarterly periods. Q4 and quarterly cash flows are derived from year-to-date filings and flagged. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.
- `GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/company/filings?ticker=AAPL&form=8-K&since=2026-01-01&limit=5` ($0.002 USD): A company's most recent SEC filings, optionally filtered by form type (e.g. 10-K,8-K) and date, with filing/report dates, 8-K item numbers and direct links to the document and filing index. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.
- `GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/company/insider-trades?ticker=AAPL&limit=5` ($0.005 USD): Parsed SEC Form 4 insider filings for a company: insider name and role (director, officer title, 10% owner), transaction code (open-market buy/sell, award, exercise, tax withholding...), shares, price, USD value, holdings after, 10b5-1 plan flag, plus a buy/sell summary. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.

## Entity Enrichment API (Wikidata) (pay only for successful calls)

- `GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/entity/search?q=grab&type=company&limit=3` ($0.002 USD): Search Wikidata for companies, notable people or anything else by name and get IDs, short descriptions and Wikipedia links, so you can pick the right entity before enriching it. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.
- `GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/entity/company?name=Stripe` ($0.003 USD): Enrich any company worldwide (private, startup or listed; not just US) by name, website domain or Wikidata ID: website, founding date, headquarters, countries, industries, current CEO, founders, employee count, revenue, stock listings and tickers, LEI/ISIN, legal form, parent and subsidiaries, official X/LinkedIn/GitHub/Instagram accounts, logo and the Wikipedia summary. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.
- `GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/entity/person?name=Jensen+Huang` ($0.003 USD): Professional profile of a notable person (founders, executives, public figures) from Wikidata and Wikipedia: description, occupations, current employers and positions, education, citizenship, birth year, website and public X/LinkedIn/GitHub accounts. No family, residence or full birth dates are returned. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.