Agentic Finance Graph Partners API

openapi: 3.2.0
info:
  title: Agenticfinancegraph Com Partners 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 Partners 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: Partners
paths:
  /api/partners:
    get:
      operationId: getPartnerGravity
      summary: Third-party agent catalogs joined to our own qualifier
      description: 'Marketplaces and registries each publish a census of themselves; none of those counts answer whether the listed names are economic actors. This endpoint runs our qualifier over their catalogs and reports the result against OUR denominator.


        Read three things before quoting any figure here.


        1. `attempted` is the identities WE ingested and checked — never the partner''s own published census. A rate over somebody else''s marketing total cannot be reproduced.

        2. `moved_usdc` is NOT L7. It means the declared wallet sent USDC to a different address after the identity existed. From a raw wallet read a token launch, a bonding-curve buy and a DEX swap are indistinguishable from a payment for work, so L7 is withheld on catalogs where we cannot yet see job state, and the blocker is named in the response.

        3. Each partner block carries a `caveats` array. The caveats are part of the number.


        A measured zero and a withheld value are different things and are represented differently: 0 is a finding, `null` means we have not earned the figure yet. Worked examples are desk-only and are stripped from anonymous responses, with the count of what was withheld reported rather than silently omitted. Cached 5 minutes at the edge.'
      parameters: []
      responses:
        '200':
          description: Partner gravity report
          content:
            application/json:
              schema:
                type: object
                properties:
                  as_of:
                    type: string
                    format: date-time
                  tier:
                    type: string
                    enum:
                    - public
                    - desk
                  evidence_withheld:
                    type: integer
                    description: Worked examples removed from this response.
                  denominator_rule:
                    type: string
                  partners:
                    type: object
                    description: 'One block per partner: fetch, virtuals, olas, x402, wallets_7702, circle, bankr.'
                    additionalProperties:
                      type: object
                      properties:
                        attempted:
                          type: integer
                          description: Identities we ingested and ran the qualifier on. The denominator for every rate in this block.
                        declared_a_wallet:
                          type: integer
                        distinct_wallets:
                          type: integer
                          description: Distinct addresses behind those declarations. Lower than declared_a_wallet wherever operators reuse one wallet across many identities.
                        on_shared_wallet:
                          type: integer
                          description: Identities declaring a wallet another identity in the same catalog also declares. Excluded from `bound`.
                        bound:
                          type: integer
                          description: Identities bound to a sole-declarant wallet.
                        bind_rate:
                          type:
                          - number
                          - 'null'
                        qualified:
                          type: integer
                          description: Bound wallets we have actually read on-chain.
                        moved_usdc:
                          type: integer
                          description: Qualified wallets that sent USDC to a different address after the identity existed. NOT L7.
                        had_history_before_launch:
                          type: integer
                          description: Wallets whose USDC history predates their identity. That history is excluded from every figure here.
                        l7:
                          type:
                          - integer
                          - 'null'
                          description: Null where withheld; see l7_blocker.
                        l7_blocker:
                          type: string
                        blocker:
                          type: string
                          description: Present when a whole partner block is empty because we have measured nothing.
                        caveats:
                          type: array
                          items:
                            type: string
        '503':
          description: The collector's partner document could not be read or did not verify. No substitute value is served.
      security: []
      tags:
      - Partners
    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