Agentic Finance Graph Statements API

openapi: 3.2.0
info:
  title: Agenticfinancegraph Com Statements 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 Statements 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: Statements
paths:
  /api/statements:
    get:
      operationId: getStatementRoots
      summary: Statement roots and the signing key
      description: 'The Merkle root of every 3-hour window with its leaf count, previous root and Ed25519 signature; the public key; the hashing rules; whether roots are committed on chain (not yet: that needs a funded publisher key); and how often statements are read. Definition agent.statement.root.v1.'
      parameters: []
      responses:
        '200':
          description: JSON (CC BY 4.0).
        '404':
          description: Nothing stored for this input; nothing is estimated in its place.
      security: []
      tags:
      - Statements
    servers:
    - url: https://agenticfinancegraph.com
  /api/statements/log:
    get:
      operationId: getStatementLog
      summary: Append-only log over the signed statement roots (RFC 6962)
      description: 'The signed tree head, every past head and the leaves (each leaf is the exact message a statement-window root was signed over). With consistency=: the RFC 6962 proof that the current tree extends the tree of size m, so a head you kept proves our history was not rewritten. With inclusion=: the audit path of one leaf. SHA-256 with 0x00/0x01 prefixes; heads signed with the Ed25519 statement key. Definition: /def/agent.statement.log.v1.'
      tags:
      - Statements
      parameters:
      - name: consistency
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
      - name: inclusion
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
      - name: size
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
        description: 'Tree size to prove against (default: the latest head)'
      responses:
        '200':
          description: Head, proofs and leaves
          content:
            application/json:
              schema:
                type: object
                properties:
                  sth:
                    type: object
                    properties:
                      tree_size:
                        type: integer
                      root_hash:
                        type: string
                      timestamp_ms:
                        type: integer
                      signature:
                        type: string
                      key_id:
                        type: string
                  consistency:
                    type: object
                  inclusion:
                    type: object
                  heads:
                    type: array
                    items:
                      type: object
                  leaves:
                    type: array
                    items:
                      type: object
        '400':
          description: Out-of-range size or index
        '503':
          description: The leaves do not rebuild the signed head, or the log is not published; nothing is served
    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