{
  "openapi": "3.1.0",
  "info": {
    "title": "SEC Company Snapshot",
    "version": "1.0.0",
    "description": "Factual fundamentals for a US-listed company from its SEC filings. Send a stock ticker (e.g. AAPL); get company name and CIK, latest fiscal-year and latest-quarter revenue, net income and diluted EPS, balance sheet (cash, total assets, liabilities, equity, long-term debt), shares outstanding, and links to recent 10-K/10-Q/8-K filings, all cited to SEC EDGAR. No opinions or buy/sell ratings.",
    "x-guidance": "POST /company with JSON {\"ticker\": \"AAPL\"} (or GET /company?ticker=AAPL) to get a factual SEC-sourced fundamentals snapshot: latest fiscal-year and quarter revenue, net income, diluted EPS, balance sheet, shares outstanding and recent filing links with citations. $0.02 USDC on Base via x402. Unknown tickers and invalid input are rejected before payment is settled. A free example for AAPL is at GET /sample."
  },
  "servers": [
    {
      "url": "https://sec-company-snapshot.mick8511.workers.dev"
    }
  ],
  "paths": {
    "/sample": {
      "get": {
        "operationId": "sampleCompanySnapshot",
        "summary": "Free cached example snapshot (AAPL); no payment",
        "tags": [
          "Finance",
          "SEC"
        ],
        "responses": {
          "200": {
            "description": "Example snapshot"
          }
        }
      }
    },
    "/company": {
      "post": {
        "operationId": "companySnapshot",
        "summary": "SEC fundamentals snapshot for a US-listed company",
        "tags": [
          "Finance",
          "SEC"
        ],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.020000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ticker": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 8,
                    "description": "US stock ticker, e.g. AAPL or BRK.B"
                  }
                },
                "required": [
                  "ticker"
                ]
              },
              "example": {
                "ticker": "AAPL"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Company snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ticker": {
                      "type": "string"
                    },
                    "company": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "cik": {
                      "type": "string"
                    },
                    "latest_fiscal_year": {
                      "type": "object"
                    },
                    "latest_quarter": {
                      "type": "object"
                    },
                    "balance_sheet": {
                      "type": "object"
                    },
                    "shares_outstanding": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "recent_filings": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "form": {
                            "type": "string"
                          },
                          "filed": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "citations": {
                      "type": "object"
                    },
                    "disclaimer": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "ticker",
                    "cik",
                    "latest_fiscal_year",
                    "balance_sheet"
                  ]
                },
                "example": {
                  "ticker": "AAPL",
                  "company": "Apple Inc.",
                  "cik": "0000320193",
                  "latest_fiscal_year": {
                    "period_end": "2025-09-27",
                    "fiscal_year": 2025,
                    "revenue": 416161000000,
                    "net_income": 112010000000,
                    "eps_diluted": 7.46
                  },
                  "latest_quarter": {
                    "period_end": "2026-06-27",
                    "revenue": 109417000000,
                    "net_income": 29789000000,
                    "eps_diluted": 2.02
                  },
                  "balance_sheet": {
                    "as_of": "2026-06-27",
                    "cash_and_equivalents": 39544000000,
                    "total_assets": 383266000000,
                    "total_liabilities": 275746000000,
                    "stockholders_equity": 107520000000,
                    "long_term_debt": 71340000000
                  },
                  "recent_filings": [
                    {
                      "form": "10-Q",
                      "filed": "2026-07-31",
                      "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000020/0000320193-26-000020-index.htm"
                    }
                  ],
                  "disclaimer": "Figures are as reported in SEC XBRL filings and may be restated later. Companies tag line items differently, so some fields can be missing. Factual data only; not investment advice."
                }
              }
            }
          },
          "402": {
            "description": "Payment Required (x402 v2 challenge in the PAYMENT-REQUIRED header)"
          }
        }
      },
      "get": {
        "operationId": "companySnapshotGet",
        "summary": "SEC fundamentals snapshot for a US-listed company",
        "tags": [
          "Finance",
          "SEC"
        ],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.020000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "parameters": [
          {
            "name": "ticker",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "US stock ticker, e.g. AAPL or BRK.B"
          }
        ],
        "responses": {
          "200": {
            "description": "Company snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ticker": {
                      "type": "string"
                    },
                    "company": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "cik": {
                      "type": "string"
                    },
                    "latest_fiscal_year": {
                      "type": "object"
                    },
                    "latest_quarter": {
                      "type": "object"
                    },
                    "balance_sheet": {
                      "type": "object"
                    },
                    "shares_outstanding": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "recent_filings": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "form": {
                            "type": "string"
                          },
                          "filed": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "citations": {
                      "type": "object"
                    },
                    "disclaimer": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "ticker",
                    "cik",
                    "latest_fiscal_year",
                    "balance_sheet"
                  ]
                },
                "example": {
                  "ticker": "AAPL",
                  "company": "Apple Inc.",
                  "cik": "0000320193",
                  "latest_fiscal_year": {
                    "period_end": "2025-09-27",
                    "fiscal_year": 2025,
                    "revenue": 416161000000,
                    "net_income": 112010000000,
                    "eps_diluted": 7.46
                  },
                  "latest_quarter": {
                    "period_end": "2026-06-27",
                    "revenue": 109417000000,
                    "net_income": 29789000000,
                    "eps_diluted": 2.02
                  },
                  "balance_sheet": {
                    "as_of": "2026-06-27",
                    "cash_and_equivalents": 39544000000,
                    "total_assets": 383266000000,
                    "total_liabilities": 275746000000,
                    "stockholders_equity": 107520000000,
                    "long_term_debt": 71340000000
                  },
                  "recent_filings": [
                    {
                      "form": "10-Q",
                      "filed": "2026-07-31",
                      "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000020/0000320193-26-000020-index.htm"
                    }
                  ],
                  "disclaimer": "Figures are as reported in SEC XBRL filings and may be restated later. Companies tag line items differently, so some fields can be missing. Factual data only; not investment advice."
                }
              }
            }
          },
          "402": {
            "description": "Payment Required (x402 v2 challenge in the PAYMENT-REQUIRED header)"
          }
        }
      }
    }
  }
}