# Blackwood State

> Pay-per-call APIs for AI agents, paid in USDC over x402 (HTTP 402). No account and no API key: the
> agent pays each call by signing an authorization. Also over MCP (Streamable HTTP) at /mcp.

Network: eip155:8453. OpenAPI: https://x402-gateway.blackwoodstate8.workers.dev/openapi.json. MCP: https://x402-gateway.blackwoodstate8.workers.dev/mcp. Contact: blackwoodstate8@gmail.com.

## Services

- [Web page to Markdown](https://x402-gateway.blackwoodstate8.workers.dev/services/web-markdown): POST https://x402-gateway.blackwoodstate8.workers.dev/v1/web-markdown. Returns JSON with the clean Markdown of a public web page plus its title, description, language, canonical URL and links. Use when you need to scrape a web page, extract content from a url or read an article as markdown for an LLM. Do not use when the page needs JavaScript to render, sits behind a login or paywall, or is not HTML (use a PDF reader for PDFs). Price: 0.01 USDC per call. Typical response time: 2500 ms (p95). MCP: `web-markdown_v1`.
- [SEC company financials](https://x402-gateway.blackwoodstate8.workers.dev/services/sec-facts): POST https://x402-gateway.blackwoodstate8.workers.dev/v1/sec-facts. Returns JSON with a US-listed company's annual revenue, net and operating income, diluted EPS, operating cash flow and year-end balance sheet from SEC filings. Use when you need sec filings company financials, earnings or fundamentals for a stock ticker for the last two fiscal years. Do not use when you need quarterly numbers, real-time prices, non-US companies or filings older than two years. Price: 0.02 USDC per call. Typical response time: 300 ms (p95). MCP: `sec-facts_v1`.
- [PDF to text](https://x402-gateway.blackwoodstate8.workers.dev/services/pdf-text): POST https://x402-gateway.blackwoodstate8.workers.dev/v1/pdf-text. Returns JSON with the text of each page of a PDF (first 20 pages) plus title, author and producer metadata. Use when you need to extract text from a pdf for document parsing, search or an LLM and can poll an async job. Do not use when the PDF is scanned (no OCR), password protected or over 15 MB. Price: 0.01 USDC per page, up to 0.2 USDC per call (clients without upto pay the cap). Asynchronous: the paid call returns a jobId and a free pollUrl; typical job time: 10000 ms (p95). MCP: `pdf-text_v1`.
- [Domain intelligence](https://x402-gateway.blackwoodstate8.workers.dev/services/domain-intel): POST https://x402-gateway.blackwoodstate8.workers.dev/v1/domain-intel. Returns JSON with a domain's registration (RDAP: registrar, dates, status, DNSSEC), DNS records, SPF and DMARC, and recent TLS certificates. Use when you need a whois or domain lookup, dns records, email security checks or certificate transparency data for osint or due diligence. Do not use when you need historical whois, registrant personal data (redacted by registries) or a port and vulnerability scan. Price: 0.02 USDC per call. Typical response time: 4000 ms (p95). MCP: `domain-intel_v1`.
- [Weather forecast](https://x402-gateway.blackwoodstate8.workers.dev/services/weather-forecast): POST https://x402-gateway.blackwoodstate8.workers.dev/v1/weather-forecast. Returns JSON with the hourly weather forecast for a latitude and longitude: temperature, precipitation, wind, humidity, cloud cover and a weather symbol, from MET Norway. Use when you need a weather forecast, temperature or precipitation for the next hours or days at a place given by coordinates. Do not use when you need historical weather, severe weather alerts or only have a place name (geocode it first). Price: 0.003 USDC per call. Typical response time: 1500 ms (p95). MCP: `weather-forecast_v1`.
- [Email address check](https://x402-gateway.blackwoodstate8.workers.dev/services/email-check): POST https://x402-gateway.blackwoodstate8.workers.dev/v1/email-check. Returns JSON with an email address check: syntax, domain and MX records, disposable, free and role account flags, SPF and DMARC, and a verdict on whether the domain can receive mail. Use when you need email validation or to verify email addresses (domain, MX records) before sending, signup or lead scoring. Do not use when you need to confirm the mailbox itself exists (no SMTP probe is done) or to send email. Price: 0.005 USDC per call. Typical response time: 800 ms (p95). MCP: `email-check_v1`.
- [LLM chat completion](https://x402-gateway.blackwoodstate8.workers.dev/services/llm-chat): POST https://x402-gateway.blackwoodstate8.workers.dev/v1/llm-chat. Returns JSON with a chat completion from IBM Granite 4.0 Micro on Workers AI, with token usage. Use when you need an llm chat completion for summaries, extraction or classification and can poll an async job. Do not use when you need a frontier model, tool calling or streaming. Price: 0.002 USDC per thousand tokens, up to 0.03 USDC per call (clients without upto pay the cap). Asynchronous: the paid call returns a jobId and a free pollUrl; typical job time: 8000 ms (p95). MCP: `llm-chat_v1`.
- [Speech to text](https://x402-gateway.blackwoodstate8.workers.dev/services/speech-to-text): POST https://x402-gateway.blackwoodstate8.workers.dev/v1/speech-to-text. Returns JSON with a Whisper transcription of an audio file: text, timed segments and language, or an English translation. Use when you need speech to text transcription or translation of audio at a public URL. Do not use when the audio is over 10 MB or you need speaker labels. Price: 0.008 USDC per megabyte, up to 0.08 USDC per call (clients without upto pay the cap). Asynchronous: the paid call returns a jobId and a free pollUrl; typical job time: 20000 ms (p95). MCP: `speech-to-text_v1`.
- [Text to image](https://x402-gateway.blackwoodstate8.workers.dev/services/image-gen): POST https://x402-gateway.blackwoodstate8.workers.dev/v1/image-gen. Returns JSON with a 1024x1024 JPEG generated from a text prompt by FLUX.1 schnell on Workers AI, as base64. Use when you need image generation or text to image from a prompt for illustrations or mockups and can poll an async job. Do not use when you need image edits, a specific size, photos of real people or more than one image per call. Price: 0.03 USDC per call. Asynchronous: the paid call returns a jobId and a free pollUrl; typical job time: 10000 ms (p95). MCP: `image-gen_v1`.
- [Token price on Base](https://x402-gateway.blackwoodstate8.workers.dev/services/token-price): POST https://x402-gateway.blackwoodstate8.workers.dev/v1/token-price. Returns JSON with the USD price of a token on Base computed on-chain from its deepest Uniswap v3 pool against USDC or WETH, with pool, fee tier and depth. Use when you need a crypto token price or market data for a Base token, quoted from on-chain liquidity. Do not use when the token only trades off Base or on other DEXs (Aerodrome is not read), or you need history or OHLC. Price: 0.003 USDC per call. Typical response time: 1200 ms (p95). MCP: `token-price_v1`.
- [Wallet balances on Base](https://x402-gateway.blackwoodstate8.workers.dev/services/wallet-balances): POST https://x402-gateway.blackwoodstate8.workers.dev/v1/wallet-balances. Returns JSON with the ETH and ERC20 token balances of a wallet on Base, read on-chain in one block: 21 major tokens plus any you list. Use when you need the ERC20 token balance or wallet balance of an address on Base for onchain data checks. Do not use when you need Ethereum mainnet or other chains, NFTs, transaction history or USD values. Price: 0.004 USDC per call. Typical response time: 1200 ms (p95). MCP: `wallet-balances_v1`.
- [News headlines search](https://x402-gateway.blackwoodstate8.workers.dev/services/news-headlines): POST https://x402-gateway.blackwoodstate8.workers.dev/v1/news-headlines. Returns JSON with recent news articles matching keywords: headline, URL, source, publish time, authors, tone, image and the people and organizations named, from GDELT. Use when you need news articles or headlines from the last 72 hours about a topic, company or person. Do not use when you need full article text, paywalled sources, non-English coverage or news older than 72 hours. Price: 0.008 USDC per call. Typical response time: 600 ms (p95). MCP: `news-headlines_v1`.