{"openapi":"3.1.0","info":{"title":"StableFinance","description":"Pay-per-request access to Financial Datasets AI: US equities fundamentals, prices, SEC filings, 13F, insider trades, KPIs, and central-bank rates. No auth, no subscriptions.","version":"0.1.0","x-guidance":"# StableFinance API\n\nStableFinance wraps the Financial Datasets AI API (US equities fundamentals,\nprices, SEC filings, 13F, insider trades, central-bank rates) with x402\nand MPP pay-per-request access. No Financial Datasets account required.\n\nBase URL: https://stablefinance.dev\n\nAll data endpoints cost $0.02 per successful call. US stocks only — no crypto,\noptions, FX, or international equities. Identifier rule: most company-scoped\nendpoints accept `ticker` OR `cik` (mutually exclusive); 13F accepts\n`ticker` OR `filer_cik`.\n\n## Happy Paths\n\n### Fundamental analysis on a single company\n1. GET /api/company/facts?ticker=AAPL — metadata (sector, industry, CIK).\n2. GET /api/financials?ticker=AAPL&period=annual&limit=5 — income, balance,\n   cash flow.\n3. GET /api/financial-metrics/snapshot?ticker=AAPL — live ratios, market cap.\n4. GET /api/earnings?ticker=AAPL&limit=4 — recent quarterly results.\n\n### Stock screener -> drilldown\n1. POST /api/financials/search/screener — filter by fundamental criteria\n   (gross_margin, revenue_growth, sector, etc.).\n2. For each result: GET /api/prices/snapshot?ticker=... and\n   GET /api/financial-metrics?ticker=...&period=ttm&limit=1.\n\n### Cross-ticker line-item compare\nPOST /api/financials/search/line-items with\n{ line_items: [\"revenue\",\"free_cash_flow\"], tickers: [\"AAPL\",\"MSFT\",\"GOOGL\"],\nperiod: \"ttm\", limit: 4 }.\n\n### SEC filing research\n1. GET /api/filings?ticker=AAPL&filing_type=10-K&limit=3\n2. GET /api/filings/items?ticker=AAPL&filing_type=10-K&year=2024&item=Item-1A\n   — extracted item-level text (e.g., Risk Factors).\n\n### Insider-flow scanning\nGET /api/insider-trades?ticker=NVDA&filing_date_gte=2026-01-01&limit=200 —\nForm 4 transactions. Cross-reference with /api/prices.\n\n### 13F follow-the-money\n1. GET /api/institutional-holdings/investors?name=Berkshire — find filer CIK.\n2. GET /api/institutional-holdings?filer_cik=...&limit=200 — positions held.\n\n### Macro context\n1. GET /api/macro/interest-rates/banks — supported central banks.\n2. GET /api/macro/interest-rates/snapshot?bank=FED — current policy rate.\n\n## Conventions\n\n- **Period filters**: `report_period`, `report_period_gte/_lte/_gt/_lt`\n  on financial, metrics, and 13F endpoints.\n- **Insider trades** uses `filing_date[_gte|_lte|_gt|_lt]` instead.\n- **Identifier exclusivity**: pass exactly one of `ticker` / `cik` (or\n  `ticker` / `filer_cik` for 13F). Both omitted or both set returns 400.\n- **Pagination**: `limit` integer only; no cursors. Use date filters for\n  windowing.\n- **`/api/prices`** requires `interval` (day|week|month|year) plus\n  `start_date` and `end_date` in YYYY-MM-DD.\n\n## Do Not Use For\n\n- Crypto, options, FX, indices, or international equities — not covered.\n- Realtime tick data — `/api/prices/snapshot` is the finest granularity.\n- Historical 13F backtesting beyond ~30 years.\n","guidance":"# StableFinance API\n\nStableFinance wraps the Financial Datasets AI API (US equities fundamentals,\nprices, SEC filings, 13F, insider trades, central-bank rates) with x402\nand MPP pay-per-request access. No Financial Datasets account required.\n\nBase URL: https://stablefinance.dev\n\nAll data endpoints cost $0.02 per successful call. US stocks only — no crypto,\noptions, FX, or international equities. Identifier rule: most company-scoped\nendpoints accept `ticker` OR `cik` (mutually exclusive); 13F accepts\n`ticker` OR `filer_cik`.\n\n## Happy Paths\n\n### Fundamental analysis on a single company\n1. GET /api/company/facts?ticker=AAPL — metadata (sector, industry, CIK).\n2. GET /api/financials?ticker=AAPL&period=annual&limit=5 — income, balance,\n   cash flow.\n3. GET /api/financial-metrics/snapshot?ticker=AAPL — live ratios, market cap.\n4. GET /api/earnings?ticker=AAPL&limit=4 — recent quarterly results.\n\n### Stock screener -> drilldown\n1. POST /api/financials/search/screener — filter by fundamental criteria\n   (gross_margin, revenue_growth, sector, etc.).\n2. For each result: GET /api/prices/snapshot?ticker=... and\n   GET /api/financial-metrics?ticker=...&period=ttm&limit=1.\n\n### Cross-ticker line-item compare\nPOST /api/financials/search/line-items with\n{ line_items: [\"revenue\",\"free_cash_flow\"], tickers: [\"AAPL\",\"MSFT\",\"GOOGL\"],\nperiod: \"ttm\", limit: 4 }.\n\n### SEC filing research\n1. GET /api/filings?ticker=AAPL&filing_type=10-K&limit=3\n2. GET /api/filings/items?ticker=AAPL&filing_type=10-K&year=2024&item=Item-1A\n   — extracted item-level text (e.g., Risk Factors).\n\n### Insider-flow scanning\nGET /api/insider-trades?ticker=NVDA&filing_date_gte=2026-01-01&limit=200 —\nForm 4 transactions. Cross-reference with /api/prices.\n\n### 13F follow-the-money\n1. GET /api/institutional-holdings/investors?name=Berkshire — find filer CIK.\n2. GET /api/institutional-holdings?filer_cik=...&limit=200 — positions held.\n\n### Macro context\n1. GET /api/macro/interest-rates/banks — supported central banks.\n2. GET /api/macro/interest-rates/snapshot?bank=FED — current policy rate.\n\n## Conventions\n\n- **Period filters**: `report_period`, `report_period_gte/_lte/_gt/_lt`\n  on financial, metrics, and 13F endpoints.\n- **Insider trades** uses `filing_date[_gte|_lte|_gt|_lt]` instead.\n- **Identifier exclusivity**: pass exactly one of `ticker` / `cik` (or\n  `ticker` / `filer_cik` for 13F). Both omitted or both set returns 400.\n- **Pagination**: `limit` integer only; no cursors. Use date filters for\n  windowing.\n- **`/api/prices`** requires `interval` (day|week|month|year) plus\n  `start_date` and `end_date` in YYYY-MM-DD.\n\n## Do Not Use For\n\n- Crypto, options, FX, indices, or international equities — not covered.\n- Realtime tick data — `/api/prices/snapshot` is the finest granularity.\n- Historical 13F backtesting beyond ~30 years.\n","contact":{"name":"Merit Systems","url":"https://stablefinance.dev"}},"servers":[{"url":"https://stablefinance.dev"}],"tags":[{"name":"Company"},{"name":"Earnings"},{"name":"Filings"},{"name":"Financial Metrics"},{"name":"Financials"},{"name":"Insider Trades"},{"name":"Institutional Holdings"},{"name":"Macro"},{"name":"News"},{"name":"Prices"}],"paths":{"/api/financials":{"get":{"operationId":"financials","summary":"Income, balance sheet, and cash flow statements in one response.","tags":["Financials"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1}},{"in":"query","name":"cik","schema":{"type":"string","minLength":1}},{"in":"query","name":"period","schema":{"type":"string","enum":["annual","quarterly","ttm"]},"required":true},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":50}},{"in":"query","name":"report_period","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"financials":{"type":"object","properties":{"income_statements":{"type":"array","items":{}},"balance_sheets":{"type":"array","items":{}},"cash_flow_statements":{"type":"array","items":{}}},"required":["income_statements","balance_sheets","cash_flow_statements"],"additionalProperties":false}},"required":["financials"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/macro/interest-rates/snapshot":{"get":{"operationId":"macro_interest-rates_snapshot","summary":"Current policy rate for a single central bank.","tags":["Macro"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"bank","schema":{"type":"string","minLength":1},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"interest_rates":{"type":"array","items":{}}},"required":["interest_rates"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/macro/interest-rates/banks":{"get":{"operationId":"macro_interest-rates_banks","summary":"Supported central bank codes (FED, ECB, BOJ, etc.).","tags":["Macro"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"resource":{"type":"string"},"banks":{"type":"array","items":{"type":"string"}}},"required":["banks"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/company/facts/ciks":{"get":{"operationId":"company_facts_ciks","summary":"CIKs covered by /company/facts.","tags":["Company"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ciks":{"type":"array","items":{"type":"string"}}},"required":["ciks"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/financial-metrics/snapshot":{"get":{"operationId":"financial-metrics_snapshot","summary":"Latest live metrics including market cap and enterprise value.","tags":["Financial Metrics"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1}},{"in":"query","name":"cik","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"snapshot":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Live ratios including market_cap and enterprise_value."}},"required":["snapshot"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/news":{"get":{"operationId":"news","summary":"Recent articles. With ticker: company news. Without: market news.","tags":["News"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":10}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"news":{"type":"array","items":{}}},"required":["news"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/prices":{"get":{"operationId":"prices","summary":"Historical OHLCV bars for a US stock. Required: ticker, interval (day|week|month|year), start_date (YYYY-MM-DD), end_date (YYYY-MM-DD).","tags":["Prices"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"interval","schema":{"type":"string","enum":["day","week","month","year"]},"required":true},{"in":"query","name":"start_date","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"required":true},{"in":"query","name":"end_date","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"prices":{"type":"array","items":{},"description":"OHLCV bars: open, close, high, low, volume, time."}},"required":["ticker","prices"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/prices/tickers":{"get":{"operationId":"prices_tickers","summary":"Tickers supported by the historical /prices endpoint.","tags":["Prices"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"tickers":{"type":"array","items":{"type":"string"}}},"required":["tickers"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/prices/snapshot":{"get":{"operationId":"prices_snapshot","summary":"Real-time single-ticker price quote.","tags":["Prices"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1},"required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"snapshot":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Single ticker quote with price, day_change, day_change_percent, time."}},"required":["snapshot"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/prices/snapshot/market":{"get":{"operationId":"prices_snapshot_market","summary":"Real-time snapshots across the full covered US universe.","tags":["Prices"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"snapshots":{"type":"array","items":{},"description":"Snapshot quotes across the full US universe."}},"required":["snapshots"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/prices/snapshot/tickers":{"get":{"operationId":"prices_snapshot_tickers","summary":"Tickers supported by the snapshot endpoint.","tags":["Prices"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"tickers":{"type":"array","items":{"type":"string"}}},"required":["tickers"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/financials/income-statements":{"get":{"operationId":"financials_income-statements","summary":"Normalized income statements.","tags":["Financials"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1}},{"in":"query","name":"cik","schema":{"type":"string","minLength":1}},{"in":"query","name":"period","schema":{"type":"string","enum":["annual","quarterly","ttm"]},"required":true},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":50}},{"in":"query","name":"report_period","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"income_statements":{"type":"array","items":{}}},"required":["income_statements"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/financials/balance-sheets":{"get":{"operationId":"financials_balance-sheets","summary":"Normalized balance sheets.","tags":["Financials"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1}},{"in":"query","name":"cik","schema":{"type":"string","minLength":1}},{"in":"query","name":"period","schema":{"type":"string","enum":["annual","quarterly","ttm"]},"required":true},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":50}},{"in":"query","name":"report_period","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"balance_sheets":{"type":"array","items":{}}},"required":["balance_sheets"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/financials/cash-flow-statements":{"get":{"operationId":"financials_cash-flow-statements","summary":"Normalized cash flow statements.","tags":["Financials"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1}},{"in":"query","name":"cik","schema":{"type":"string","minLength":1}},{"in":"query","name":"period","schema":{"type":"string","enum":["annual","quarterly","ttm"]},"required":true},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":50}},{"in":"query","name":"report_period","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"cash_flow_statements":{"type":"array","items":{}}},"required":["cash_flow_statements"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/financials/segments":{"get":{"operationId":"financials_segments","summary":"All segmented financials across statements in one call.","tags":["Financials"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1}},{"in":"query","name":"cik","schema":{"type":"string","minLength":1}},{"in":"query","name":"period","schema":{"type":"string","enum":["annual","quarterly"]},"required":true},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":50}},{"in":"query","name":"report_period","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"segmented_financials":{"type":"array","items":{}}},"required":["segmented_financials"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/financials/income-statements/segments":{"get":{"operationId":"financials_income-statements_segments","summary":"Revenue, operating income, and depreciation segmented by product and reporting segment.","tags":["Financials"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1}},{"in":"query","name":"cik","schema":{"type":"string","minLength":1}},{"in":"query","name":"period","schema":{"type":"string","enum":["annual","quarterly"]},"required":true},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":50}},{"in":"query","name":"report_period","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"segmented_financials":{"type":"array","items":{}}},"required":["segmented_financials"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/financials/balance-sheets/segments":{"get":{"operationId":"financials_balance-sheets_segments","summary":"Balance sheet segment breakdowns.","tags":["Financials"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1}},{"in":"query","name":"cik","schema":{"type":"string","minLength":1}},{"in":"query","name":"period","schema":{"type":"string","enum":["annual","quarterly"]},"required":true},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":50}},{"in":"query","name":"report_period","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"segmented_financials":{"type":"array","items":{}}},"required":["segmented_financials"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/financials/cash-flow-statements/segments":{"get":{"operationId":"financials_cash-flow-statements_segments","summary":"Cash flow segment breakdowns.","tags":["Financials"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1}},{"in":"query","name":"cik","schema":{"type":"string","minLength":1}},{"in":"query","name":"period","schema":{"type":"string","enum":["annual","quarterly"]},"required":true},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":50}},{"in":"query","name":"report_period","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"segmented_financials":{"type":"array","items":{}}},"required":["segmented_financials"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/financials/search/screener":{"post":{"operationId":"financials_search_screener","summary":"Stock screener: filter companies by fundamental criteria (gross_margin, revenue_growth, sector, etc.).","tags":["Financials"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100},"filters":{"minItems":1,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1},"operator":{"type":"string","enum":["eq","gt","gte","lt","lte","in"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}]}},"required":["field","operator","value"]}}},"required":["filters"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{}}},"required":["results"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/financials/search/line-items":{"post":{"operationId":"financials_search_line-items","summary":"Pull specific line items across a list of tickers.","tags":["Financials"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"line_items":{"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"tickers":{"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"period":{"type":"string","enum":["annual","quarterly","ttm"]},"limit":{"type":"integer","minimum":1,"maximum":50}},"required":["line_items","tickers"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"search_results":{"type":"array","items":{}}},"required":["search_results"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/financial-metrics":{"get":{"operationId":"financial-metrics","summary":"Valuation, profitability, liquidity, leverage, efficiency, growth, and per-share ratios over history.","tags":["Financial Metrics"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1}},{"in":"query","name":"cik","schema":{"type":"string","minLength":1}},{"in":"query","name":"period","schema":{"type":"string","enum":["annual","quarterly","ttm"]},"required":true},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":50}},{"in":"query","name":"report_period","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"financial_metrics":{"type":"array","items":{}}},"required":["financial_metrics"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/financial-metrics/snapshot/tickers":{"get":{"operationId":"financial-metrics_snapshot_tickers","summary":"Tickers supported by the metrics snapshot endpoint.","tags":["Financial Metrics"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"tickers":{"type":"array","items":{"type":"string"}}},"required":["tickers"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/company/facts":{"get":{"operationId":"company_facts","summary":"Company metadata: name, exchange, sector, industry, SIC, location.","tags":["Company"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1}},{"in":"query","name":"cik","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"company_facts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Company metadata: name, exchange, sector, industry, SIC, location."}},"required":["company_facts"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/company/facts/tickers":{"get":{"operationId":"company_facts_tickers","summary":"Tickers covered by /company/facts.","tags":["Company"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"tickers":{"type":"array","items":{"type":"string"}}},"required":["tickers"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/filings":{"get":{"operationId":"filings","summary":"SEC filings index for a company.","tags":["Filings"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1}},{"in":"query","name":"cik","schema":{"type":"string","minLength":1}},{"in":"query","name":"filing_type","schema":{"anyOf":[{"type":"string","enum":["10-K","10-Q","8-K","20-F","6-K"]},{"type":"array","items":{"type":"string","enum":["10-K","10-Q","8-K","20-F","6-K"]}}]}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"filings":{"type":"array","items":{}}},"required":["filings"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/filings/items":{"get":{"operationId":"filings_items","summary":"Extracted item-level text from a specific filing (e.g., 10-K Item 1A Risk Factors).","tags":["Filings"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"filing_type","schema":{"type":"string","enum":["10-K","10-Q","8-K"]},"required":true},{"in":"query","name":"year","schema":{"type":"integer","minimum":1900,"maximum":2100},"required":true},{"in":"query","name":"quarter","schema":{"type":"integer","minimum":1,"maximum":4}},{"in":"query","name":"item","schema":{"type":"string","minLength":1}},{"in":"query","name":"accession_number","schema":{"type":"string","minLength":1}},{"in":"query","name":"include_exhibits","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"resource":{"type":"string"},"ticker":{"type":"string"},"cik":{"type":"string"},"filing_type":{"type":"string"},"accession_number":{"type":"string"},"year":{"type":"number"},"quarter":{"type":"number"},"items":{"type":"array","items":{}}},"required":["resource","ticker","cik","filing_type","accession_number","year","items"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/filings/tickers":{"get":{"operationId":"filings_tickers","summary":"Tickers covered by filings.","tags":["Filings"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"tickers":{"type":"array","items":{"type":"string"}}},"required":["tickers"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/filings/ciks":{"get":{"operationId":"filings_ciks","summary":"CIKs covered by filings.","tags":["Filings"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ciks":{"type":"array","items":{"type":"string"}}},"required":["ciks"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/filings/types":{"get":{"operationId":"filings_types","summary":"Valid filing_type enum values.","tags":["Filings"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"filing_types":{"type":"array","items":{"type":"string"}}},"required":["filing_types"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/filings/items/types":{"get":{"operationId":"filings_items_types","summary":"Enumerable item codes per filing type.","tags":["Filings"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"filing_type","schema":{"type":"string","enum":["10-K","10-Q","8-K","20-F","6-K"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"filing_type":{"type":"string"},"items":{"type":"array","items":{"type":"string"}}},"required":["filing_type","items"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/earnings":{"get":{"operationId":"earnings","summary":"Most-recent earnings filings for a ticker. Omit ticker for the cross-ticker feed.","tags":["Earnings"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"earnings":{"type":"array","items":{}}},"required":["earnings"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/earnings/tickers":{"get":{"operationId":"earnings_tickers","summary":"Tickers with earnings coverage.","tags":["Earnings"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"tickers":{"type":"array","items":{"type":"string"}}},"required":["tickers"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/insider-trades":{"get":{"operationId":"insider-trades","summary":"SEC Form 4 insider transactions.","tags":["Insider Trades"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":1000}},{"in":"query","name":"name","schema":{"type":"string","minLength":1}},{"in":"query","name":"transaction_type","schema":{"type":"string","minLength":1}},{"in":"query","name":"filing_date","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"filing_date_gte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"filing_date_lte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"filing_date_gt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"filing_date_lt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"insider_trades":{"type":"array","items":{}}},"required":["insider_trades"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/institutional-holdings":{"get":{"operationId":"institutional-holdings","summary":"SEC 13F positions. Pivot by held security (ticker) or by filer (filer_cik).","tags":["Institutional Holdings"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"ticker","schema":{"type":"string","minLength":1}},{"in":"query","name":"filer_cik","schema":{"type":"string","minLength":1}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":200}},{"in":"query","name":"report_period","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lte","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_gt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"report_period_lt","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"filer_cik":{"type":"string"},"institutional_holdings":{"type":"array","items":{}}},"required":["institutional_holdings"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/institutional-holdings/investors":{"get":{"operationId":"institutional-holdings_investors","summary":"Find investor (filer) CIK by name prefix.","tags":["Institutional Holdings"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"name","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"investors":{"type":"array","items":{}}},"required":["investors"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/institutional-holdings/tickers":{"get":{"operationId":"institutional-holdings_tickers","summary":"Tickers held in any 13F.","tags":["Institutional Holdings"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"tickers":{"type":"array","items":{"type":"string"}}},"required":["tickers"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}},"/api/macro/interest-rates":{"get":{"operationId":"macro_interest-rates","summary":"Historical policy rates for a central bank.","tags":["Macro"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}},{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"parameters":[{"in":"query","name":"bank","schema":{"type":"string","minLength":1},"required":true},{"in":"query","name":"start_date","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"in":"query","name":"end_date","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"interest_rates":{"type":"array","items":{}}},"required":["interest_rates"],"additionalProperties":false}}}},"402":{"description":"Payment Required"}}}}}}