Agentic Finance Graph Data API

The Data API from Agentic Finance Graph — 7 operation(s) for data.

Operations 7

GET /api/changepoints Dated changes of ours that moved a series #
GET /api/steps Steps in our own series, and what explains each #
GET /api/approvals Token approvals from AI-agent wallets, and what stands behind them #
GET /api/crosscheck ERC-8004 registrations measured two ways, per chain #
GET /api/bindings Bindings of every ranked agent (one file) #
POST /api/a2a A2A message/send (JSON-RPC, protocol 0.3) #
GET /api/usage What our origin served: requests by route family, status class and UTC hour #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/agenticfinancegraph-com:agenticfinancegraph-com-data-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

agenticfinancegraph-com-data-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Agenticfinancegraph Com Data API
  version: 0.19.0
  contact:
    email: agenticfinancegraph@proton.me
    url: https://agenticfinancegraph.com
  license:
    name: CC BY 4.0
    url: https://creativecommons.org/licenses/by/4.0/
  x-guidance: 'Free routes (/api/*) need no key and no payment; read /api/state first for every current figure with its definition id and as_of. Paid evidence packs: GET /check/{kind}?id=<ERC-8004 token id on Base> answers 402 with x402 v2 requirements (USDC on Base, exact scheme, amount in atomic units, payTo); sign the payment and retry with the PAYMENT-SIGNATURE header; the 200 body is the pack with its receipt. Kinds and prices in USDC: liveness 0.01, paygraph 0.05, drain 0.02, incidents 0.01, peer 0.01, bundle 0.10, reval 0.25; the 402 states the exact amount before anything is charged. MCP clients can read the same free data at https://agenticfinancegraph.com/mcp. Every figure is a measurement with a time, never an estimate; quote the counted total only beside the top-wallet share and the median.'
  description: 'Operations tagged Data across 3 of this provider''s published API definitions: openapi.json, agenticfinancegraph-com-openapi.json, openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://agenticfinancegraph.com
tags:
- name: Data
paths:
  /api/changepoints:
    get:
      operationId: getChangepoints
      summary: Dated changes of ours that moved a series
      description: Every change to coverage, method, the asset set, the label map or a detector rule, with its date, the metric keys it moved and where it is written up. A step in a series at one of these dates is our change, not the market's. Entries are never edited or removed.
      tags:
      - Data
      responses:
        '200':
          description: The changepoint register
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                  changepoints:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        date:
                          type: string
                        kind:
                          type: string
                          enum:
                          - method
                          - coverage
                          - asset_set
                          - label_map
                          - detector_rule
                          - backfill
                        comparable_from:
                          type:
                          - string
                          - 'null'
                        metric_keys:
                          type: array
                          items:
                            type: string
                        definition_ids:
                          type: array
                          items:
                            type: string
                        summary:
                          type: string
                        reference:
                          type: string
                        corrects:
                          type: string
                          description: 'For a correcting entry: the id of the entry whose scope or facts it corrects (that entry stays unchanged).'
                        registered:
                          type: string
                          description: 'For a correcting entry: the date it was added, when later than the change itself.'
    servers:
    - url: https://agenticfinancegraph.com
  /api/steps:
    get:
      operationId: getSteps
      summary: Steps in our own series, and what explains each
      description: A step is a material move in one of our archived series, concentrated in one day and persisting for two more (PELT over each daily series, Killick, Fearnhead & Eckley 2012, confirmed by a one-day jump test). Each step is explained by a dated entry in /api/changepoints, by a checked note (a move of the world, measured two ways), marked settling (the series is under a week old), or left open; the data check unexplained_step warns on open steps from the last 14 days.
      tags:
      - Data
      responses:
        '200':
          description: Steps from the last 14 days with their status
          content:
            application/json:
              schema:
                type: object
                properties:
                  as_of:
                    type: string
                    format: date-time
                  method:
                    type: string
                  parameters:
                    type: object
                  summary:
                    type: object
                  steps:
                    type: array
                    items:
                      type: object
                      properties:
                        metric:
                          type: string
                        step_day:
                          type: string
                          format: date
                        before:
                          type: number
                        after:
                          type: number
                        shift:
                          type: number
                        ratio:
                          type:
                          - number
                          - 'null'
                        z:
                          type: number
                        status:
                          type: string
                          enum:
                          - explained
                          - acknowledged
                          - settling
                          - open
                        explained_by:
                          type:
                          - string
                          - 'null'
                        note:
                          type:
                          - string
                          - 'null'
        '503':
          description: The document could not be read or did not verify; nothing is substituted
    servers:
    - url: https://agenticfinancegraph.com
  /api/approvals:
    get:
      operationId: getApprovals
      summary: Token approvals from AI-agent wallets, and what stands behind them
      description: 'ERC-20 and Permit2 approvals that paying agent wallets on Base gave in the last 30 days (USDC, USDT, DAI, USDbC, EURC, WETH, cbBTC); spenders with their code type and label; the balances behind unlimited approvals still standing; and approvals to plain accounts (no contract code) with their transactions. Daily. A standing approval is exposure, not a loss. Definitions: /def/approval.*.'
      tags:
      - Data
      responses:
        '200':
          description: Totals, exposure, top spenders, plain-account approvals
        '503':
          description: Not published yet or did not verify; nothing is substituted
    servers:
    - url: https://agenticfinancegraph.com
  /api/crosscheck:
    get:
      operationId: getCrosscheck
      summary: ERC-8004 registrations measured two ways, per chain
      description: 'Each row is one chain and one closed UTC day: The Graph Agent0 subgraph total for that day beside our own count. Base is counted exactly at the day end from our dated mint table; other chains test whether the subgraph total falls between our census readings just before and just after the day ended. A gap is published as measured. Refreshed daily (afg-graphcheck).'
      tags:
      - Data
      responses:
        '200':
          description: latest row per chain and the last 7 days of rows
          content:
            application/json:
              schema:
                type: object
        '503':
          description: the document could not be read; no substitute is served
    servers:
    - url: https://agenticfinancegraph.com
  /api/bindings:
    get:
      operationId: getBindings
      summary: Bindings of every ranked agent (one file)
      description: 'Every binding of every agent ranked L7 or above on Base: wallet, ERC-8004 registration, method (1 = holds the registration via ownerOf, 3 = agentWallet declared in the registration file), confidence, validity and evidence, with a SHA-256 of the rows. Rebuilt every three hours by the rank job. Ranked agents only.'
      tags:
      - Data
      responses:
        '200':
          description: count, rows_sha256 and rows
          content:
            application/json:
              schema:
                type: object
        '503':
          description: the document could not be read; no substitute is served
    servers:
    - url: https://agenticfinancegraph.com
  /api/a2a:
    post:
      operationId: a2aMessageSend
      summary: A2A message/send (JSON-RPC, protocol 0.3)
      description: 'Send an A2A JSON-RPC request with method message/send. Text is routed by what it asks (an agent id or 0x address, a check before paying, detections, the top of the rank, the market state); a data part {"tool": "", "arguments": {...}} calls a tool of the MCP server directly. Every reply is a Message (no tasks, no streaming). The agent card is at /.well-known/agent-card.json.'
      tags:
      - Data
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: JSON-RPC response with a Message result or an error
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://agenticfinancegraph.com
  /api/usage:
    get:
      operationId: getUsage
      summary: 'What our origin served: requests by route family, status class and UTC hour'
      description: 'Counts of the requests our origin server answered, keyed by UTC hour, route family (home, page/, api/, mcp, check/, def/*, agents/*, asset, well-known, other) and status class (2xx, 3xx, 402, 4xx, 5xx); MCP tool calls are also counted per tool. Nothing per visitor is kept: no address, no user agent, no query string, no body. Cloudflare answers some requests from its cache and those never reach the origin, so every figure is a floor; our own checks are included. Definition usage.origin.v1. Counting started on 30 Oct 2026.'
      tags:
      - Data
      responses:
        '200':
          description: Today by hour and by route, and daily totals for up to 31 days
          content:
            application/json:
              schema:
                type: object
                properties:
                  definition_id:
                    type: string
                  definition_url:
                    type: string
                  as_of:
                    type: string
                    format: date-time
                  since:
                    type:
                    - string
                    - 'null'
                  note:
                    type: string
                  counting:
                    type: string
                  today:
                    type:
                    - object
                    - 'null'
                    properties:
                      day:
                        type: string
                      total:
                        type: integer
                      by_status:
                        type: object
                        additionalProperties:
                          type: integer
                      by_route:
                        type: object
                        additionalProperties:
                          type: integer
                      mcp_tool_calls:
                        type: object
                        additionalProperties:
                          type: integer
                      by_hour:
                        type: object
                        additionalProperties:
                          type: integer
                  days:
                    type: array
                    items:
                      type: object
                      properties:
                        day:
                          type: string
                        total:
                          type: integer
                        by_status:
                          type: object
                          additionalProperties:
                            type: integer
                        by_route:
                          type: object
                          additionalProperties:
                            type: integer
                        mcp_tool_calls:
                          type: object
                          additionalProperties:
                            type: integer
    servers:
    - url: https://agenticfinancegraph.com
x-refined-from:
- openapi.json
- agenticfinancegraph-com-openapi.json
- openapi.json
x-agentcash-guidance:
  llmsTxtUrl: https://agenticfinancegraph.com/llms.txt
x-discovery:
  compat: https://agenticfinancegraph.com/.well-known/x402
  catalog: https://agenticfinancegraph.com/.well-known/agent-card.json