# 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|links|check|company|company-full|uk-company|uk-company-lite|convert|uk-charity|uk-charity-full|us-sec|us-sec-full|eu-vat|lei|lei-full|read-batch|uk-leads|uk-leads-lite|kyb|uk-dd|uk-watch|email-check|domain|dns|redirects|meta|headers|au-company|ca-company|fr-company|no-company|dk-company|fi-company|ch-company|pl-company|cz-company|be-company|sk-company|ie-company|ee-company|lv-company|sg-company|us-entity|registry-batch|uk-leads-feed|uk-officer|uk-property|uk-area|sanctions|sanctions-batch} (8/IP/day). Or add &preview=1 on paid GETs (same limit).

## Buy with confidence (free, no quota)
Buyer sheet per endpoint = exact price in USDC + atomic units (6 decimals), network (Base mainnet, eip155:8453 / v1 "base"), asset, payTo, example call, free preview, inputs, and the expected PAID response shape: https://api.axiomworks.co.uk/buy (index), e.g. https://api.axiomworks.co.uk/buy/uk-company ($0.50 = 500000 atomic), https://api.axiomworks.co.uk/buy/kyb ($2.50 = 2500000), https://api.axiomworks.co.uk/buy/uk-dd ($1.00 = 1000000).
You are only charged on HTTP 2xx: 4xx/5xx responses are never settled. Every 402 body also carries a "pricing" block with the same fields.

## Big hitters (start here)

| Need | Endpoint | Price |
|---|---|---|
| One-shot agent KYB pack (UK/AU/CA/FR/NO/DK/FI/CH/PL/CZ/BE/SK/IE/EE/LV/SG + US-state NY/CO/CT/OR/TX/VA registry + VAT + website + sanctions + LEI) | https://api.axiomworks.co.uk/kyb?number=00445790 | $2.50 |
| UK due-diligence job (full Companies House pack + sanctions on entity and officers) | https://api.axiomworks.co.uk/uk-dd?number=00445790 | $1.00 |
| UK company watch (hourly status/officers/filings/PSC/charges → webhook) | POST https://api.axiomworks.co.uk/uk-watch | $5.00/30d |
| UK leads search by SIC/area | https://api.axiomworks.co.uk/uk-leads?sic=62012 | $1.00 |
| UK leads daily webhook feed | POST https://api.axiomworks.co.uk/uk-leads-feed | $25.00/30d |
| UK company full report | https://api.axiomworks.co.uk/uk-company?number=00445790 | $0.50 |
| Company research from a domain | https://api.axiomworks.co.uk/company?domain=stripe.com | $0.25 |
| Company research + multi-registry pack (UK/FR/NO/DK/FI/CH/PL/CZ/BE/SK/IE/EE/LV/SG/US/AU/CA/charity when signals match) | https://api.axiomworks.co.uk/company-full?domain=tesco.com | $0.65 |
| Sanctions batch (OFAC/UK/UN/EU) | POST https://api.axiomworks.co.uk/sanctions-batch | $1.00 |
| UK charity full (trustees + 5y financials + red flags) | https://api.axiomworks.co.uk/uk-charity-full?number=1089464 | $0.25 |
| French company (SIREN/SIRET/name → dirigeants + siège + NAF) | https://api.axiomworks.co.uk/fr-company?siren=443061841 | $0.25 |
| Norwegian company (orgnr/name → Brreg status + NACE + address) | https://api.axiomworks.co.uk/no-company?orgnr=923609016 | $0.25 |
| Danish company (CVR/name → status + industry + directors/owners) | https://api.axiomworks.co.uk/dk-company?cvr=24256790 | $0.25 |
| Finnish company (Y-tunnus/name → status + form + business line) | https://api.axiomworks.co.uk/fi-company?businessId=0112038-9 | $0.25 |
| Swiss company (UID/name → status + form + seat + SHAB) | https://api.axiomworks.co.uk/ch-company?uid=CHE-105.909.036 | $0.25 |
| Polish company (KRS/NIP → status + form + seat + PKD + representation) | https://api.axiomworks.co.uk/pl-company?krs=0000001538 | $0.25 |
| Czech company (IČO/name → status + form + seat + NACE) | https://api.axiomworks.co.uk/cz-company?ico=27082440 | $0.25 |
| Belgian company (enterprise number/name → status + form + seat + NACE) | https://api.axiomworks.co.uk/be-company?enterprise_number=0202239951 | $0.25 |
| Slovak company (IČO/name → status + form + seat + RPO) | https://api.axiomworks.co.uk/sk-company?ico=31322832 | $0.25 |
| Irish company (CRO number/name → status + type + address) | https://api.axiomworks.co.uk/ie-company?number=104547 | $0.25 |
| Estonian company (registry code/name → status + address) | https://api.axiomworks.co.uk/ee-company?registry_code=10060701 | $0.25 |
| Latvian company (registration number/name → status + form + address) | https://api.axiomworks.co.uk/lv-company?registration_number=40003229495 | $0.25 |
| Singapore company (ACRA UEN/name → status + type + address) | https://api.axiomworks.co.uk/sg-company?uen=196800306E | $0.25 |
| US state business entity (NY/CO/CT/OR/TX/VA SOS: status, type, formed, agent) | https://api.axiomworks.co.uk/us-entity?name=Etsy%20Inc | $0.25 |
| UK+AU+CA+FR+NO+DK+FI+CH+PL+CZ+BE+SK+IE+EE+LV+SG+US-state registry batch (up to 25; US as us=STATE:ID, NY/CO/CT/OR/TX/VA) | https://api.axiomworks.co.uk/registry-batch?uk=00445790&au=004028077&ca=8660115&fr=443061841&no=923609016&dk=24256790&fi=0112038-9&ch=CHE-105.909.036&pl=0000001538&cz=27082440&be=0202239951&sk=31322832&ie=104547&ee=10060701&lv=40003229495&sg=196800306E&us=NY:3368051,OR:8739914 | $0.30 |
| UK officer search + appointments | https://api.axiomworks.co.uk/uk-officer?name=Ken+Olisa | $0.15 |

Supporting real-data checks: /uk-company-lite, /uk-charity, /sanctions, /au-company, /ca-company, /us-sec, /lei-full, /eu-vat.

## 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 |
| Batch page → Markdown | https://api.axiomworks.co.uk/read-batch?urls= | $0.015 | Up to 8 URLs (~$0.0019/url) |
| 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 |
| Email check | https://api.axiomworks.co.uk/email-check?email=info@stripe.com | $0.002 | Syntax + MX/A + disposable/free/role flags (free: &preview=1) |
| Domain registration (RDAP) | https://api.axiomworks.co.uk/domain?domain=stripe.com | $0.002 | Registrar, registered, expires, age_days, status (free: &preview=1) |
| DNS resolve | https://api.axiomworks.co.uk/dns?name=example.com | $0.001 | A/AAAA/MX/TXT/NS/CNAME via Cloudflare DoH (free: &preview=1; optional type=) |
| Redirects unwrap | https://api.axiomworks.co.uk/redirects?url= | $0.001 | Follow Location hops → final_url + chain (SSRF-safe; free: &preview=1) |
| Page metadata | https://api.axiomworks.co.uk/meta?url= | $0.001 | Title/description/canonical/OG/Twitter/favicons/JSON-LD types (free: &preview=1) |
| HTTP security headers | https://api.axiomworks.co.uk/headers?url= | $0.001 | HSTS/CSP/XFO/XCTO/… + score (SSRF-safe; free: &preview=1) |
| 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 officer search | https://api.axiomworks.co.uk/uk-officer?name= | $0.15 | Reverse officer name → appointments + high-appt/mass-formation flags |
| UK CH cheap snapshot | https://api.axiomworks.co.uk/uk-company-lite?number=|name= | $0.05 | Status + compliance flags; upsell full pack |
| Website + multi-registry DD bundle | https://api.axiomworks.co.uk/company-full?domain= | $0.65 | Auto-attaches UK/FR/NO/DK/FI/CH/PL/CZ/BE/SK/IE/EE/LV/SG/US(NY/CO/CT/OR/TX/VA)/AU/CA/charity when TLD/page signals match |
| 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 |
| GLEIF LEI | https://api.axiomworks.co.uk/lei?lei=HWUPKR0MPOU8FGXBT394 | $0.005 | LEI + parents.direct/ultimate + BIC (CC0) |
| GLEIF LEI search | https://api.axiomworks.co.uk/lei-full?name=Apple%20Inc. | $0.05 | Up to 10 name matches each with parents |
| Batch web read | https://api.axiomworks.co.uk/read-batch?urls=https://example.com,https://example.org | $0.015 | Up to 8 URLs Markdown (~$0.0019/url) |
| 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,live-balance,block-number,nonce,total-supply,erc20-transfers,events,network-info,receipt,code,call,estimate-gas,nft-owner,nft-metadata,erc721-tokens,erc1155-balance,storage,proxy,chain-id,pending} | $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/PSC/charges → webhook |
| UK DD job | https://api.axiomworks.co.uk/uk-dd?number=00445790 (optional name=/domain=) | $1.00 | Full CH pack + sanctions (entity+officers) + optional RDAP/website → trust flag. Free preview: https://api.axiomworks.co.uk/uk-dd?number=00445790&preview=1 |
| Agent KYB pack | https://api.axiomworks.co.uk/kyb?number=00445790 (or acn=/ca_number=/siren=/orgnr=/cvr=/ytunnus=/uid=/krs=/nip=/ico=/cz=/enterprise_number=/be=/sk=/ie=/ee=/lv=/sg=/us_state=+us_id=/us_name=/vat=/domain=; e.g. https://api.axiomworks.co.uk/kyb?us_state=CO&us_id=20211537536 or https://api.axiomworks.co.uk/kyb?sk=31322832) | $2.50 | UK/AU/CA/FR/NO/DK/FI/CH/PL/CZ/BE/SK/IE/EE/LV/SG + US-state (NY/CO/CT/OR/TX/VA SOS) + VAT + website + sanctions + director appointments + trust flag. Free preview: https://api.axiomworks.co.uk/kyb?number=00445790&preview=1 (lite UK + entity sanctions; pay for full pack) |
| French company | https://api.axiomworks.co.uk/fr-company?siren=443061841 (or siret=/name=) | $0.25 | Official Recherche d'entreprises: name, status, NAF, siège, dirigeants, finances. Free preview: https://api.axiomworks.co.uk/fr-company?siren=443061841&preview=1 |
| Norwegian company | https://api.axiomworks.co.uk/no-company?orgnr=923609016 (or name=) | $0.25 | Brønnøysundregistrene Enhetsregisteret: name, status/konkurs, orgform, NACE, address, ansatte. Free preview: https://api.axiomworks.co.uk/no-company?orgnr=923609016&preview=1 |
| Danish company | https://api.axiomworks.co.uk/dk-company?cvr=24256790 (or name=) | $0.25 | CVR via apicvr.dk / Erhvervsstyrelsen: name, status, type, address, industry, employees, direktion/ejere. Free preview: https://api.axiomworks.co.uk/dk-company?cvr=24256790&preview=1 |
| 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 |
| AU company | GET https://api.axiomworks.co.uk/au-company?acn=009661901 | $0.02 | ASIC register, ~4M cos (free: &preview=1) |
| CA company | GET https://api.axiomworks.co.uk/ca-company?number=8660115 | $0.02 | Corporations Canada, ~697k federal corps (free: &preview=1) |
| UK+AU+CA+FR+NO+DK+FI+CH+PL+CZ+BE+SK+IE+EE+LV+SG+US-state batch | GET https://api.axiomworks.co.uk/registry-batch?uk=00445790&au=009661901&ca=8660115&fr=443061841&no=923609016&dk=24256790&fi=0112038-9&ch=CHE-105.909.036&pl=0000001538&cz=27082440&be=0202239951&sk=31322832&ie=104547&ee=10060701&lv=40003229495&sg=196800306E&us=NY:3368051,OR:8739914 | $0.30 | Up to 25 company IDs (UK max 10; US as STATE:ID — NY/CO/CT/OR/TX/VA); sample https://api.axiomworks.co.uk/samples/registry-batch |
| 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.

Explorer-style path aliases (same price + x402 challenge as the canonical route): https://api.axiomworks.co.uk/tx/{hash} (= /tx), https://api.axiomworks.co.uk/ens/{name} (= /ens), https://api.axiomworks.co.uk/contract/{address} (= /contract), https://api.axiomworks.co.uk/wallet/{address} (= /wallet), https://api.axiomworks.co.uk/address/{address} (= /wallet), https://api.axiomworks.co.uk/token/{address} (= /token), https://api.axiomworks.co.uk/token-check/{address} (= /token-check), https://api.axiomworks.co.uk/block/{number} (= /block), https://api.axiomworks.co.uk/nft/{contract}/{token_id} (= /nft), https://api.axiomworks.co.uk/gas/{chain} (= /gas), https://api.axiomworks.co.uk/check/{domain} (= /check), https://api.axiomworks.co.uk/domain/{domain} (= /domain), https://api.axiomworks.co.uk/dns/{name} (= /dns), https://api.axiomworks.co.uk/email-check/{email} (= /email-check), https://api.axiomworks.co.uk/meta/{url} (= /meta), https://api.axiomworks.co.uk/uk-company/{number} (= /uk-company), https://api.axiomworks.co.uk/uk-dd/{number} (= /uk-dd), https://api.axiomworks.co.uk/uk-charity/{number} (= /uk-charity), https://api.axiomworks.co.uk/us-sec/{ticker} (= /us-sec), https://api.axiomworks.co.uk/eu-vat/{vat} (= /eu-vat), https://api.axiomworks.co.uk/lei/{lei} (= /lei), https://api.axiomworks.co.uk/au-company/{acn} (= /au-company), https://api.axiomworks.co.uk/ca-company/{number} (= /ca-company), https://api.axiomworks.co.uk/fr-company/{siren} (= /fr-company), https://api.axiomworks.co.uk/no-company/{orgnr} (= /no-company), https://api.axiomworks.co.uk/dk-company/{cvr} (= /dk-company), https://api.axiomworks.co.uk/fi-company/{businessId} (= /fi-company), https://api.axiomworks.co.uk/ch-company/{uid} (= /ch-company), https://api.axiomworks.co.uk/pl-company/{krs} (= /pl-company), https://api.axiomworks.co.uk/cz-company/{ico} (= /cz-company), https://api.axiomworks.co.uk/be-company/{enterprise_number} (= /be-company), https://api.axiomworks.co.uk/sk-company/{ico} (= /sk-company), https://api.axiomworks.co.uk/ie-company/{number} (= /ie-company), https://api.axiomworks.co.uk/ee-company/{registry_code} (= /ee-company), https://api.axiomworks.co.uk/lv-company/{registration_number} (= /lv-company), https://api.axiomworks.co.uk/sg-company/{uen} (= /sg-company), https://api.axiomworks.co.uk/us-entity/{state}/{id} (= /us-entity). Add ?chain=base|ethereum|... as needed.

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