Agentic Finance Graph Evidence packs (paid, x402) API

openapi: 3.2.0
info:
  title: Agenticfinancegraph Com Evidence packs (paid, x402) 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 Evidence packs (paid, x402) 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: Evidence packs (paid, x402)
paths:
  /check/liveness:
    get:
      operationId: check_liveness
      summary: 'AI agent liveness check: is this ERC-8004 agent on Base alive and paying?'
      description: 'L0–L9 rank with the evidence behind it: bindings (method, confidence, validity), first and last observed payment, stablecoin float, delegation. Dated, with a receipt. The pack is built before the payment settles; a failure on our side costs nothing. Bought from a signed-in wallet it is also listed under Your purchases on the Desk.'
      tags:
      - Evidence packs (paid, x402)
      parameters:
      - name: id
        in: query
        required: true
        description: 'The registration: an ERC-8004 token id on Base (e.g. 53008), the agent slug (8004-base-53008) or a bound wallet address.'
        schema:
          type: string
        example: '53008'
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
        protocols:
        - x402:
            network: eip155:8453
            asset: USDC
            payTo: '0xb25c17e26054bf34e507185dd8981888c9e044fd'
      responses:
        '200':
          description: The pack, with x402.receipt (transaction, network, payer), as_of, definition_ids, license (CC BY 4.0) and what it does not assert.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Unknown kind or an id that names no registration we have a record for.
        '402':
          description: 'Payment required. x402 v2 requirements in the PAYMENT-REQUIRED header and the JSON body: accepts[] (scheme exact, network eip155:8453, USDC, amount in atomic units, payTo, maxTimeoutSeconds) and extensions.bazaar (input schema).'
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://agenticfinancegraph.com
  /check/paygraph:
    get:
      operationId: check_paygraph
      summary: 'Where an AI agent pays: every counterparty, 30-day USD and rail split for one…'
      description: Every counterparty in the record, 30-day USD, rail split, top-counterparty share and the idle flag. The pack is built before the payment settles; a failure on our side costs nothing. Bought from a signed-in wallet it is also listed under Your purchases on the Desk.
      tags:
      - Evidence packs (paid, x402)
      parameters:
      - name: id
        in: query
        required: true
        description: 'The registration: an ERC-8004 token id on Base (e.g. 53008), the agent slug (8004-base-53008) or a bound wallet address.'
        schema:
          type: string
        example: '53008'
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.05'
        protocols:
        - x402:
            network: eip155:8453
            asset: USDC
            payTo: '0xb25c17e26054bf34e507185dd8981888c9e044fd'
      responses:
        '200':
          description: The pack, with x402.receipt (transaction, network, payer), as_of, definition_ids, license (CC BY 4.0) and what it does not assert.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Unknown kind or an id that names no registration we have a record for.
        '402':
          description: 'Payment required. x402 v2 requirements in the PAYMENT-REQUIRED header and the JSON body: accepts[] (scheme exact, network eip155:8453, USDC, amount in atomic units, payTo, maxTimeoutSeconds) and extensions.bazaar (input schema).'
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://agenticfinancegraph.com
  /check/drain:
    get:
      operationId: check_drain
      summary: 'AI agent wallet drain check: the public drain rule applied to one agent''s…'
      description: The public drain rule (a counted payment at least 5× the wallet's previous largest, at least $250, to an address it had never paid, after at least 3 earlier payments) applied to this wallet's payments, and whether it tripped. The pack is built before the payment settles; a failure on our side costs nothing. Bought from a signed-in wallet it is also listed under Your purchases on the Desk.
      tags:
      - Evidence packs (paid, x402)
      parameters:
      - name: id
        in: query
        required: true
        description: 'The registration: an ERC-8004 token id on Base (e.g. 53008), the agent slug (8004-base-53008) or a bound wallet address.'
        schema:
          type: string
        example: '53008'
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.02'
        protocols:
        - x402:
            network: eip155:8453
            asset: USDC
            payTo: '0xb25c17e26054bf34e507185dd8981888c9e044fd'
      responses:
        '200':
          description: The pack, with x402.receipt (transaction, network, payer), as_of, definition_ids, license (CC BY 4.0) and what it does not assert.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Unknown kind or an id that names no registration we have a record for.
        '402':
          description: 'Payment required. x402 v2 requirements in the PAYMENT-REQUIRED header and the JSON body: accepts[] (scheme exact, network eip155:8453, USDC, amount in atomic units, payTo, maxTimeoutSeconds) and extensions.bazaar (input schema).'
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://agenticfinancegraph.com
  /check/incidents:
    get:
      operationId: check_incidents
      summary: 'AI agent incident history: every detection logged on one ERC-8004 registration…'
      description: Every detection logged on this registration, newest first, with the kind explained and its verification status. The pack is built before the payment settles; a failure on our side costs nothing. Bought from a signed-in wallet it is also listed under Your purchases on the Desk.
      tags:
      - Evidence packs (paid, x402)
      parameters:
      - name: id
        in: query
        required: true
        description: 'The registration: an ERC-8004 token id on Base (e.g. 53008), the agent slug (8004-base-53008) or a bound wallet address.'
        schema:
          type: string
        example: '53008'
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
        protocols:
        - x402:
            network: eip155:8453
            asset: USDC
            payTo: '0xb25c17e26054bf34e507185dd8981888c9e044fd'
      responses:
        '200':
          description: The pack, with x402.receipt (transaction, network, payer), as_of, definition_ids, license (CC BY 4.0) and what it does not assert.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Unknown kind or an id that names no registration we have a record for.
        '402':
          description: 'Payment required. x402 v2 requirements in the PAYMENT-REQUIRED header and the JSON body: accepts[] (scheme exact, network eip155:8453, USDC, amount in atomic units, payTo, maxTimeoutSeconds) and extensions.bazaar (input schema).'
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://agenticfinancegraph.com
  /check/peer:
    get:
      operationId: check_peer
      summary: 'Peer agents: up to 10 ranked AI agents that pay the same top counterparty as…'
      description: Up to 10 ranked agents that pay the same top counterparty as this one. The pack is built before the payment settles; a failure on our side costs nothing. Bought from a signed-in wallet it is also listed under Your purchases on the Desk.
      tags:
      - Evidence packs (paid, x402)
      parameters:
      - name: id
        in: query
        required: true
        description: 'The registration: an ERC-8004 token id on Base (e.g. 53008), the agent slug (8004-base-53008) or a bound wallet address.'
        schema:
          type: string
        example: '53008'
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
        protocols:
        - x402:
            network: eip155:8453
            asset: USDC
            payTo: '0xb25c17e26054bf34e507185dd8981888c9e044fd'
      responses:
        '200':
          description: The pack, with x402.receipt (transaction, network, payer), as_of, definition_ids, license (CC BY 4.0) and what it does not assert.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Unknown kind or an id that names no registration we have a record for.
        '402':
          description: 'Payment required. x402 v2 requirements in the PAYMENT-REQUIRED header and the JSON body: accepts[] (scheme exact, network eip155:8453, USDC, amount in atomic units, payTo, maxTimeoutSeconds) and extensions.bazaar (input schema).'
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://agenticfinancegraph.com
  /check/reval:
    get:
      operationId: check_reval
      summary: 'Fresh re-probe of an ERC-8004 agent registration: tokenURI, registration file…'
      description: A fresh probe of the registration from our sandbox (tokenURI, registration file, declared endpoints), compared with our last read. The pack is built before the payment settles; a failure on our side costs nothing. Bought from a signed-in wallet it is also listed under Your purchases on the Desk.
      tags:
      - Evidence packs (paid, x402)
      parameters:
      - name: id
        in: query
        required: true
        description: 'The registration: an ERC-8004 token id on Base (e.g. 53008), the agent slug (8004-base-53008) or a bound wallet address.'
        schema:
          type: string
        example: '53008'
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.25'
        protocols:
        - x402:
            network: eip155:8453
            asset: USDC
            payTo: '0xb25c17e26054bf34e507185dd8981888c9e044fd'
      responses:
        '200':
          description: The pack, with x402.receipt (transaction, network, payer), as_of, definition_ids, license (CC BY 4.0) and what it does not assert.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Unknown kind or an id that names no registration we have a record for.
        '402':
          description: 'Payment required. x402 v2 requirements in the PAYMENT-REQUIRED header and the JSON body: accepts[] (scheme exact, network eip155:8453, USDC, amount in atomic units, payTo, maxTimeoutSeconds) and extensions.bazaar (input schema).'
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://agenticfinancegraph.com
  /check/bundle:
    get:
      operationId: check_bundle
      summary: 'AI agent due-diligence pack: liveness, counterparties, drain shape and…'
      description: Liveness, where it pays, drain shape and incidents in one file. The pack is built before the payment settles; a failure on our side costs nothing. Bought from a signed-in wallet it is also listed under Your purchases on the Desk.
      tags:
      - Evidence packs (paid, x402)
      parameters:
      - name: id
        in: query
        required: true
        description: 'The registration: an ERC-8004 token id on Base (e.g. 53008), the agent slug (8004-base-53008) or a bound wallet address.'
        schema:
          type: string
        example: '53008'
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.10'
        protocols:
        - x402:
            network: eip155:8453
            asset: USDC
            payTo: '0xb25c17e26054bf34e507185dd8981888c9e044fd'
      responses:
        '200':
          description: The pack, with x402.receipt (transaction, network, payer), as_of, definition_ids, license (CC BY 4.0) and what it does not assert.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Unknown kind or an id that names no registration we have a record for.
        '402':
          description: 'Payment required. x402 v2 requirements in the PAYMENT-REQUIRED header and the JSON body: accepts[] (scheme exact, network eip155:8453, USDC, amount in atomic units, payTo, maxTimeoutSeconds) and extensions.bazaar (input schema).'
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://agenticfinancegraph.com
  /check/counterparty:
    get:
      operationId: check_counterparty
      summary: 'Who paid this address: every registered AI agent that paid a wallet, with…'
      description: 'Every registered agent that paid this address in a counted payment: first and last seen, payments, counted USD, distinct L7+ payers, the top payer''s share, and up to 100 payers with level, binding method and confidence, wallet set and their latest transaction hashes. Answered 404 before any payment for an address no registered agent paid, or one that only received routing hops.'
      tags:
      - Evidence packs (paid, x402)
      parameters:
      - name: address
        in: query
        required: true
        description: A receiving address on Base (0x…). endpoint=<x402 resource URL> also works.
        schema:
          type: string
        example: '0x4cd00e387622c35bddb9b4c962c136462338bc31'
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.02'
        protocols:
        - x402:
            network: eip155:8453
            asset: USDC
            payTo: '0xb25c17e26054bf34e507185dd8981888c9e044fd'
      responses:
        '200':
          description: The pack, with x402.receipt (transaction, network, payer), as_of, definition_ids, license (CC BY 4.0) and what it does not assert.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Unknown kind or an id that names no registration we have a record for.
        '402':
          description: 'Payment required. x402 v2 requirements in the PAYMENT-REQUIRED header and the JSON body: accepts[] (scheme exact, network eip155:8453, USDC, amount in atomic units, payTo, maxTimeoutSeconds) and extensions.bazaar (input schema).'
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://agenticfinancegraph.com
  /check/statement:
    get:
      operationId: check_statement
      summary: 'AI agent statement history: 24 three-hour statements, hash-chained, with Merkle…'
      description: The agent's last 24 three-hour statements, each with its hash, the prevHash link that chains them, and a Merkle proof against the signed root of its window, plus chain_ok and stale.
      tags:
      - Evidence packs (paid, x402)
      parameters:
      - name: id
        in: query
        required: true
        description: 'The registration: an ERC-8004 token id on Base (e.g. 53008), the agent slug (8004-base-53008) or a bound wallet address.'
        schema:
          type: string
        example: '53008'
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
        protocols:
        - x402:
            network: eip155:8453
            asset: USDC
            payTo: '0xb25c17e26054bf34e507185dd8981888c9e044fd'
      responses:
        '200':
          description: The pack, with x402.receipt (transaction, network, payer), as_of, definition_ids, license (CC BY 4.0) and what it does not assert.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Unknown kind or an id that names no registration we have a record for.
        '402':
          description: 'Payment required. x402 v2 requirements in the PAYMENT-REQUIRED header and the JSON body: accepts[] (scheme exact, network eip155:8453, USDC, amount in atomic units, payTo, maxTimeoutSeconds) and extensions.bazaar (input schema).'
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://agenticfinancegraph.com
  /check/precheck:
    get:
      operationId: check_precheck
      summary: 'Check before you pay: the routine pre-payment check on one AI agent (and the…'
      description: 'The routine check an operator runs before an agent pays or hires another: the agent''s level and last observed payment, live incidents, how old its latest three-hour statement is, whether the statement chain is intact and its flags, and, with payto, what that address is: label and basis, contract or plain key, how many registered agents paid it, whether this agent paid it before, whether it is an x402 seller, and whether our poisoning watch saw it planted as a look-alike. Facts only, never a verdict; rules_you_may_apply lists the published rules beside the facts. An agent never observed paying is a 404 before any payment.'
      tags:
      - Evidence packs (paid, x402)
      parameters:
      - name: id
        in: query
        required: true
        description: 'The registration: an ERC-8004 token id on Base (e.g. 53008), the agent slug (8004-base-53008) or a bound wallet address.'
        schema:
          type: string
        example: '53008'
      - name: payto
        in: query
        required: false
        description: 'Optional: the 0x address on Base you are about to pay. Adds what that address is.'
        schema:
          type: string
        example: '0x0e84ddedaae6a779c462c22a59f301ec31b6b808'
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.05'
        protocols:
        - x402:
            network: eip155:8453
            asset: USDC
            payTo: '0xb25c17e26054bf34e507185dd8981888c9e044fd'
      responses:
        '200':
          description: The pack, with x402.receipt (transaction, network, payer), as_of, definition_ids, license (CC BY 4.0) and what it does not assert.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Unknown kind or an id that names no registration we have a record for.
        '402':
          description: 'Payment required. x402 v2 requirements in the PAYMENT-REQUIRED header and the JSON body: accepts[] (scheme exact, network eip155:8453, USDC, amount in atomic units, payTo, maxTimeoutSeconds) and extensions.bazaar (input schema).'
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://agenticfinancegraph.com
  /check/builders:
    get:
      operationId: check_builders
      summary: 'Which apps move this agent''s money: ERC-8021 Builder Codes on its counted…'
      description: 'The ERC-8021 Builder Codes found in the calldata of this agent''s counted payments: payments, USD and share per code, the top payee per code, the latest transactions, and how much of its counted spending has been read so far (reads run hourly, highest value first). No counted payment is a 404 and none read yet is a 409, both before any payment. The aggregate by code is free at /api/builders.'
      tags:
      - Evidence packs (paid, x402)
      parameters:
      - name: id
        in: query
        required: true
        description: 'The registration: an ERC-8004 token id on Base (e.g. 53008), the agent slug (8004-base-53008) or a bound wallet address.'
        schema:
          type: string
        example: '53008'
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
        protocols:
        - x402:
            network: eip155:8453
            asset: USDC
            payTo: '0xb25c17e26054bf34e507185dd8981888c9e044fd'
      responses:
        '200':
          description: The pack, with x402.receipt (transaction, network, payer), as_of, definition_ids, license (CC BY 4.0) and what it does not assert.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Unknown kind or an id that names no registration we have a record for.
        '402':
          description: 'Payment required. x402 v2 requirements in the PAYMENT-REQUIRED header and the JSON body: accepts[] (scheme exact, network eip155:8453, USDC, amount in atomic units, payTo, maxTimeoutSeconds) and extensions.bazaar (input schema).'
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://agenticfinancegraph.com
  /check/exit:
    get:
      operationId: check_exit
      summary: 'Did this agent''s wallet empty out: dominant-share windows (drain.abandoned.v1…'
      description: 'Every window in which a new payee took at least 80% of the agent''s counted outflow within 72 hours, at the drain thresholds (5× its previous largest, at least $250, after three earlier payments): the payee, its label, contract or plain key, how many registered agents pay it, whether the agent paid anyone else in the 30 days after and since, and its status under drain.abandoned.v1 (candidate, pending, resumed, service). For up to three windows, the second hop read live when the pack is built: the payee''s first USDC, USDT or EURC transfers out in the 7 days after, with each receiving address''s label, kind and agent payer count. Candidates, never verdicts. An agent with no window is a 404 before any payment.'
      tags:
      - Evidence packs (paid, x402)
      parameters:
      - name: id
        in: query
        required: true
        description: 'The registration: an ERC-8004 token id on Base (e.g. 53008), the agent slug (8004-base-53008) or a bound wallet address.'
        schema:
          type: string
        example: '45978'
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.03'
        protocols:
        - x402:
            network: eip155:8453
            asset: USDC
            payTo: '0xb25c17e26054bf34e507185dd8981888c9e044fd'
      responses:
        '200':
          description: The pack, with x402.receipt (transaction, network, payer), as_of, definition_ids, license (CC BY 4.0) and what it does not assert.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Unknown kind or an id that names no registration we have a record for.
        '402':
          description: 'Payment required. x402 v2 requirements in the PAYMENT-REQUIRED header and the JSON body: accepts[] (scheme exact, network eip155:8453, USDC, amount in atomic units, payTo, maxTimeoutSeconds) and extensions.bazaar (input schema).'
          content:
            application/json:
              schema:
                type: object
        '404':
          description: No dominant-share window in this agent's counted payments, or no record for the id; answered before any payment, nothing charged.
    servers:
    - url: https://agenticfinancegraph.com
  /check/venue:
    get:
      operationId: check_venue
      summary: 'What is this address: label, contract or key, who pays it, poisoning look-alike…'
      description: 'One address on Base: its label with category, basis and evidence link, contract or plain key (and any EIP-7702 delegation), registered agents that paid it in 30 days and all time with counted USD, whether it is a registered agent''s bound wallet, an x402 seller or an address our poisoning watch saw planted as a look-alike, and its USDC, USDT and EURC transfers over the last 48 hours, read live (capped at 2,000 per direction and marked when capped). An address with no label and no record in our tables is a 404 before any payment.'
      tags:
      - Evidence packs (paid, x402)
      parameters:
      - name: address
        in: query
        required: true
        description: An address on Base (0x…).
        schema:
          type: string
        example: '0x337685fdab40d39bd02028545a4ffa7d287cc3e2'
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.03'
        protocols:
        - x402:
            network: eip155:8453
            asset: USDC
            payTo: '0xb25c17e26054bf34e507185dd8981888c9e044fd'
      responses:
        '200':
          description: The pack, with x402.receipt (transaction, network, payer), as_of, definition_ids, license (CC BY 4.0) and what it does not assert.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Unknown kind or an id that names no registration we have a record for.
        '402':
          description: 'Payment required. x402 v2 requirements in the PAYMENT-REQUIRED header and the JSON body: accepts[] (scheme exact, network eip155:8453, USDC, amount in atomic units, payTo, maxTimeoutSeconds) and extensions.bazaar (input schema).'
          content:
            application/json:
              schema:
                type: object
    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