blackwood-state

Use when an agent needs live onchain data (token prices on Base, wallet balances and portfolio value on Ethereum, Base and Solana, ENS names, gas fees, new token pools), ECB exchan…

Pedro Henrique Nogueira

@tgws-metal

Install

$ openclaw skills install @tgws-metal/blackwood-state

Blackwood State pay-per-call APIs

33 HTTP endpoints for agents, most of them first-party: onchain reads straight from the chain, ECB reference rates and Workers AI text tools. No account and no API key. Each endpoint answers HTTP 402 with its price, and the agent pays that one call in USDC on Base over x402 with the wallet it already has.

Cost and approval

  • Every call below is paid, from US$0.003 to US$0.05. The table shows the list price; what counts is the price in the 402 answer, which can be lower during a price test.
  • Ask the user before the first paid call and agree on a budget. Do not pay more than the price in the 402: the commands below cap each payment with --max-amount.
  • A call that fails, or that the endpoint rejects as bad input (HTTP 400), is not charged.
  • This skill is free. It only tells the agent how to call and pay; it holds no key and runs nothing by itself.

How to call

First, optional and free: GET on any endpoint returns its input schema and a real output example.

AgentCash (it creates its own wallet on first use; the wallet needs USDC on Base):

npx -y agentcash@0.17.1 fetch '<endpoint>' -m POST -b '<json body>' --max-amount <price in USD, e.g. 0.005>

Coinbase Agentic Wallet (the user signs in once with npx -y awal@2.12.2 auth login <email>):

npx -y awal@2.12.2 x402 pay '<endpoint>' -X POST -d '<json body>' --max-amount <price in USDC atomic units, 1000000 = US$1>

MCP (the same endpoints as tools, with a free demo credit for the first calls):

claude mcp add blackwood -- npx -y @blackwood-state/mcp@0.2.0

Routes marked "(job)" answer { jobId, pollUrl }: GET pollUrl (free) until done is true and read output. Every paid answer carries next, the paid call that usually continues the task.

Endpoints

Find, read and condense: news, web pages, PDFs and audio into short text

TaskEndpointPriceExample JSON body
News headlines searchPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/news-headlinesUS$0.008{"query":"climate finance","limit":3}
Crypto newsPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/crypto-newsUS$0.005{"hours":24,"limit":5}
Web page to MarkdownPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/web-markdownUS$0.01{"url":"https://httpbin.org/html","maxChars":500}
PDF to text (job)POST https://x402-gateway.blackwoodstate8.workers.dev/v1/pdf-textup to US$0.05{"url":"https://pdfobject.com/pdf/sample.pdf"}
Speech to text (job)POST https://x402-gateway.blackwoodstate8.workers.dev/v1/speech-to-textup to US$0.05{"url":"https://upload.wikimedia.org/wikipedia/commons/b/bb/Neil_Armstrong_small_step.wav"}
Summarize textPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/summarizeUS$0.008GET the route for the schema and an example
Translate textPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/translateUS$0.012{"text":"Pay only for the requests you make.","from":"en","to":"pt"}
Sentiment analysisPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/sentimentUS$0.004{"texts":["The checkout was fast and the support team was great.","The package arrived broken and nobody answered my emails."]}
LLM chat completion (job)POST https://x402-gateway.blackwoodstate8.workers.dev/v1/llm-chatup to US$0.03{"messages":[{"role":"user","content":"In one sentence, what is the x402 payment protocol?"}],"maxTokens":80}
News research briefingPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/news-briefingUS$0.04{"topic":"bitcoin","hours":24}
Company research dossierPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/company-dossierUS$0.03{"domain":"apple.com","ticker":"AAPL","name":"Apple"}

Domain, website and endpoint checks

TaskEndpointPriceExample JSON body
Domain intelligencePOST https://x402-gateway.blackwoodstate8.workers.dev/v1/domain-intelUS$0.02{"domain":"example.com","certificates":false}
Security headersPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/http-headersUS$0.007{"url":"https://example.com"}
x402 endpoint checkPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/x402-checkUS$0.007{"url":"https://x402.org/protected"}
Email validationPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/email-checkUS$0.005{"email":"postmaster@ietf.org"}
Email list checkPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/email-batchUS$0.02{"emails":["postmaster@ietf.org","test@mailinator.com","info@example.com","not-an-email"]}

FX rates, FX history and company financials

TaskEndpointPriceExample JSON body
Currency exchange ratesPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/fx-ratesUS$0.005{"base":"USD","symbols":["EUR","BRL","JPY","GBP"],"amount":100}
Historical exchange ratesPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/fx-historyUS$0.005{"symbols":["USD","BRL"],"days":7}
SEC company financialsPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/sec-factsUS$0.02{"ticker":"AAPL"}

Token prices, wallet balances, ENS names and gas fees on Ethereum, Base and Solana

TaskEndpointPriceExample JSON body
Token price on BasePOST https://x402-gateway.blackwoodstate8.workers.dev/v1/token-priceUS$0.003{"token":"WETH"}
Wallet balances on BasePOST https://x402-gateway.blackwoodstate8.workers.dev/v1/wallet-balancesUS$0.004{"address":"0x5A6c77758820182484EA8DE614FC65423E80749a"}
ENS name lookupPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/ens-lookupUS$0.005{"name":"vitalik.eth"}
Gas price and feesPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/gas-feesUS$0.003{}
Wallet portfolio and historyPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/wallet-portfolioUS$0.005{"address":"0xFf918CFB0690FdEd4224DBDab916F6E6F78882b7","chains":["base"],"historyLimit":2}
Wallet value in USDPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/wallet-valueUS$0.005{"address":"0x87DB3C25d1E8E40f8EF240D48a711B0C355CF8Cf","chains":["base"]}
Altcoin discovery on BasePOST https://x402-gateway.blackwoodstate8.workers.dev/v1/altcoin-discoveryUS$0.005{"hours":24,"limit":3}

Weather, airport delays and time zones

TaskEndpointPriceExample JSON body
Weather forecastPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/weather-forecastUS$0.003{"latitude":59.9139,"longitude":10.7522,"hours":3}
Airport delaysPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/airport-delaysUS$0.007{}
Time zonesPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/timezoneUS$0.003{"time":"2026-11-03T09:00","from":"America/New_York","to":["Europe/London","Asia/Tokyo","America/Sao_Paulo"]}

Images, speech and QR codes

TaskEndpointPriceExample JSON body
Image generation (job)POST https://x402-gateway.blackwoodstate8.workers.dev/v1/image-genUS$0.03{"prompt":"A brass lighthouse on a dark navy sea at dusk, minimalist flat illustration","steps":4}
Text to speechPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/text-to-speechUS$0.023{"text":"Hello from Blackwood State. This audio was generated on demand.","lang":"en"}
QR codePOST https://x402-gateway.blackwoodstate8.workers.dev/v1/qr-codeUS$0.004{"text":"https://x402-gateway.blackwoodstate8.workers.dev","ecc":"M"}

Random numbers and hashing

TaskEndpointPriceExample JSON body
Random numbersPOST https://x402-gateway.blackwoodstate8.workers.dev/v1/randomUS$0.005{"kind":"dice","count":2,"sides":6}

OpenAPI with every schema: https://x402-gateway.blackwoodstate8.workers.dev/openapi.json. Availability over 30 days: https://x402-gateway.blackwoodstate8.workers.dev/status.json.

Top skills in this category

Stock Analysis

@udiedrichsen

Analyze stocks and cryptocurrencies using Yahoo Finance data. Supports portfolio management, watchlists with alerts, dividend analysis, 8-dimension stock scoring, viral trend detection (Hot Scanner), and rumor/early signal detection. Use for stock analysis, portfolio tracking, earnings reactions, crypto monitoring, trending stocks, or finding rumors before they hit mainstream.

25959k

Stock Market Pro

@kys42

Yahoo Finance (yfinance) powered stock analysis skill: quotes, fundamentals, ASCII trends, high-resolution charts (RSI/MACD/BB/VWAP/ATR), plus optional web a...

15532k

Stock Watcher

@robin797860

Manage and monitor a personal stock watchlist with support for adding, removing, listing stocks, and summarizing their recent performance using data from 10jqka.com.cn. Use when the user wants to track specific stocks, get performance summaries, or manage their watchlist.

8837k

A股量化 AkShare

@mbpz

A股量化数据分析工具,基于AkShare库获取A股行情、财务数据、板块信息等。用于回答关于A股股票查询、行情数据、财务分析、选股等问题。

10232k

Intelligent Stocks Screener

@financial-ai-analyst

基于东方财富数据库,支持通过自然语言输入筛选A港美股、基金、债券等多种资产,支持多元指标筛选,含技术面、消息面、基本面及市场情绪等,可用于全球资产速筛、跨市场监控、投资组合构建、策略回测等场景。返回结果包含数据说明及 csv 文件。Natural language screener for investment...

10627k