# Studying Stocks API

> Standardized company financials from SEC EDGAR filings and a free cash flow valuation, over a REST API with an API key. Every docs page is also available as Markdown by adding .md to its URL.

The API is read-only JSON under https://studyingstocks.com/api/v1 (API version: v1). Authenticate with the X-Api-Key header. Start with the skill file if you are an AI agent.

## Get started

- [Overview](https://studyingstocks.com/developers.md): What the API offers, what it costs and where to start.
- [Pricing](https://studyingstocks.com/developers/pricing.md): One plan, API access included, and the limits that come with it.
- [Quickstart](https://studyingstocks.com/developers/quickstart.md): From API key to first request in two minutes.
- [Authentication](https://studyingstocks.com/developers/authentication.md): Send your API key in the X-Api-Key header.
- [Rate limits](https://studyingstocks.com/developers/rate-limits.md): Limits per key, the headers that report them, and what to do on 429.
- [Errors](https://studyingstocks.com/developers/errors.md): The error format and every error code.
- [Changelog](https://studyingstocks.com/developers/changelog.md): Every change to the API, with its date.

## Guides

- [Periods and fiscal calendars](https://studyingstocks.com/developers/periods.md): How periods, fiscal years and TTM values work.
- [Line items and definitions](https://studyingstocks.com/developers/line-items.md): Every line item, its unit and where it comes from.
- [Restatements](https://studyingstocks.com/developers/restatements.md): How revised values are tracked and how to read them.
- [Valuation methodology](https://studyingstocks.com/developers/valuation-methodology.md): How the discounted cash flow valuation is calculated (methodology version 1).
- [Using the API from AI agents](https://studyingstocks.com/developers/ai-agents.md): llms.txt, Markdown docs, the OpenAPI document and the agent skill file.
- [Agent skill](https://studyingstocks.com/developers/skill.md): A guide for AI agents: how to call the API, which endpoint to use, periods and errors.

## API reference

- [Interactive reference](https://studyingstocks.com/developers/reference.md): Try every endpoint in the browser, rendered from the OpenAPI document.
- [Companies](https://studyingstocks.com/developers/companies.md): List companies
- [Company profile](https://studyingstocks.com/developers/company-profile.md): Company profile
- [Financials](https://studyingstocks.com/developers/financials.md): Financials
- [Revisions](https://studyingstocks.com/developers/revisions.md): Revisions
- [Valuation](https://studyingstocks.com/developers/valuation.md): Valuation
- [Status](https://studyingstocks.com/developers/status.md): Status

## Machine-readable

- [OpenAPI 3.1 specification](https://studyingstocks.com/api/v1/openapi.json): every endpoint, parameter and response schema
- [All docs in one file](https://studyingstocks.com/llms-full.txt): the full text of every page above