Agentic Finance Graph

{
  "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 \u2014 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 \u2014 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 \u2014 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 \u2014 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} \u2014 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 \u2014 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\u2026 bound to a ranked agent?"
      ]
    },
    {
      "id": "agent_lookup",
      "name": "Agent lookup",
      "description": "GET https://agenticfinancegraph.com/api/agents?q={token|slug|wallet} \u2014 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} \u2014 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\u2026 \u2014 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\u2026, 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\u2026b808, 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 \u2014 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 \u2014 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 \u2014 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 \u2014 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 \u2014 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 \u2014 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 \u2014 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 \u2014 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 \u2014 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 \u2014 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\u2026: 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\u2026 (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"
    }
  ]
}