{"description":"US market capitalisation computed from SEC/EDGAR filings: share counts per class from XBRL, multiplied by that class's price and summed.","endpoints":[{"method":"GET","path":"/edgar/shares","source":"edgar","description":"shares outstanding for one ticker, per class","example":"/edgar/shares?ticker=GOOGL\u0026date=2026-06-30"},{"method":"GET","path":"/edgar/share-history","source":"edgar","description":"every share count the SEC actually filed for one ticker, per class, oldest first","example":"/edgar/share-history?ticker=BRK.B"},{"method":"GET","path":"/edgar/share-split-history","source":"edgar","description":"every stock split on record for one ticker, per class where the issuer filed it that way","example":"/edgar/share-split-history?ticker=AAPL"},{"method":"GET","path":"/edgar/share-count-and-split-history","source":"edgar","description":"the two histories above merged into one date-ordered list per share class","example":"/edgar/share-count-and-split-history?ticker=BRK.B"},{"method":"GET","path":"/edgar/companies/{ticker}","source":"edgar","description":"registrant, share classes and share-series metadata","example":"/edgar/companies/AAPL"},{"method":"GET","path":"/","source":"operational","description":"this index: every endpoint, its data source, and the accepted parameters","example":"/"},{"method":"GET","path":"/fmp/marketcap","source":"fmp","description":"Financial Modeling Prep's own market cap for one symbol, latest or on an exact date","example":"/fmp/marketcap?ticker=AAPL\u0026date=2026-08-28"},{"method":"GET","path":"/fmp/marketcap-history","source":"fmp","description":"FMP's daily market caps over a date range, oldest first, with no per-response row limit","example":"/fmp/marketcap-history?ticker=BRK.B\u0026from=2026-01-01\u0026to=2026-08-28"},{"method":"GET","path":"/fmp/coverage","source":"fmp","description":"what the local FMP cache holds for one symbol, chunk by chunk, and this run's plan usage","example":"/fmp/coverage?ticker=AAPL"},{"method":"GET","path":"/v1/marketcap","source":"edgar+prices","description":"market cap for one ticker, with a per-class breakdown","example":"/v1/marketcap?ticker=BRK.B"},{"method":"GET","path":"/v1/stats","source":"edgar+prices","description":"row counts and data freshness","example":"/v1/stats"},{"method":"GET","path":"/v1/healthz","source":"operational","description":"liveness; never touches the database","example":"/v1/healthz"},{"method":"GET","path":"/v1/readyz","source":"operational","description":"readiness; 503 when the database is unusable","example":"/v1/readyz"}],"not_implemented_yet":{"from,to":"daily historic series are rejected with 400 not_implemented on /v1/ and /edgar/; /fmp/marketcap-history serves them","note":"both parameters are parsed and validated today, so adding them changes no existing response","tickers":"multi-ticker requests are rejected with 400 not_implemented"},"parameters":{"date":"ISO date, or omit for the latest available","from,to":"inclusive ISO date bounds; served today by /fmp/marketcap-history only, where \"to\" defaults to today and \"from\" to a year earlier","method":"share-count interpolation: step, linear, damped_trend, auto (default); not accepted by /edgar/share-history, which never interpolates, nor by the two split endpoints, which have nothing to interpolate","note":"/edgar/share-split-history and /edgar/share-count-and-split-history take only \"ticker\": a list of events is not a quantity measured on a date","pit":"true restricts evidence to filings public on or before the date","ticker":"one ticker, any spelling (BRK.B, BRK-B, BRKB, brk/b)"},"service":"marketcap","url_convention":{"/":"this discovery document, and the 404 every unrouted path falls through to; it belongs to no provider group and depends on no upstream","/edgar/":"answered exclusively from SEC/EDGAR filings; no price provider is consulted, so nothing here moves when a quote source does","/fmp/":"answered exclusively from Financial Modeling Prep's own market-cap series, cached locally; no SEC filing and no price provider contributes, so a value here may legitimately differ from /v1/marketcap","/v1/":"answers no single source can give -- SEC share counts multiplied by a provider's prices, row counts across both -- plus the operational probes","note":"each vendor prefix stands or falls with that vendor alone; /tiingo/ is reserved on the same rule and has no endpoints yet"},"version":"11888c4-dirty"}