> ## Documentation Index
> Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SEC API Volatility Score

> Learn how the SEC API Volatility Score is calculated from filing signals and how to use it in your own analysis.

## Methodology

* disclosure intensity from recent high-signal filings
* insider imbalance from recent Forms 4 and 5
* risk-factor intensity from Item 1A language
* filing recency as a simple proxy for current information flow
* stale after `45` days without a fresh primary-source filing in the signal cohort

## Quality controls

* methodology version is returned in every payload
* confidence drops when SEC API has to fall back because recent filings, insider data, or risk-factor extraction are unavailable
* degraded reasons are surfaced explicitly instead of pretending the score is full-confidence

## Output

* score on a `0-100` scale
* band: `low`, `moderate`, `elevated`, or `high`
* confidence: `high`, `medium`, or `low`
* factor-level breakdown with weights and explanations
* freshness metadata, degraded reasons, and provenance

## Example

```bash theme={null}
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/signals/volatility?ticker=AAPL"
```