# Axiom Works AgentReader

> Pay-per-call tools for AI agents. No API keys: x402 (HTTP 402) + USDC on Base (eip155:8453), payTo 0x88b1c747c33A5868A34057D8C57318E5602b3ff6.
> Free truncated samples: https://api.axiomworks.co.uk/samples/{read|company|uk-company|uk-company-lite|convert|uk-charity|uk-charity-full|us-sec|us-sec-full|eu-vat|uk-leads|uk-leads-lite|kyb} (8/IP/day). Or add &preview=1 on paid GETs (same limit).

## When to use which (pick one)

| Need | Endpoint | Price | Why ours |
|---|---|---|---|
| Page → Markdown | https://api.axiomworks.co.uk/read?url= | $0.002 | Readability + metadata JSON, not raw HTML |
| Links only | https://api.axiomworks.co.uk/links?url= | $0.001 | Cheaper than /read |
| Domain health | https://api.axiomworks.co.uk/check?domain= | $0.001 | DNS/TLS/MX/SPF/DMARC + score |
| Website company research | https://api.axiomworks.co.uk/company?domain= | $0.25 | Sourced tech/contacts/DNS/RDAP/news (no LLM fiction) |
| UK CH full DD | https://api.axiomworks.co.uk/uk-company?number=|name= | $0.50 | Official API: officers/PSC/filings/charges/insolvency + red flags |
| UK CH cheap snapshot | https://api.axiomworks.co.uk/uk-company-lite?number=|name= | $0.05 | Status + compliance flags; upsell full pack |
| Website + UK DD bundle | https://api.axiomworks.co.uk/company-full?domain= | $0.65 | $0.10 cheaper than $0.25+$0.50 when UK detected |
| PDF/DOCX → text | https://api.axiomworks.co.uk/convert?url= | $0.03 | Structured markdown/text for RAG |
| EVM wallet balances | https://api.axiomworks.co.uk/wallet?address=&chain=base | $0.003 | Native + 7 stablecoins/majors, 5 chains, one call |
| Tx / payment receipt | https://api.axiomworks.co.uk/tx?hash=&chain=base | $0.003 | Status, confirmations, fee, decoded USDC transfers |
| Token due diligence | https://api.axiomworks.co.uk/token-check?address=&chain=base | $0.01 | Owner/proxy/supply + DEX liquidity + risk flags |
| ENS name ⇄ address | https://api.axiomworks.co.uk/ens?name=vitalik.eth | $0.002 | Forward + text records, or verified reverse |
| Token metadata | https://api.axiomworks.co.uk/token?address=&chain=base | $0.001 | name/symbol/decimals/supply only |
| ERC20 allowance | https://api.axiomworks.co.uk/allowance?token=&owner=&spender= | $0.002 | Unlimited flag + spendable now |
| Contract / address info | https://api.axiomworks.co.uk/contract?address=&chain=base | $0.003 | Proxy impl, clone, 7702, standards, Sourcify name |
| Gas / fees now | https://api.axiomworks.co.uk/gas?chain=base | $0.001 | EIP-1559 suggestion + USD cost estimates |
| Block by number or time | https://api.axiomworks.co.uk/block?timestamp=2026-01-01 | $0.001 | Timestamp → block search |
| NFT owner + metadata | https://api.axiomworks.co.uk/nft?contract=&token_id= | $0.002 | IPFS/Arweave resolved JSON |
| Open research search | https://api.axiomworks.co.uk/search?q= | $0.003 | Wikipedia+OpenAlex+arXiv+Crossref merged/ranked |
| UK house prices | https://api.axiomworks.co.uk/uk-property?postcode= | $0.01 | HM Land Registry Price Paid near postcode |
| UK postcode profile | https://api.axiomworks.co.uk/uk-area?postcode= | $0.005 | ONS geography + police crime + FSA hygiene |
| UK charity snapshot | https://api.axiomworks.co.uk/uk-charity?number= | $0.05 | Charity Commission E&W OGL |
| UK charity full DD | https://api.axiomworks.co.uk/uk-charity-full?number= | $0.25 | Trustees, finances, red flags |
| US SEC EDGAR snapshot | https://api.axiomworks.co.uk/us-sec?ticker=AAPL | $0.05 | CIK resolve, filings summary, fair-use EDGAR |
| US SEC full + facts | https://api.axiomworks.co.uk/us-sec-full?ticker=AAPL | $0.25 | us-gaap highlights + red-flag heuristics |
| EU VAT (VIES) | https://api.axiomworks.co.uk/eu-vat?vat=IE6388047V | $0.01 | Official VIES valid/name/address |
| FX rates (ECB) | https://api.axiomworks.co.uk/fx?base=GBP&symbols=USD | $0.002 | Official ECB rates, history, conversion |
| **Single-fact EVM (5 chains, $0.001–0.003)** | https://api.axiomworks.co.uk/chain/{erc20-balance,balance,block-number,nonce,total-supply,erc20-transfers,events,network-info,receipt,code,call,estimate-gas,nft-owner,erc1155-balance,storage,proxy,chain-id} | $0.001–0.003 | One answer per call, Base/Ethereum/Arbitrum/Optimism/Polygon; see /openapi.json |
| UK new cos (lite) | https://api.axiomworks.co.uk/uk-leads-lite?sic=&location= | $0.25 | New incorporations 1-7d, no directors |
| UK new cos + directors | https://api.axiomworks.co.uk/uk-leads?sic=&location= | $1.00 | + active officer names, mass-formation flags |
| UK leads daily feed | POST https://api.axiomworks.co.uk/uk-leads-feed | $25.00/30d | Daily webhook of new matches |
| UK company watch | POST https://api.axiomworks.co.uk/uk-watch | $5.00/30d | Hourly CH status/officers/filings → webhook |
| Agent KYB pack | https://api.axiomworks.co.uk/kyb?domain=&number=&vat= | $2.00 | Website + UK CH + EU VAT + sanctions + trust flag |
| Sanctions screen | https://api.axiomworks.co.uk/sanctions?name= | $0.05 | OFAC SDN/CONS + UK FCDO + UN SC + EU FSF fuzzy |
| Sanctions batch | POST https://api.axiomworks.co.uk/sanctions-batch | $1.00 | Up to 50 names |
| Hourly change alerts | POST https://api.axiomworks.co.uk/monitor | $1.00/30d | Webhook on change; GET /monitor/:id free |

## Free
- https://api.axiomworks.co.uk/samples/:kind — cached truncated real examples + upsell
- https://api.axiomworks.co.uk/monitor/:id — monitor status · https://api.axiomworks.co.uk/hooks/sink — webhook test sink (POST)
- https://api.axiomworks.co.uk/llms.txt · https://api.axiomworks.co.uk/openapi.json · https://api.axiomworks.co.uk/.well-known/x402 · https://api.axiomworks.co.uk/.well-known/agent.json · https://api.axiomworks.co.uk/mcp · https://api.axiomworks.co.uk/health

## Pay
HTTP 402 + PAYMENT-REQUIRED header (x402 v2). Retry with PAYMENT-SIGNATURE (@x402/fetch, x402-axios, @axiomworks/agentreader). MCP: https://api.axiomworks.co.uk/mcp

## npm
- SDK: npm i @axiomworks/agentreader — createClient({ privateKey }) auto x402 + preview mode
- MCP stdio: npx -y @axiomworks/agentreader-mcp — Claude Desktop / Cursor / Claude Code (set AGENTREADER_PRIVATE_KEY)
- npm: https://www.npmjs.com/package/@axiomworks/agentreader · https://www.npmjs.com/package/@axiomworks/agentreader-mcp

## pip
- LangChain: pip install agentreader-tools — agentreader_tools(private_key=…)
- CrewAI: pip install agentreader-crewai — agentreader_crewai_tools(private_key=…)
- LlamaIndex: pip install llama-index-tools-agentreader — AgentReaderToolSpec(private_key=…).to_tool_list()
- PydanticAI / OpenAI Agents: pip install "agentreader-agents[all]"
- PyPI: https://pypi.org/project/agentreader-tools/ · https://pypi.org/project/agentreader-crewai/ · https://pypi.org/project/llama-index-tools-agentreader/ · https://pypi.org/project/agentreader-agents/
- Dashboard: https://api.axiomworks.co.uk/dashboard · Landing: https://grokbot1233.github.io/agentreader/

## Clients
x402 v2 (PAYMENT-REQUIRED header; @x402/fetch, @x402/axios, Python x402>=2, @x402/mcp) and legacy v1 (402 JSON body + X-PAYMENT; x402-fetch, x402-axios, older AgentKit) both settle. Free ?preview=1 on GET routes.

## Contact
info@axiomworks.co.uk · https://github.com/grokbot1233/agentreader · examples/ in repo