Agentic Finance Graph Flags API

openapi: 3.2.0
info:
  title: Agenticfinancegraph Com Flags 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 Flags 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: Flags
paths:
  /api/flags:
    get:
      operationId: getFlags
      summary: Sourced event markers drawn over the series
      description: Timestamped markers answering 'what happened here' on the chart. Every flag carries an https source; a flag without one cannot be stored. Authoring is key-gated and not public. kind is one of launch|incident|regulation|rail|vault|market; severity is one of info|notable|major.
      responses:
        '200':
          description: All stored flags, oldest first
          content:
            application/json:
              schema:
                type: object
                properties:
                  as_of:
                    type: string
                    format: date-time
                  kinds:
                    type: array
                    items:
                      type: string
                  severities:
                    type: array
                    items:
                      type: string
                  count:
                    type: integer
                  flags:
                    type: array
                    items:
                      $ref: '#/components/schemas/Flag'
      security: []
      tags:
      - Flags
    servers:
    - url: https://agenticfinancegraph.com
components:
  schemas:
    Flag:
      type: object
      required:
      - id
      - t
      - kind
      - severity
      - title
      - source_url
      properties:
        id:
          type: string
        t:
          type: string
          format: date-time
          description: The x position on the chart
        kind:
          type: string
          enum:
          - launch
          - incident
          - regulation
          - rail
          - vault
          - market
        severity:
          type: string
          enum:
          - info
          - notable
          - major
        title:
          type: string
          maxLength: 60
        body:
          type:
          - string
          - 'null'
          maxLength: 400
        source_url:
          type: string
          format: uri
          description: Required https URL. No flag exists without a source.
        producer:
          type: string
        metrics:
          type: array
          items:
            type: string
          description: Which series the event is about
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