# Finance Statements API (https://www.socialcrawl.dev/platforms/finance/statements)

> Returns income-statement, balance-sheet and cash-flow line items per reporting period as a unified FinancialStatementList. Line-item names match the `financials` block inside /v1/finance/quote, so both surfaces spell `net_income` the same way. Every `_delta` leaf is the period-over-period fractional change of its line item; the earliest period has nothing to compare against and reports null rather than a fabricated zero. Four leaves have no source on this surface and are always null: `currency`, `price_to_book`, `return_on_assets` and `return_on_capital` (the last two are conventionally trailing-twelve-month ratios over averaged denominators, and a single-period substitute would be a different number wearing the same name). The oldest one or two periods can arrive carrying only their identity leaves, which is what the upstream holds for them, not a fault. IMPORTANT: rows are keyed by fiscal period END, not by filing date. This surface therefore cannot support point-in-time reconstruction, and a restatement silently replaces the original figures, so a backtest built on it carries look-ahead bias.

TL;DR: `GET /v1/finance/statements` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `keyword` | yes | Company ticker. A bare symbol ('AAPL') or the 'TICKER:EXCHANGE' form; the exchange suffix is ignored. |
| `type` | no | Reporting periodicity: annual, quarterly, or trailing. Defaults to annual. (annual \| quarterly \| trailing) |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/finance/statements" \
  --data-urlencode "keyword=AAPL" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the Finance Statements API return?

Returns income, balance sheet and cash flow line items per period, each with its period-over-period fractional change. Currency, price to book, ROA and ROIC have no source here and are always null. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.

### When should I use the Finance Statements endpoint?

Use it for fundamentals screening. Rows are keyed by fiscal period end, NOT filing date, so point-in-time reconstruction is not supported.

### How much does the Finance Statements API cost?

Each call costs 5 credits, so the 100 free credits every new account gets cover 20 calls. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the Finance Statements API need?

The one required parameter is keyword (company ticker). It also accepts 1 optional parameter, listed on this page.

### How do I call the Finance Statements API?

Send a GET request to https://www.socialcrawl.dev/v1/finance/statements?keyword=AAPL with your API key in the x-api-key header. An Authorization: Bearer header works too.

See the full Finance API: https://www.socialcrawl.dev/platforms/finance

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What does the SocialCrawl Finance Statements API return?
- How do I get Finance Statements data with the SocialCrawl API?