Agentic Finance Graph Agents API

openapi: 3.2.0
info:
  title: Agenticfinancegraph Com Agents 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 Agents 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: Agents
paths:
  /api/agents:
    get:
      operationId: listRankedAgents
      summary: Ranked agents (L7+)
      description: 'Agents whose bound wallet was observed paying a different address after registration, with payments, counterparties, float and incidents. Free tier: the top 25; a paid Desk session unlocks the full list. With q, looks up one id and answers ranked:false for a registration never seen paying.'
      parameters:
      - name: q
        in: query
        required: false
        description: 'Token id, slug or wallet address: look up one agent'
        schema:
          type: string
      - name: limit
        in: query
        required: false
        description: 'How many to return (free: at most 25)'
        schema:
          type: integer
          minimum: 1
      - name: min_level
        in: query
        required: false
        description: Only agents at or above this liveness level
        schema:
          type: integer
          minimum: 7
          maximum: 9
      - name: sort
        in: query
        required: false
        description: Sort key
        schema:
          type: string
      - name: delegated
        in: query
        required: false
        description: Only wallets with (true) or without (false) an EIP-7702 delegation
        schema:
          type: string
      - name: has_incidents
        in: query
        required: false
        description: Only agents with logged detections
        schema:
          type: string
      responses:
        '200':
          description: 'JSON (CC BY 4.0). Free tier: the top 25; the full list with a Desk plan.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentList'
      security: []
      tags:
      - Agents
    servers:
    - url: https://agenticfinancegraph.com
  /api/stability:
    get:
      operationId: getStability
      summary: 'Stable for N days: the behaviour clock per ranked agent'
      description: 'The run length since the last break in each ranked agent''s own payment behaviour (CUSUM on payments, USD, payees and new-payee share against its own history), the last break, and its 30-day heartbeat class; ?agent= for one agent. Definitions: /def/stability.run_length.v1, /def/stability.heartbeat.v1. Free.'
      tags:
      - Agents
      parameters:
      - name: agent
        in: query
        required: false
        schema:
          type: string
        description: 'Optional: a Base ERC-8004 token id, act_8453_N, slug or bound wallet for one agent''s record'
      responses:
        '200':
          description: The document
    servers:
    - url: https://agenticfinancegraph.com
  /api/independence:
    get:
      operationId: getIndependence
      summary: The independence score, the inflation ratio and the operator sets
      description: 'Seed-based best-path independence score per ranked agent, its L9 support under the published and the cluster-aware rule, the inflation ratio, the operator sets behind the rank and the held merges; ?agent= for one agent. Definitions: /def/rank.independence.v1, /def/rank.inflation.v1, /def/cluster.ratio.v1. Free.'
      tags:
      - Agents
      parameters:
      - name: agent
        in: query
        required: false
        schema:
          type: string
        description: 'Optional: one agent''s record'
      responses:
        '200':
          description: The document
    servers:
    - url: https://agenticfinancegraph.com
  /api/ladder-dynamics:
    get:
      operationId: getLadderDynamics
      summary: How ranked agents end, the drain ratio per platform, the transition matrix, the…
      description: 'Cumulative incidence of competing exits with numbers at risk, the Standardised Drain Ratio per minting address with intervals, day-to-day moves between L7, L8, L9 and out, and the landmark re-check of the published survival figures. Definitions: /def/ladder.exit_incidence.v1, /def/platform.sdr.v1, /def/ladder.transition.v1, /def/survival.landmark.v1. Free.'
      tags:
      - Agents
      responses:
        '200':
          description: The document
    servers:
    - url: https://agenticfinancegraph.com
  /api/sum-log:
    get:
      operationId: getSumLog
      summary: 'The verifiable counted total: signed head, proofs per payment and per agent'
      description: 'The Merkle-sum head over every counted payment (root, total, agent root, Ed25519 signature, what changed since the previous head); ?event= gives a payment''s proof to the root and the total; ?agent=[&leaves=1] gives an agent''s record (root, sum, count), its proof in the agent tree and whether its history was rewritten. Definition: /def/sumlog.v1. Free.'
      tags:
      - Agents
      parameters:
      - name: event
        in: query
        required: false
        schema:
          type: string
        description: A counted payment's event id (a proof of that payment), or use agent
      responses:
        '200':
          description: The document
    servers:
    - url: https://agenticfinancegraph.com
  /api/freezes:
    get:
      operationId: getFreezes
      summary: Issuer freezes on Base
      description: 'The stablecoin issuers'' own freeze events (Circle on USDC and EURC, Tether on USDT), the addresses frozen now, which of them registered agents paid, and which bound agent wallets are frozen. Definition: /def/issuer.freeze.v1. Free.'
      tags:
      - Agents
      responses:
        '200':
          description: The document
    servers:
    - url: https://agenticfinancegraph.com
  /api/x402-submitters:
    get:
      operationId: getX402Submitters
      summary: Who submits x402 settlements on Base
      description: 'Settlements of the last 24 hours into Bazaar-listed sellers classified by submitter (self, facilitator, third party, bundler), the share in the closed receiveWithAuthorization form, and the third-party transactions to read. Definition: /def/x402.settle.submitter.v1. Free.'
      tags:
      - Agents
      responses:
        '200':
          description: The document
    servers:
    - url: https://agenticfinancegraph.com
  /api/payers:
    get:
      operationId: getPayers
      summary: Who paid an agent, and how much of its feedback came from payers
      description: 'The wallets observed paying one ERC-8004 agent on Base (income into its bound wallets, plus counted payments from other registered agents), up to 250, largest by USD first, with how much of its ERC-8004 feedback is payment-grounded (the reviewer paid before rating). get_summary_input is ready to pass to the Reputation Registry''s getSummary as clientAddresses. Free. Definitions: /def/payers.set.v1, /def/rep.grounded.v1.'
      tags:
      - Agents
      parameters:
      - name: agent
        in: query
        required: true
        schema:
          type: string
        description: Base ERC-8004 token id, act_8453_N, or a ranked agent's slug or bound wallet
      responses:
        '200':
          description: The payer set and the feedback grounding
          content:
            application/json:
              schema:
                type: object
                properties:
                  token_id:
                    type: string
                  payers_total:
                    type: integer
                  payers:
                    type: array
                    items:
                      type: object
                      properties:
                        address:
                          type: string
                        payments:
                          type: integer
                        usd:
                          type:
                          - number
                          - 'null'
                        first_paid:
                          type:
                          - string
                          - 'null'
                        last_paid:
                          type:
                          - string
                          - 'null'
                        via:
                          type: array
                          items:
                            type: string
                        payer_token_id:
                          type:
                          - string
                          - 'null'
                  feedback:
                    type: object
                  get_summary_input:
                    type: object
                  coverage:
                    type: object
        '400':
          description: Not a recognisable agent
        '503':
          description: The payer set could not be read; nothing is substituted
    servers:
    - url: https://agenticfinancegraph.com
components:
  schemas:
    Agent:
      type: object
      required:
      - id
      - token_id
      - slug
      - liveness
      properties:
        id:
          type: string
          examples:
          - act_8453_57657
        token_id:
          type: string
        slug:
          type: string
          examples:
          - 8004-base-57657
        declared_name:
          type:
          - string
          - 'null'
          description: Name declared in its registration file, cleaned; not verified
        url:
          type: string
          format: uri
        liveness:
          type: integer
          minimum: 7
          maximum: 9
        registered_at:
          type: string
          format: date-time
        chain:
          type: string
          examples:
          - eip155:8453
        wallet:
          type: string
        usdc_float:
          type:
          - number
          - 'null'
          description: Rounded on the free tier
        stables_float:
          type:
          - number
          - 'null'
        delegated_7702:
          description: EIP-7702 implementation address, or false
          type:
          - string
          - boolean
          - 'null'
        pay:
          type: object
          properties:
            events:
              type: integer
            usd:
              type: number
            counterparties:
              type: integer
            events_30d:
              type: integer
            usd_30d:
              type: number
            first:
              type: string
              format: date-time
            last:
              type: string
              format: date-time
    AgentList:
      type: object
      properties:
        as_of:
          type: string
          format: date-time
        tier:
          type: string
        total_ranked:
          type: integer
        returned:
          type: integer
        withheld_by_tier:
          type: integer
          description: Ranked agents beyond the free top 25
        agents:
          type: array
          items:
            $ref: '#/components/schemas/Agent'
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