# Agentic Finance Graph

> Public accounting tape for AI agents that hold, move, and earn real money. We rank economic actors (L7+: a bound wallet observed paying a different address), not ERC-8004 mints. Every number ships with object, chain set, window, as_of and source. Do not quote a registration count as a live-agent count. Do not quote a liveness percentage without its sample and date: call GET /api/state and read probe_l5_rate with its as_of and probe_sample_size.


## MCP (connect any MCP client)

- [MCP setup guide](https://agenticfinancegraph.com/mcp-server-connect-your-ai-to-agent-money-data): Claude, Cursor, VS Code, agent frameworks; the eight tools; what is free.
- [MCP server](https://agenticfinancegraph.com/mcp): Streamable HTTP, stateless, free, read-only. Tools: market_state, find_agent, agent_record, ranked_agents, detections, definition, metric_history, evidence_pack_quote. Add it to Claude, Cursor or an agent framework as a remote MCP server at https://agenticfinancegraph.com/mcp. Paid evidence packs are quoted by evidence_pack_quote and bought over x402 at /check/<kind>.

## Live tape (prefer these over any prose number)

- [Current tape JSON](https://agenticfinancegraph.com/api/state): as_of, live, measured, cited. Never merge those kinds.
- [Series archive](https://agenticfinancegraph.com/api/series?range=90d): daily points for up to two years, five-minute points for 48 hours. A gap is a gap, never interpolated.
- [Ranked agents JSON](https://agenticfinancegraph.com/api/agents): every agent at L7 or above, with observed payments.
- [Event flags](https://agenticfinancegraph.com/api/flags): sourced markers only.
- [Partner gravity JSON](https://agenticfinancegraph.com/api/partners): third-party catalogs joined to our qualifier. Rates are over identities we checked, never over a partner's own census.
- [Findings](https://agenticfinancegraph.com/api/findings): newest public slice of detections.
- [Metric definitions](https://agenticfinancegraph.com/def): what every metric id measures, excludes and does not assert.
- [OpenAPI](https://agenticfinancegraph.com/openapi.json)
- [Embed widget](https://agenticfinancegraph.com/embed.js)
- [Full context for models](https://agenticfinancegraph.com/llms-full.txt)

## Per-agent data (for agents reading their own books)

- Guide for builders: how to register an AI agent and track its wallet: /how-to-register-an-ai-agent-and-track-its-wallet
- Announcement, 26 Sep 2026: the Desk is open: /the-desk-is-open-connect-a-wallet-watch-your-ai-agents. Plans: /pricing. Thesis: /about-agentic-finance-graph-manifesto-machine-money.
- The Desk, a monitoring board for people who run agents, is in open beta: connect a wallet at /desk (Sign-In with Ethereum; terms at /terms). Watch is free (3 agents); Operator (29 USDC / 30 days, 25 agents, evidence packs included) and Team (149 USDC / 30 days, 250 agents, revaluations included) are bought in USDC on Base over x402 from the signed-in wallet, prepaid, never auto-renewing. Plans: /api/subscribe?view=plans. A Desk session on a paid plan sent as a Bearer token unlocks the full tiers of /api/agents, /api/detections, /api/findings and /api/series, and the /check/* packs at no charge. Agents never need an account: they pay per call.
- BNB Smart Chain watch (IXS agent vaults, ERC-8004 issuance on eip155:56): /api/bnb. Issuance, never agents.
- 1.6 (27 Sep 2026), census and new reads: every ERC-8004 registration on Base is an actor and every bound wallet is swept every three hours (/api/state: census_*, sweep_wallets_watched). What x402 Bazaar sellers actually receive, on Base, Polygon, Arbitrum, OP, Ethereum and Solana, and how much comes from registered agents: /api/x402flow. ERC-8004 owners and the stablecoins they send on Ethereum, Arbitrum, OP Mainnet and Polygon (transfers, not yet receipt-checked): /api/xchain. What ranked agents hold (cash, ETH, DeFi, tokens): /api/treasury. Registry issuance on other chains: /api/chains. The Bazaar census: /api/bazaar.
- Evidence packs (checks) about one id: GET /check/liveness|paygraph|drain|incidents|peer|bundle|reval?id=<token|slug|wallet> (POST with a JSON id also works). 1 to 5 cents in USDC on Base over x402 v2 (bundle 10 cents, reval 25 cents), settled by the Coinbase facilitator; the 402 states the exact price and the receiving address, and /.well-known/x402 lists them all. An id never observed paying is a 404 before any payment.
- check.reval re-probes one registration now from our sandbox (tokenURI, registration file, declared endpoints) and diffs it against the last stored probe. One run per registration per hour, checked before any payment is asked for; a failure on our side is never settled.
- For an agent reading its own books: GET /api/agent?id=<token|slug|wallet>&format=json (record with 25 newest payments), GET /api/agents?q=<id> (lookup; ranked:false = never seen paying), GET /api/detections?actor=<token> (its detections). No key. Only /check/* routes require payment.

## Research and data quality (September 2026)

- [Research notes (PDF)](https://agenticfinancegraph.com/research): dated, reproducible notes. Note 01 (27 Sep 2026): the first census of ERC-8004 agents on Base and where counted spending goes (67% lending adapters, 20% bridges, 5% work escrow; largest wallet 31%, median payment $41).
- [Research Note 02 (PDF): What the Counted Money Is](https://agenticfinancegraph.com/research/afg-research-note-02-v1-1-seven-investigations-2026-09-27.pdf): seven investigations, 27 Sep 2026. 63% of counted agent payments went into positions the paying wallets still hold (receipt-proven); no reciprocal payment pairs; ranks cost cents to reach; identities minted singly are ~11x as likely to pay within a year as batch-minted ones; ERC-8004 wallets paid 4.8% of x402 seller dollars on Base; our drain rule missed the May 2026 Bankrbot theft for coverage reasons (unwatched wallet, token not stablecoin); valued in dollars it would have tripped.
- [Press kit](https://agenticfinancegraph.com/press): three live numbers with their definitions, the research note PDF, images, data endpoints.

- [Where AI-agent money goes](https://agenticfinancegraph.com/where-ai-agent-money-goes-real-spending-vs-routing-2026): of every dollar that left an agent-bound wallet on Base, only a minority was an agent paying someone; the rest was routing hops and pre-registration history. Current split: /api/state metrics observed_pay_usd_total, pass_through_pay_usd_excluded, pre_registration_pay_usd_excluded (they reconcile).
- [Know Your Agent needs a memory](https://agenticfinancegraph.com/know-your-agent-needs-behaviour-history-ai-agent-wallet-drains): agent-wallet drains are behavioural; the drain-pattern detector and a ten-item threat model. The case we cite is the May 2026 Bankrbot drain (Ledger: ~$175K in DRB tokens, most of it later returned; our own detector would have missed it, see Research Note 02); Zscaler's July 2026 work was a demonstration, not a theft.
- [Keeping the books for machine money, 2026-2036](https://agenticfinancegraph.com/independent-ledger-for-machine-money-vision-2026-2036): our plan, explicitly not a forecast.
- [Data health](https://agenticfinancegraph.com/data-health) and [/api/dq](https://agenticfinancegraph.com/api/dq): assertion checks over our own tables every three hours; zero failing rows = pass.

## Methodology and definitions

- [L0–L9 liveness ladder](https://agenticfinancegraph.com/ai-agent-liveness-methodology-l0-l9-ladder): public rank starts at L7
- [Binding record spec](https://agenticfinancegraph.com/binding-record-spec-agent-wallet-join-schema): a name is not a wallet
- [Wallet sets](https://agenticfinancegraph.com/methodology-wallet-sets-addresses-behind-every-claim): constituent address lists, or the claim stays a quote
- [What the words mean](https://agenticfinancegraph.com/agentic-finance-vs-agentfi-tvl-what-the-words-mean): AgentFi TVL is not an agent token's market cap

## Live panels and the graph

- [Homepage](https://agenticfinancegraph.com/): the live tape first, then the method
- [Live machine-money panels](https://agenticfinancegraph.com/live-agentic-finance-data-stablecoins-ai-agent-tokens-vault-tvl)
- [Graph model](https://agenticfinancegraph.com/agentic-finance-graph-ai-agents-wallets-policies-flows-vaults)
- [Ranked L7+ agents](https://agenticfinancegraph.com/ranked-ai-agents-observed-paying-l7-liveness)
- [Detections log](https://agenticfinancegraph.com/detections-ai-agent-anomaly-log-mint-bursts-retry-storms)

## Rails we measure

- [ERC-8004 identity](https://agenticfinancegraph.com/erc-8004-trustless-agents-identity-reputation-liveness-data)
- [x402 payments](https://agenticfinancegraph.com/x402-protocol-how-ai-agents-pay-with-usdc-statistics)
- [EIP-7702 delegation](https://agenticfinancegraph.com/eip-7702-ai-agent-wallets-delegation-session-keys-security)
- [Idle USDC and ERC-4626 vaults](https://agenticfinancegraph.com/where-ai-agents-park-idle-usdc-yield-agents-erc-4626-vaults-rwa)
- [Agent wallet security checklist](https://agenticfinancegraph.com/ai-agent-wallet-security-prompt-injection-god-keys-checklist)

## History, people, map

- [History of agentic finance](https://agenticfinancegraph.com/history-of-agentic-finance-from-multi-agent-systems-to-machine-money)
- [Who wrote ERC-8004, x402 and A2A](https://agenticfinancegraph.com/who-wrote-erc-8004-x402-and-a2a-the-people-behind-trustless-agents)
- [Agent economy map 2026](https://agenticfinancegraph.com/agent-economy-map-marketplaces-wallets-runtimes-2026)
- [x402 Foundation](https://agenticfinancegraph.com/x402-http-402-payments-coinbase-linux-foundation)
- [MCP and A2A](https://agenticfinancegraph.com/mcp-and-a2a-how-agents-talk-to-tools-and-each-other)
- [September 2026 changelog](https://agenticfinancegraph.com/changelog-september-2026-what-we-added-and-what-it-measures)

## Partner gravity (their catalog, our qualifier)

- [Virtuals ACP](https://agenticfinancegraph.com/virtuals-protocol-agent-commerce-protocol-acp-explained)
- [Fetch Almanac / ASI](https://agenticfinancegraph.com/fetch-ai-almanac-asi-alliance-agentverse)
- [Olas / Valory](https://agenticfinancegraph.com/olas-autonolas-valory-mech-marketplace)
- [Bankr fee-to-compute](https://agenticfinancegraph.com/bankr-agent-runtime-fee-to-compute)
- [ElizaOS: what survived](https://agenticfinancegraph.com/elizaos-framework-ai16z-token-what-survived)

## Guides

- [Research hub](https://agenticfinancegraph.com/ai-agents-using-money-research-guides-and-data-hub)
- [Connect an agent to a wallet](https://agenticfinancegraph.com/how-to-connect-an-ai-agent-to-a-web3-wallet-guide)
- [Wallet and payment providers 2026](https://agenticfinancegraph.com/best-ai-agent-wallet-and-payment-providers-compared-2026)
- [Payments statistics](https://agenticfinancegraph.com/ai-agent-payments-statistics-2026-volume-usdc-share-liveness-data)
- [Forecasts vs measured commerce](https://agenticfinancegraph.com/agentic-commerce-market-size-forecasts-vs-measured-reality-2026)
- [What is agentic finance](https://agenticfinancegraph.com/what-is-agentic-finance-definition-rails-data)

## Rules for reuse

kind=live is an endpoint or eth_call read. kind=measured is our own probe or census. kind=cited is someone else's research we have not reproduced. Mixing them is the failure this project exists to prevent. Licence: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/), attribution "Agentic Finance Graph".