{ "protocolVersion": "0.3.0", "name": "Agentic Finance Graph", "description": "Public accounting tape for AI agents that hold, move and earn real money: Base in full, plus ERC-8004 registrations and owner payments on BNB Smart Chain, Ethereum, Arbitrum, OP Mainnet, Polygon and Solana. Read-only data service. It answers A2A message/send at https://agenticfinancegraph.com/api/a2a (JSON-RPC, protocol 0.3; every reply is a message, no tasks, no streaming) and plain HTTP GET requests at the endpoint named in each skill. Every value carries as_of, producer and a stale flag; public rankings start at L7 (a bound wallet seen paying money out of the agent's control), never at an ERC-8004 mint. Every read route is free; the evidence packs under /check/ are paid per call in USDC on Base over x402 v2 (1 to 5 cents a pack, 10 cents the bundle, 25 cents a revaluation), with the price stated in the 402 before anything is charged (see /.well-known/x402). ERC-8004 agent #95875 on Base. MCP server: https://agenticfinancegraph.com/mcp (read-only tools, free). Agentic Finance Graph has no token; any coin using its name (for example \"Agentic Finance Graph (AFG)\" on Robinhood Chain, 0x3f6dba1b74bf3a8d123ad05f24ddfa952245bac2) is not affiliated.", "url": "https://agenticfinancegraph.com/api/a2a", "preferredTransport": "JSONRPC", "version": "0.13.1", "provider": { "organization": "Agentic Finance Graph", "url": "https://agenticfinancegraph.com/" }, "documentationUrl": "https://agenticfinancegraph.com/llms-full.txt", "iconUrl": "https://agenticfinancegraph.com/assets/icon-400.png", "capabilities": { "streaming": false, "pushNotifications": false, "stateTransitionHistory": false }, "defaultInputModes": [ "text/plain", "application/json" ], "defaultOutputModes": [ "application/json", "text/plain" ], "skills": [ { "id": "tape", "name": "Current tape", "description": "GET https://agenticfinancegraph.com/api/state — every live, measured, context and cited value with its as_of. Read probe_l5_rate for endpoint liveness and actors_l7_plus for agents observed paying.", "tags": [ "ai-agents", "stablecoins", "usdc", "erc-8004", "x402", "eip-7702", "liveness" ], "examples": [ "How many AI agents have been observed paying somebody?", "What share of ERC-8004 registrations answer their declared endpoint?" ] }, { "id": "series", "name": "Series archive", "description": "GET https://agenticfinancegraph.com/api/series?range=90d — history of the same metrics. Gaps are reported as gaps.", "tags": [ "time-series", "history" ] }, { "id": "ranked_agents", "name": "Ranked agents", "description": "GET https://agenticfinancegraph.com/api/agents — the top 25 agents at L7 or above free (the full list with a Desk plan), with observed payments and counterparties.", "tags": [ "ranking", "l7", "payments" ] }, { "id": "partners", "name": "Partner catalogs", "description": "GET https://agenticfinancegraph.com/api/partners — third-party agent catalogs (Virtuals, Fetch, Bankr) run through our qualifier; rates are over identities we checked, never over the partner's own census.", "tags": [ "virtuals", "fetch", "bankr", "partners" ] }, { "id": "definitions", "name": "Metric definitions", "description": "GET https://agenticfinancegraph.com/def/{id} — what a metric measures, excludes and does not assert.", "tags": [ "methodology", "definitions" ] }, { "id": "agent_record", "name": "One agent's record", "description": "GET https://agenticfinancegraph.com/api/agent?id={token|slug|wallet}&format=json — rank, bound wallets, the 25 newest observed payments with transaction hashes, bindings, reputation and incidents for one ERC-8004 registration on Base. An agent can read its own books this way.", "tags": [ "agent", "record", "payments", "desk" ], "examples": [ "What has agent 53008 paid, and to whom?", "Is wallet 0x0329… bound to a ranked agent?" ] }, { "id": "agent_lookup", "name": "Agent lookup", "description": "GET https://agenticfinancegraph.com/api/agents?q={token|slug|wallet} — one agent's summary; ranked:false means the registration has never been observed paying anyone.", "tags": [ "lookup", "rank" ] }, { "id": "agent_detections", "name": "Detections on one agent", "description": "GET https://agenticfinancegraph.com/api/detections?actor={token} — every detection logged on one registration (drain shape, retry storm, owner change, delegation to unknown code, dead endpoint), newest first.", "tags": [ "detections", "security", "desk" ] }, { "id": "paid_checks", "name": "Evidence packs (checks)", "description": "GET https://agenticfinancegraph.com/check/{precheck|liveness|paygraph|drain|exit|incidents|peer|builders|bundle|reval|statement}?id={token|slug|wallet} (or POST with a JSON id), or /check/{counterparty|venue}?address=0x… — a named evidence pack. precheck (5 cents) is the routine check before paying or hiring an agent: level and last payment, live incidents, statement freshness and, with payto=0x…, what that address is (label, contract or key, how many registered agents paid it, whether this agent paid it before, planted poisoning look-alike or not); facts only, never a verdict. venue (3 cents) says what one address is and reads its last 48 hours of stablecoin flow live. builders (1 cent) lists the ERC-8021 Builder Codes on one agent's payments. The rest: rank with evidence, counterparties and idle flag, the drain shape, its detections, peers, statements with proofs, who paid an address, all four core packs together (bundle, 10 cents), or a fresh re-probe (reval, 25 cents, one per registration per hour). USDC on Base over x402 v2 (402 + PAYMENT-REQUIRED, retry with PAYMENT-SIGNATURE), settled by the Coinbase facilitator; /.well-known/x402 lists every price and the receiving address. Nothing to sell is a 404 before any payment.", "tags": [ "x402", "checks", "evidence", "paid", "agent" ], "examples": [ "Before my agent pays agent 53008 at 0x0e84…b808, run the precheck", "What is 0x337685fdab40d39bd02028545a4ffa7d287cc3e2?", "Buy the drain-shape check for agent 57725", "Is 53008 L7 or just minted?" ] }, { "id": "x402_flow", "name": "x402 settlement, measured", "description": "GET https://agenticfinancegraph.com/api/x402flow — stablecoins received by the sellers listed in the Coinbase x402 Bazaar, read from Base, Polygon, Arbitrum, OP Mainnet, Ethereum and Solana, with the share paid by wallets bound to ERC-8004 agents. Free.", "tags": [ "x402", "bazaar", "settlement", "solana" ] }, { "id": "other_chains", "name": "ERC-8004 beyond Base", "description": "GET https://agenticfinancegraph.com/api/xchain — registrations, owner wallets and stablecoins sent by wallets that minted at least one registration themselves, on Ethereum, Arbitrum, OP Mainnet and Polygon (BNB: see bnb_payments). Never added to Base figures. Free.", "tags": [ "erc-8004", "ethereum", "arbitrum", "optimism", "polygon" ] }, { "id": "treasury", "name": "What ranked agents hold", "description": "GET https://agenticfinancegraph.com/api/treasury — priced holdings of L7+ agents on Base: stablecoins, ETH, DeFi positions net of debt, other tokens; spam counted, never valued. Free.", "tags": [ "treasury", "holdings", "base" ] }, { "id": "census", "name": "Registry census", "description": "GET https://agenticfinancegraph.com/api/state — census_* and sweep_wallets_watched: every ERC-8004 registration on Base is in the graph and every bound wallet is swept every three hours. Free.", "tags": [ "census", "erc-8004", "base" ] }, { "id": "daily_spending", "name": "Agent spending by day (the Engine's hub)", "description": "GET https://agenticfinancegraph.com/api/payday — counted agent spending on Base grouped by the UTC day it was paid: every day, the last full day, 7-day and 30-day averages. The Engine at https://agenticfinancegraph.com/engine draws every measured family around it. Free.", "tags": [ "payments", "base", "daily", "time-series" ] }, { "id": "bnb_payments", "name": "Every BNB registration owner, receipt-checked", "description": "GET https://agenticfinancegraph.com/api/bnbpay — every BNB Smart Chain wallet that minted an ERC-8004 registration itself, its stablecoin transfers after its first mint, each receipt read: pass-through, swaps, contract calls and payments to plain wallets. Never added to Base figures. Free.", "tags": [ "erc-8004", "bnb", "bsc", "receipts" ] }, { "id": "solana_agents", "name": "Solana agents", "description": "GET https://agenticfinancegraph.com/api/state — solana_* keys: the Solana agent registry (registrations, owners, card validity, x402 declared, funded agent wallets) and what agent wallets and owners paid in 30 days. Free.", "tags": [ "solana", "agents", "registry" ] }, { "id": "address_poisoning", "name": "Address-poisoning watch", "description": "GET https://agenticfinancegraph.com/api/state — poison_* keys: look-alike addresses planted in the history of Base wallets that have made counted agent payments, wallets targeted in 7 days, fake-symbol tokens, and losses (a later payment to a planted look-alike), each loss checked two ways. Free.", "tags": [ "security", "poisoning", "base" ] }, { "id": "bridges", "name": "Where bridged agent money arrived", "description": "GET https://agenticfinancegraph.com/api/bridges — counted payments into bridges followed to the chain where each arrived: same address, back to the payer, positions at the destination, refunds. Free.", "tags": [ "bridges", "cross-chain", "cctp" ] }, { "id": "data_health", "name": "Data health", "description": "GET https://agenticfinancegraph.com/api/dq — assertion checks over our own tables every three hours; zero failing rows is a pass. Free.", "tags": [ "data-quality", "audit" ] }, { "id": "since_last", "name": "A figure beside its previous sample", "description": "GET https://agenticfinancegraph.com/api/since?id={metric or definition id}&window=sweep|24h|7d|30d: current, prior, delta, both timestamps, definition id and whether the move is material. No prior sample = gap. Free.", "tags": [ "time-series", "delta" ] }, { "id": "detector_scores", "name": "Each detector's record", "description": "GET https://agenticfinancegraph.com/api/detectors: per rule, fired, open, re-derived, held, withdrawn, next to address poisoning, latest fire; blank where no stored record exists. Free.", "tags": [ "detections", "false-positives" ] }, { "id": "counterparty", "name": "Who paid this address", "description": "GET https://agenticfinancegraph.com/api/counterparty?address=0x…: free counts of the registered agents that paid a receiving address (counted payments only; routing hops excluded). The payer list with binding confidence and transaction hashes: https://agenticfinancegraph.com/check/counterparty?address=0x… (2 cents over x402).", "tags": [ "counterparty", "x402", "sellers" ] }, { "id": "agent_statement", "name": "Agent statement (check before you pay)", "description": "GET https://agenticfinancegraph.com/api/statement/{id}: the agent's latest 3-hour statement, hash-chained to the previous one and proven against an Ed25519-signed Merkle root (https://agenticfinancegraph.com/api/statements). Refuse to pay if stale, if chain_ok is false or if flags is not empty. History with proofs: https://agenticfinancegraph.com/check/statement?id={id} (1 cent).", "tags": [ "statement", "merkle", "trust" ] } ], "additionalInterfaces": [ { "url": "https://agenticfinancegraph.com/api/a2a", "transport": "JSONRPC" } ] }