{"version":1,"resources":["https://stablefinance.dev/api/company/facts/ciks","https://stablefinance.dev/api/financial-metrics/snapshot","https://stablefinance.dev/api/news","https://stablefinance.dev/api/prices","https://stablefinance.dev/api/prices/tickers","https://stablefinance.dev/api/prices/snapshot","https://stablefinance.dev/api/prices/snapshot/market","https://stablefinance.dev/api/prices/snapshot/tickers","https://stablefinance.dev/api/financials","https://stablefinance.dev/api/financials/income-statements","https://stablefinance.dev/api/financials/balance-sheets","https://stablefinance.dev/api/financials/cash-flow-statements","https://stablefinance.dev/api/financials/segments","https://stablefinance.dev/api/financials/income-statements/segments","https://stablefinance.dev/api/financials/balance-sheets/segments","https://stablefinance.dev/api/financials/cash-flow-statements/segments","https://stablefinance.dev/api/financials/search/screener","https://stablefinance.dev/api/financials/search/line-items","https://stablefinance.dev/api/financial-metrics","https://stablefinance.dev/api/financial-metrics/snapshot/tickers","https://stablefinance.dev/api/company/facts","https://stablefinance.dev/api/company/facts/tickers","https://stablefinance.dev/api/filings","https://stablefinance.dev/api/filings/items","https://stablefinance.dev/api/filings/tickers","https://stablefinance.dev/api/filings/ciks","https://stablefinance.dev/api/filings/types","https://stablefinance.dev/api/filings/items/types","https://stablefinance.dev/api/earnings","https://stablefinance.dev/api/earnings/tickers","https://stablefinance.dev/api/insider-trades","https://stablefinance.dev/api/institutional-holdings","https://stablefinance.dev/api/institutional-holdings/investors","https://stablefinance.dev/api/institutional-holdings/tickers","https://stablefinance.dev/api/macro/interest-rates","https://stablefinance.dev/api/macro/interest-rates/snapshot","https://stablefinance.dev/api/macro/interest-rates/banks"],"mppResources":["https://stablefinance.dev/api/company/facts/ciks","https://stablefinance.dev/api/financial-metrics/snapshot","https://stablefinance.dev/api/news","https://stablefinance.dev/api/prices","https://stablefinance.dev/api/prices/tickers","https://stablefinance.dev/api/prices/snapshot","https://stablefinance.dev/api/prices/snapshot/market","https://stablefinance.dev/api/prices/snapshot/tickers","https://stablefinance.dev/api/financials","https://stablefinance.dev/api/financials/income-statements","https://stablefinance.dev/api/financials/balance-sheets","https://stablefinance.dev/api/financials/cash-flow-statements","https://stablefinance.dev/api/financials/segments","https://stablefinance.dev/api/financials/income-statements/segments","https://stablefinance.dev/api/financials/balance-sheets/segments","https://stablefinance.dev/api/financials/cash-flow-statements/segments","https://stablefinance.dev/api/financials/search/screener","https://stablefinance.dev/api/financials/search/line-items","https://stablefinance.dev/api/financial-metrics","https://stablefinance.dev/api/financial-metrics/snapshot/tickers","https://stablefinance.dev/api/company/facts","https://stablefinance.dev/api/company/facts/tickers","https://stablefinance.dev/api/filings","https://stablefinance.dev/api/filings/items","https://stablefinance.dev/api/filings/tickers","https://stablefinance.dev/api/filings/ciks","https://stablefinance.dev/api/filings/types","https://stablefinance.dev/api/filings/items/types","https://stablefinance.dev/api/earnings","https://stablefinance.dev/api/earnings/tickers","https://stablefinance.dev/api/insider-trades","https://stablefinance.dev/api/institutional-holdings","https://stablefinance.dev/api/institutional-holdings/investors","https://stablefinance.dev/api/institutional-holdings/tickers","https://stablefinance.dev/api/macro/interest-rates","https://stablefinance.dev/api/macro/interest-rates/snapshot","https://stablefinance.dev/api/macro/interest-rates/banks"],"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.","instructions":"# 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"}