canonical: https://jentic.com/apis/agenticfinancegraph.com/agenticfinancegraph # Agentic Finance Graph — public state API The Agentic Finance Graph API reports the machine-readable state of the AI-agent economy, returning live stablecoin float, USDC circulating supply, native USDC on Base, agent vault cash, and DeFi TVL alongside cited ERC-8004 liveness and x402 payment statistics. It serves a two-resolution historical archive, ranks on-chain agents by observed payment activity, and logs anomaly detections such as drain shapes and mint bursts. Paid evidence packs return per-agent due diligence on liveness, counterparties, drain rules, and incidents, settled per call over x402 in USDC on Base. Every figure carries a definition id, an as_of timestamp, and its provenance, so a consumer can tell a measured value from cited research. ## For AI agents Read live and historical metrics of the on-chain AI-agent economy, rank ERC-8004 agents by payment activity, and buy per-agent due-diligence evidence packs over x402. Returns stablecoin float, DeFi TVL, and agent payment statistics with provenance on every figure. ## Scope Does not execute trades, custody funds, or move money on your behalf. Use for reading and verifying on-chain AI-agent economy metrics only. ## Capabilities - Read the current agent-economy tape: stablecoin float, USDC circulating supply, native USDC on Base, agent vault cash, and DeFi TVL - Pull a two-resolution historical series of any tracked metric over windows from 24 hours to all time - Rank ERC-8004 agents on Base by observed payment activity and look up a single agent's full record - Check an agent's liveness level, counterparties, and drain-rule status through paid x402 evidence packs - List anomaly detections such as drain shapes, retry storms, and mint bursts, each with its verification status - Retrieve frozen metric definitions so every figure traces to what it counts and what it excludes ## Use cases ### Agent-Driven Counterparty Due Diligence Before an autonomous agent transacts with another on-chain agent, it can buy a due-diligence bundle that returns liveness, where the counterparty pays, its drain-rule shape, and any logged incidents in one file. Each evidence pack is settled per call over x402 in USDC on Base and carries a receipt, a definition id, and an as_of timestamp, so the agent records exactly what it checked and when. This lets an agent gate a payment or a delegation on verifiable on-chain behaviour rather than a self-reported profile. Example prompt: Call the due-diligence bundle pack for ERC-8004 token id 53008 on Base over x402 and summarise its liveness rank, top counterparties, drain-rule status, and any open incidents. ### Monitoring the Stablecoin and DeFi Tape Teams tracking the machine-money economy can read a single current snapshot of stablecoin float, USDC circulating supply, native USDC on Base, agent vault cash, and total and Base DeFi TVL. The free state read is cached at the edge and labels each value as live or cited with its source and window, so dashboards never confuse a directly read figure with imported research. It is the fastest way to pull a current, provenance-tagged picture of agent-economy liquidity. Example prompt: Read the current tape and report stablecoin float, USDC share of float, and total DeFi TVL, each with its definition id and as_of timestamp. ### Ranking and Tracking On-Chain Agents Researchers and marketplaces can list ERC-8004 agents on Base that have been observed paying a different address after registration, ranked by payment activity, counterparties, float, and logged incidents. A single agent can be looked up by token id, slug, or bound wallet to pull its rank, its bindings, and its newest observed payments. Because a registration that has never been seen paying is reported as unranked, the ranking separates economic actors from mere registrations. Example prompt: List the top ranked agents by payment activity, then look up token id 53008 and report its rank, bindings, and most recent observed payments. ### Charting the Agent Economy Over Time The historical archive stitches daily points kept for two years with five-minute points kept for the recent window, so a chart can span from the last day to all-time without interpolating gaps. Each point is labelled by source as daily backfill, a live snapshot, or a day-close snapshot, and coverage metadata lets a consumer tell a real gap from a zero. Analysts use it to plot stablecoin float, payments settled, and TVL trends with honest coverage. Example prompt: Fetch the 1-year series for agent payments settled in USDC and return the oldest and newest points with their source labels and the coverage summary. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/api/state` | Current tape of live and cited agent-economy metrics with provenance | | GET | `/api/series` | Two-resolution historical archive of the tape | | GET | `/api/agents` | Ranked ERC-8004 agents on Base | | GET | `/api/agent` | One ranked agent's record with bindings and payments | | GET | `/check/liveness` | Paid liveness evidence pack (L0 to L9 rank) over x402 | | GET | `/check/bundle` | Paid due-diligence bundle: liveness, counterparties, drain, incidents | | GET | `/api/detections` | Logged anomaly detections, newest first | | GET | `/api/def` | Frozen metric definitions | ## Key resources - **State and Series** — Current tape of live and cited metrics and the two-resolution historical archive behind them - **Agents** — Ranked ERC-8004 agents on Base and single-agent records with bindings and observed payments - **Evidence Packs** — Paid per-agent due-diligence packs (liveness, paygraph, drain, incidents, peer, reval, bundle) settled over x402 - **Detections and Findings** — Logged anomalies such as drain shapes, retry storms, and mint bursts, with verification status - **Definitions** — Frozen metric definitions stating what each figure counts, its method, and what it excludes ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 64 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 74 / 100 - Developer Experience & Jentic Compatibility: 62 / 100 - AI-Readiness & Agent Experience: 42 / 100 - Agent Usability: 94 / 100 - Security: 100 / 100 - AI Discoverability: 63 / 100 - **View full report:** https://jentic.com/apis/agenticfinancegraph.com/agenticfinancegraph/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the Agentic Finance Graph API by hand means handling its free /api reads and the separate x402 payment flow on the /check evidence packs, where a bare request answers 402 and you sign and retry. Through Jentic you install once, import it from the API Directory, and your agent calls both the free reads and the paid packs without you hand-wiring the payment handshake. - **Permission scoping:** You choose which operations your agent may call, such as the current-tape and historical-series reads, so the paid evidence-pack operations like the due-diligence bundle are not included unless you add them. On most operations the agent id travels in the query string, so rules bound which operations run rather than which agent id. - **Credential handling:** This API is free and unauthenticated, so there is no key to hold. Your agent reaches it through your own Jentic One instance, which keeps every request and any x402 payment signing on your own infrastructure rather than in the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'read the agent economy tape' or 'check an agent's liveness', and Jentic returns the matching Agentic Finance Graph operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **CoinGecko** — Broad crypto market data (prices, market cap, volume) rather than agent-economy and ERC-8004 metrics - **Blockchain.com** — General on-chain blockchain data to pair with agent-specific payment and liveness metrics - **Dune** — Custom on-chain analytics via SQL queries rather than a ready-made agent-economy tape ## FAQ ### What authentication does the Agentic Finance Graph API use? Per its OpenAPI spec the Agentic Finance Graph API is free and unauthenticated: the read operations under /api carry no credential. The paid evidence-pack operations under /check are gated by x402 payment rather than a login, so a bare request answers 402 with the payment requirements and you retry with a signed payment header. There is no API key to manage. ### Can I track stablecoin float and DeFi TVL with the Agentic Finance Graph API? Yes. The current-tape read returns stablecoin float, USDC and USDT circulating supply, USDC share of float, native USDC on Base, agent vault cash, and total and Base DeFi TVL in one response. Each value is labelled live or cited and carries its own definition id, so you know how it was measured. ### What are the rate limits for the Agentic Finance Graph API? The OpenAPI spec does not publish rate limits for the Agentic Finance Graph API. The free state and partner reads are cached at the edge, so repeated calls are cheap; for current limits check the vendor documentation at https://agenticfinancegraph.com. ### How do I read the current agent-economy tape with the Agentic Finance Graph API through Jentic? Import the Agentic Finance Graph API from the Jentic API Directory, then have your agent search by intent such as 'read the current agent economy tape' and Jentic returns the current-tape read with its input schema. The agent calls it and gets the live metrics with provenance on every figure. To run it on your own infrastructure, install Jentic One from its GitHub repo. ### Can I limit what my agent is allowed to do with the Agentic Finance Graph API? Yes. Write a rule that allows only the free read operations your task needs, such as the current-tape and historical-series reads, and the agent can pull those figures and nothing else, with every call logged. Because the paid evidence-pack operations are left out of that rule, your agent cannot spend USDC on a pack unless you add them. ### Is there an Agentic Finance Graph MCP server? The API publishes an MCP endpoint, and you can also reach the same free data directly through Jentic. Import the API from the Jentic API Directory and your agent calls operations like the current-tape read on demand, without loading another server's tool definitions into its context. ### Can I check whether an ERC-8004 agent is alive and paying? Yes. The liveness evidence pack returns an L0 to L9 rank with the evidence behind it: the bindings, the first and last observed payment, the stablecoin float, and any delegation. It is a paid pack settled per call over x402 in USDC on Base and comes with a dated receipt.