{"openapi":"3.1.0","info":{"title":"SEC 8-K Alerts","version":"1.0.0","description":"Real-time material-event alerts from SEC 8-K filings (bankruptcy, restatement, cybersecurity incident, delisting, debt acceleration, impairment, auditor change, executive departure) with stock ticker, sold per alert over x402 for $0.02 USDC on Base. Free index shows event type and severity; the paid call reveals the company and adds a plain-English summary with key facts from the filing."},"servers":[{"url":"https://sec-filings-x402-production.up.railway.app"}],"components":{"schemas":{"Filing":{"type":"object","properties":{"summary":{"type":"string","description":"One plain-English sentence on what happened, e.g. \"GoPro, Inc. (GPRO) says its CFO is leaving that role.\""},"ticker":{"type":["string","null"],"description":"Primary stock ticker, e.g. GPRO (null if not listed)"},"exchange":{"type":["string","null"],"description":"Exchange of the primary ticker, e.g. Nasdaq, NYSE"},"allTickers":{"type":"array","items":{"type":"string"},"description":"All tickers for the company"},"companyTitle":{"type":"string"},"cik":{"type":"string","description":"SEC Central Index Key, 10 digits"},"severity":{"type":"string","enum":["critical","high","medium"]},"events":{"type":"array","items":{"type":"object","properties":{"item":{"type":"string","description":"8-K item number, e.g. 1.03"},"event":{"type":"string"},"severity":{"type":"string","enum":["critical","high","medium"]}}}},"filingLink":{"type":"string","description":"SEC EDGAR filing index URL"},"formType":{"type":"string"},"accessionNumber":{"type":"string"},"filedAt":{"type":"string","description":"Filing time (ISO 8601)"},"detectedAt":{"type":"string","description":"When this service saw it (ISO 8601)"},"keyFacts":{"type":"array","description":"Opening sentences of each reported Item, quoted from the filing (who, what, when)","items":{"type":"object","properties":{"item":{"type":"string"},"text":{"type":"string"}}}}},"required":["summary","ticker","companyTitle","cik","severity","events","filingLink","accessionNumber","filedAt"]}}},"paths":{"/filings":{"get":{"summary":"Free index of current alerts (no company identity)","parameters":[{"name":"severity","in":"query","schema":{"type":"string","enum":["medium","high","critical"]},"description":"Minimum severity"},{"name":"item","in":"query","schema":{"type":"string"},"description":"Only this 8-K item, e.g. 1.03"},{"name":"since","in":"query","schema":{"type":"string","format":"date-time"},"description":"Only filings after this time"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500}}],"responses":{"200":{"description":"Alert index","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/filings/{id}":{"get":{"summary":"Paid (0.02 USDC): full alert with ticker","description":"Real-time SEC 8-K material-event alert with stock ticker and plain-English summary: ticker, company, CIK, event, severity, key facts from the filing, EDGAR link. id=latest (optional ?severity=critical) or an accession number from free GET /filings. Not charged if no match. Items: 1.03 bankruptcy, 1.05 cyber incident, 4.02 restatement, 2.04 debt acceleration, 2.06 impairment, 3.01 delisting, 4.01 auditor change, 5.02 exec departure. Checked every 10s.","x-payment-info":{"protocol":"x402","x402Version":2,"price":"0.02","currency":"USDC","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xcac9ee8e5e45e02367560d810e896b688cd8f5b2"},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"\"latest\" or an SEC accession number"},{"name":"severity","in":"query","schema":{"type":"string","enum":["medium","high","critical"]},"description":"Minimum severity"},{"name":"item","in":"query","schema":{"type":"string"},"description":"Only this 8-K item, e.g. 1.03"},{"name":"since","in":"query","schema":{"type":"string","format":"date-time"},"description":"Only filings after this time"}],"responses":{"200":{"description":"Alert","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Filing"}}}},"402":{"description":"Payment required: 0.02 USDC on eip155:8453 via x402 (see PAYMENT-REQUIRED header)."},"404":{"description":"No matching alert. The payment is not settled, so you are not charged."}}}},"/tickers/{ticker}/latest":{"get":{"summary":"Paid (0.02 USDC): latest alert for one ticker","description":"Latest SEC 8-K material-event alert for one stock ticker (e.g. TSLA): plain-English summary, event, severity, company, CIK, key facts, EDGAR link. Not charged if no recent alert. Items: 1.03 bankruptcy, 1.05 cyber incident, 4.02 restatement, 2.04 debt acceleration, 2.06 impairment, 3.01 delisting, 4.01 auditor change, 5.02 exec departure. Checked every 10s.","x-payment-info":{"protocol":"x402","x402Version":2,"price":"0.02","currency":"USDC","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xcac9ee8e5e45e02367560d810e896b688cd8f5b2"},"parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string"},"description":"Stock ticker, e.g. TSLA"},{"name":"severity","in":"query","schema":{"type":"string","enum":["medium","high","critical"]},"description":"Minimum severity"},{"name":"item","in":"query","schema":{"type":"string"},"description":"Only this 8-K item, e.g. 1.03"},{"name":"since","in":"query","schema":{"type":"string","format":"date-time"},"description":"Only filings after this time"}],"responses":{"200":{"description":"Alert","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Filing"}}}},"400":{"description":"Placeholder instead of a ticker; not charged."},"402":{"description":"Payment required: 0.02 USDC on eip155:8453 via x402 (see PAYMENT-REQUIRED header)."},"404":{"description":"No matching alert. The payment is not settled, so you are not charged."}}}},"/health":{"get":{"summary":"Service status","responses":{"200":{"description":"Status"}}}}}}