{
  "openapi": "3.1.0",
  "info": {
    "title": "ToolMint Corp Intel",
    "version": "0.1.0",
    "description": "SEC EDGAR + Federal Register company brief. Pay-per-call USDC on Base via x402. Unknown/ambiguous tickers return 404/422 (no charge).",
    "contact": {
      "email": "toolmint.dev@gmail.com"
    }
  },
  "servers": [
    {
      "url": "https://toolmint-corp-intel.toolmint.workers.dev"
    }
  ],
  "paths": {
    "/": {
      "get": {
        "summary": "Catalog",
        "responses": {
          "200": {
            "description": "Tool catalog JSON"
          }
        }
      }
    },
    "/health": {
      "get": {
        "summary": "Liveness",
        "responses": {
          "200": {
            "description": "ok"
          }
        }
      }
    },
    "/brief": {
      "get": {
        "summary": "Company brief",
        "operationId": "corpIntelBrief",
        "description": "x402 Exact USDC on Base ($0.05). payTo 0xfbF7413bcB3a604936775C96FDbe0b0C9c9E37F5. Network eip155:8453.",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.050000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ],
          "network": "eip155:8453",
          "payTo": "0xfbF7413bcB3a604936775C96FDbe0b0C9c9E37F5",
          "asset": "USDC",
          "scheme": "exact",
          "amountAtomic": "50000"
        },
        "parameters": [
          {
            "name": "ticker",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "examples": [
                "AAPL",
                "MSFT"
              ]
            }
          },
          {
            "name": "filings",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 10,
              "minimum": 1,
              "maximum": 25
            }
          },
          {
            "name": "fr",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 5,
              "minimum": 0,
              "maximum": 15
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Brief",
            "content": {
              "application/json": {
                "example": {
                  "tool": "corp-intel-brief",
                  "version": "0.1.0",
                  "query": "AAPL",
                  "company": {
                    "ticker": "AAPL",
                    "name": "Apple Inc.",
                    "cik": "0000320193",
                    "exchanges": [
                      "Nasdaq"
                    ],
                    "sic": "3571",
                    "sicDescription": "Electronic Computers"
                  },
                  "filings": [
                    {
                      "form": "10-K",
                      "filingDate": "2025-11-01",
                      "accessionNumber": "0000320193-25-000001",
                      "documentUrl": "https://www.sec.gov/Archives/edgar/data/320193/..."
                    }
                  ],
                  "federalRegister": {
                    "count": 3,
                    "matchedOn": "\"Apple Inc\"",
                    "results": [
                      {
                        "title": "Example FR document",
                        "documentNumber": "2025-00001",
                        "publicationDate": "2025-06-01",
                        "agencies": [
                          "Securities and Exchange Commission"
                        ]
                      }
                    ]
                  },
                  "notAdvice": "Public filings index only; not investment advice",
                  "cached": false,
                  "sourceFetchedAt": {
                    "secTickers": "2026-10-31T16:00:00.000Z",
                    "secSubmissions": "2026-10-31T16:00:01.000Z",
                    "federalRegister": "2026-10-31T16:00:02.000Z"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid ticker or non-integer filings/fr (no charge)"
          },
          "402": {
            "description": "Payment required (x402)"
          },
          "404": {
            "description": "Ticker/CIK not found (no charge)"
          },
          "422": {
            "description": "Ambiguous name; matches listed (no charge)"
          },
          "502": {
            "description": "Upstream unavailable (no charge)"
          }
        }
      }
    },
    "/brief/{ticker}": {
      "get": {
        "summary": "Company brief by path",
        "operationId": "corpIntelBriefByTicker",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.050000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ],
          "network": "eip155:8453",
          "payTo": "0xfbF7413bcB3a604936775C96FDbe0b0C9c9E37F5",
          "asset": "USDC",
          "scheme": "exact",
          "amountAtomic": "50000"
        },
        "parameters": [
          {
            "name": "ticker",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 100
            }
          },
          {
            "name": "filings",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 10,
              "minimum": 1,
              "maximum": 25
            }
          },
          {
            "name": "fr",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 5,
              "minimum": 0,
              "maximum": 15
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Brief"
          },
          "400": {
            "description": "Invalid ticker or non-integer filings/fr (no charge)"
          },
          "402": {
            "description": "Payment required"
          },
          "404": {
            "description": "Not found (no charge)"
          },
          "422": {
            "description": "Ambiguous (no charge)"
          },
          "502": {
            "description": "Upstream unavailable (no charge)"
          }
        }
      }
    }
  }
}