Stock Market API
Stock routes expose US stock search and rankings from the KIS overseas feed and
SEC EDGAR fundamental-service resources. All operations require research and
complete synchronously.
Operations
| Method | Path | Required scope | Purpose |
|---|---|---|---|
GET | /v1/market/stocks/search | research | Search US stocks |
GET | /v1/market/stocks/rankings | research | Read US stock rankings |
GET | /v1/market/stocks/company-facts | research | Read US EDGAR company facts |
GET | /v1/market/stocks/us-financials | research | Read US financial statements |
Market selection
Routes with a market parameter accept US. Every operation uses US ticker
symbols; do not assume that similarly named report types are interchangeable.
Response shape
Stock providers expose different fields by resource. The typed
StockDataResource defines common identity fields and preserves documented
provider-specific additions. Read the operation schema and consume only fields
present in the response; absence is not zero.
Downloader, KIS, or EDGAR failure is returned as an HTTP upstream error. These endpoints do not return a fabricated empty data set when their source is unavailable.