Agentic Finance Graph State API

openapi: 3.2.0
info:
  title: Agenticfinancegraph Com State 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 State 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: State
paths:
  /api/state:
    get:
      operationId: getState
      summary: 'Current machine-money tape: live and cited metrics with provenance'
      description: Returns stablecoin float, USDC circulating and share, native USDC on Base (eth_call totalSupply), agent vault cash (ERC-4626 totalAssets), DeFi TVL, plus cited ERC-8004 liveness and x402 payment statistics. Cached 5 minutes at the edge.
      responses:
        '200':
          description: The tape
          content:
            application/json:
              schema:
                type: object
                properties:
                  as_of:
                    type: string
                    format: date-time
                  live:
                    type: object
                    description: First-party or directly-read values
                    properties:
                      stablecoin_float_usd:
                        $ref: '#/components/schemas/Metric'
                      usdc_circulating_usd:
                        $ref: '#/components/schemas/Metric'
                      usdt_circulating_usd:
                        $ref: '#/components/schemas/Metric'
                      usdc_share_of_float:
                        $ref: '#/components/schemas/Metric'
                      native_usdc_on_base_usd:
                        $ref: '#/components/schemas/Metric'
                      total_agent_vault_cash_usdc:
                        $ref: '#/components/schemas/Metric'
                      defi_tvl_total_usd:
                        $ref: '#/components/schemas/Metric'
                      defi_tvl_base_usd:
                        $ref: '#/components/schemas/Metric'
                    additionalProperties:
                      $ref: '#/components/schemas/Metric'
                  cited:
                    type: object
                    description: Imported research, labeled with its producer and window
                    properties:
                      erc8004_registrations_total:
                        $ref: '#/components/schemas/Metric'
                      erc8004_working_service_rate:
                        $ref: '#/components/schemas/Metric'
                      base_strict_liveness_rate:
                        $ref: '#/components/schemas/Metric'
                      agent_payments_settled_usd:
                        $ref: '#/components/schemas/Metric'
                      agent_payment_avg_ticket_usd:
                        $ref: '#/components/schemas/Metric'
                      usdc_settlement_share_agent_rails:
                        $ref: '#/components/schemas/Metric'
                      agentfi_tvl_labeled_usd:
                        $ref: '#/components/schemas/Metric'
                    additionalProperties:
                      $ref: '#/components/schemas/Metric'
                  measured:
                    type: object
                    description: Our own sweeps, census and payment scans
                    additionalProperties:
                      $ref: '#/components/schemas/Metric'
                  context:
                    type: object
                    description: Market scale (prices, float); never agent activity
                    additionalProperties:
                      $ref: '#/components/schemas/Metric'
                  degraded:
                    type: boolean
                  health:
                    type: object
                    description: 'Collector health: sources answering, metrics fresh and stale over the served set, definition coverage'
      security: []
      tags:
      - State
    servers:
    - url: https://agenticfinancegraph.com
components:
  schemas:
    Metric:
      type: object
      required:
      - value
      - unit
      - producer
      - kind
      properties:
        value:
          type: number
        unit:
          type: string
          examples:
          - USD
          - USDC
          - ratio
          - agents
        producer:
          type: string
          description: self | DefiLlama | Keyrock | 8004scan | ...
          examples:
          - self
          - DefiLlama
        kind:
          type: string
          enum:
          - live
          - measured
          - context
          - cited
          description: 'live: read from a public API or eth_call; measured: our own sweep, census or scan; context: market scale, never agent activity; cited: someone else research, dated, not reproduced'
        window:
          type: string
          description: Time window the value describes
        as_of:
          type: string
          format: date-time
        method:
          type: string
          description: How a live value was produced, e.g. eth_call totalAssets()
        caveat:
          type: string
        stale:
          type: boolean
          description: true when the source did not answer at the last check; the value is the last one actually measured
        definition_id:
          type: string
          description: Frozen definition of the figure; GET /def/{id}
          examples:
          - rank.l7plus.v2
        third_party:
          type: boolean
        note:
          type: string
        replaces:
          type: string
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