# Получение снимка результатов

**API:** Data API

**Endpoint:** `GET /v1/beta/financial/earnings`

**Tags:** Financial Data

Отчётные результаты по одной акции: фактические против оценок. Каждая запись содержит `report_period`, `fiscal_period`, `filing_date`, `filing_url` и `accession_number`, блок `quarterly` с `revenue`, `estimated_revenue`, `revenue_surprise` и `revenue_surprise_pct`, ту же тройку для `earnings_per_share`, а также поля годового изменения. Также возвращает `signals`: вычисленные вышестоящей системой флаги, например EPS_BEAT, с `headline` и стоящими за ним `actual` / `estimate` / `surprise_pct`. `ticker` обязателен и является единственным параметром. Используйте для того, о чём компания действительно отчиталась. Для прогнозного консенсуса, который ещё не наступил, используйте `get_financial_analyst_estimates`.

### Справочная информация о ценах

- Тарификация: фиксированная базовая стоимость успешного запроса.
- Справочная оценка запроса: USD 0.02.
- Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.

Только справочные метаданные, а не котировка для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `cursor` | query | no | string | Непрозрачный курсор пагинации из next_page_url предыдущего ответа. Если он указан, все остальные параметры запроса игнорируются: курсор содержит фильтры исходного запроса. Считайте его непрозрачным; не создавайте и не изменяйте его. |
| `limit` | query | no | integer, default: 1 | Количество последних **отчётных периодов**, за которые нужно вернуть документы; сортировка — по `(report_period DESC, filing_date ASC)`. Количество возвращённых записей может превышать `limit`, если в недавнем периоде есть и 8-K, и 10-Q / 10-K. Значения выше 40 ограничиваются 40. Неположительные или нецелые значения возвращают 400. Это общее количество по всем страницам, а не размер страницы: на каждой странице до 10 записей, связанных через `next_page_url`. |
| `ticker` | query | yes | string | Тикер-символ (например, `AAPL`). |

## Responses

### 200 — Ответ с результатами

Headers:
- `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo.

**application/json**

Schema: `ResponseE40Feb4D3D6B_EarningsResponse` (`#/components/schemas/ResponseE40Feb4D3D6B_EarningsResponse`)

### 400 — Запрос не удалось обработать. Проверьте параметры запроса.

### 401 — Требуется действительный API-ключ Felo.

### 402 — Запрос не может быть выполнен: не выполнено требование биллинга.

### 403 — Аккаунту не разрешено выполнять эту операцию.

### 429 — Достигнут лимит запросов или расходов.

### 502 — Сервис не смог выполнить запрос.

### 503 — API или сервис биллинга временно недоступны.

### 504 — Истекло время ожидания обработки запроса.

### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseE40Feb4D3D6B_EarningsRecord

`#/components/schemas/ResponseE40Feb4D3D6B_EarningsRecord`

```json
{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Запрошенный тикер-символ."
    },
    "report_period": {
      "type": "string",
      "format": "date",
      "description": "Отчётный период, который охватывает этот документ."
    },
    "fiscal_period": {
      "type": "string",
      "description": "Метка фискального периода (например, 2026-Q1 или 2025-FY)."
    },
    "currency": {
      "type": "string",
      "description": "Код валюты ISO (например, USD)."
    },
    "source_type": {
      "type": "string",
      "description": "Тип формы SEC, на которой основан этот документ.",
      "enum": [
        "8-K",
        "10-Q",
        "10-K",
        "20-F"
      ]
    },
    "filing_date": {
      "type": "string",
      "format": "date",
      "description": "Календарный день принятия документа SEC по восточному времени (рабочий часовой пояс SEC). Календарная пара к `filing_datetime`."
    },
    "filing_datetime": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "Временная метка с точностью меньше дня, фиксирующая момент принятия документа SEC по восточному времени. Источник — поле `acceptanceDateTime` SEC в API submissions EDGAR. Сочетается с `filing_date` (точность до календарного дня для того же события)."
    },
    "filing_window": {
      "type": [
        "string",
        "null"
      ],
      "description": "Рыночная сессия на момент принятия документа SEC, оценённая по восточному времени. PRE_MARKET = будний день 04:00–09:30 ET. DURING_MARKET = будний день 09:30–16:00 ET. AFTER_HOURS = будний день вне регулярных торговых часов. WEEKEND = суббота или воскресенье. Null, если filing_datetime недоступен.",
      "enum": [
        "PRE_MARKET",
        "DURING_MARKET",
        "AFTER_HOURS",
        "WEEKEND"
      ]
    },
    "signals": {
      "type": "array",
      "description": "Отобранные инсайты, способные повлиять на рынок, извлечённые из этого документа. Каждый элемент содержит предварительно отрендеренный `headline`, структурированные `details` и рейтинг `importance`. Возвращается, только если для этой записи сработал хотя бы один сигнал; иначе поле опускается. Не более 8 на запись, порядок HIGH → MEDIUM → LOW.",
      "items": {
        "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_Signal"
      }
    },
    "filing_url": {
      "type": "string",
      "format": "uri",
      "description": "URL документа SEC."
    },
    "accession_number": {
      "type": "string",
      "description": "Номер документа SEC, идентифицирующий отчёт."
    },
    "quarterly": {
      "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_EarningsTimeDimension"
    },
    "annual": {
      "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_EarningsTimeDimension"
    }
  },
  "required": [
    "ticker",
    "report_period",
    "source_type",
    "filing_date",
    "filing_url",
    "accession_number"
  ]
}
```

### ResponseE40Feb4D3D6B_EarningsResponse

`#/components/schemas/ResponseE40Feb4D3D6B_EarningsResponse`

```json
{
  "type": "object",
  "properties": {
    "earnings": {
      "type": "array",
      "description": "Плоский список документов SEC для тикера, отсортированный по (report_period DESC, filing_date ASC). При `limit=N` возвращается до N отчётных периодов документов; число записей может превышать N, если в недавнем периоде есть и 8-K, и 10-Q/10-K.",
      "items": {
        "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_EarningsRecord"
      }
    },
    "next_page_url": {
      "type": "string",
      "description": "Абсолютный URL следующей страницы результатов. Присутствует, только если остались результаты; запрашивайте его как есть для продолжения. На каждой странице до 10 записей."
    }
  }
}
```

### ResponseE40Feb4D3D6B_EarningsTimeDimension

`#/components/schemas/ResponseE40Feb4D3D6B_EarningsTimeDimension`

```json
{
  "type": "object",
  "properties": {
    "revenue": {
      "type": [
        "number",
        "null"
      ]
    },
    "revenue_chg": {
      "type": "number",
      "description": "Изменение выручки относительно предыдущего периода в виде десятичной дроби (например, 0.10 = +10%). В квартальном ответе — последовательное, в годовом — год к году. Возвращается, только когда его можно рассчитать."
    },
    "revenue_yoy_chg": {
      "type": "number",
      "description": "Изменение выручки год к году относительно того же фискального квартала годом ранее, в виде десятичной дроби. Только в квартальном ответе. Возвращается, только когда его можно рассчитать."
    },
    "earnings_per_share": {
      "type": [
        "number",
        "null"
      ]
    },
    "earnings_per_share_chg": {
      "type": "number",
      "description": "Изменение EPS относительно предыдущего периода в виде десятичной дроби. В квартальном ответе — последовательное, в годовом — год к году. Возвращается, только когда его можно рассчитать."
    },
    "earnings_per_share_yoy_chg": {
      "type": "number",
      "description": "Изменение EPS год к году относительно того же фискального квартала годом ранее, в виде десятичной дроби. Только в квартальном ответе. Возвращается, только когда его можно рассчитать."
    },
    "gross_profit": {
      "type": [
        "number",
        "null"
      ]
    },
    "gross_profit_chg": {
      "type": "number",
      "description": "Изменение валовой прибыли относительно предыдущего периода в виде десятичной дроби. В квартальном ответе — последовательное, в годовом — год к году. Возвращается, только когда его можно рассчитать."
    },
    "gross_profit_yoy_chg": {
      "type": "number",
      "description": "Изменение валовой прибыли год к году относительно того же фискального квартала годом ранее, в виде десятичной дроби. Только в квартальном ответе. Возвращается, только когда его можно рассчитать."
    },
    "gross_margin": {
      "type": "number",
      "description": "Валовая маржа в виде десятичной дроби (gross_profit / revenue). Возвращается, только когда её можно рассчитать."
    },
    "gross_margin_chg_bps": {
      "type": "number",
      "description": "Абсолютное изменение валовой маржи относительно предыдущего периода в базисных пунктах (например, 200.0 = рост маржи на 200 б.п.). Возвращается, только когда его можно рассчитать."
    },
    "gross_margin_chg_pct": {
      "type": "number",
      "description": "Изменение валовой маржи относительно предыдущего периода в виде десятичной дроби. Возвращается, только когда его можно рассчитать."
    },
    "gross_margin_yoy_chg_bps": {
      "type": "number",
      "description": "Изменение валовой маржи год к году относительно того же фискального квартала годом ранее, в базисных пунктах. Только в квартальном ответе. Возвращается, только когда его можно рассчитать."
    },
    "gross_margin_yoy_chg_pct": {
      "type": "number",
      "description": "Изменение валовой маржи год к году в процентах относительно того же фискального квартала годом ранее, в виде десятичной дроби. Только в квартальном ответе. Возвращается, только когда его можно рассчитать."
    },
    "operating_income": {
      "type": [
        "number",
        "null"
      ]
    },
    "operating_income_chg": {
      "type": "number",
      "description": "Изменение операционной прибыли относительно предыдущего периода в виде десятичной дроби. В квартальном ответе — последовательное, в годовом — год к году. Возвращается, только когда его можно рассчитать."
    },
    "operating_income_yoy_chg": {
      "type": "number",
      "description": "Изменение операционной прибыли год к году относительно того же фискального квартала годом ранее, в виде десятичной дроби. Только в квартальном ответе. Возвращается, только когда его можно рассчитать."
    },
    "operating_margin": {
      "type": "number",
      "description": "Операционная маржа в виде десятичной дроби (operating_income / revenue). Возвращается, только когда её можно рассчитать."
    },
    "operating_margin_chg_bps": {
      "type": "number",
      "description": "Абсолютное изменение операционной маржи относительно предыдущего периода в базисных пунктах. Возвращается, только когда его можно рассчитать."
    },
    "operating_margin_chg_pct": {
      "type": "number",
      "description": "Изменение операционной маржи относительно предыдущего периода в виде десятичной дроби. Возвращается, только когда его можно рассчитать."
    },
    "operating_margin_yoy_chg_bps": {
      "type": "number",
      "description": "Изменение операционной маржи год к году относительно того же фискального квартала годом ранее, в базисных пунктах. Только в квартальном ответе. Возвращается, только когда его можно рассчитать."
    },
    "operating_margin_yoy_chg_pct": {
      "type": "number",
      "description": "Изменение операционной маржи год к году в процентах относительно того же фискального квартала годом ранее, в виде десятичной дроби. Только в квартальном ответе. Возвращается, только когда его можно рассчитать."
    },
    "net_income": {
      "type": [
        "number",
        "null"
      ]
    },
    "net_income_chg": {
      "type": "number",
      "description": "Изменение чистой прибыли относительно предыдущего периода в виде десятичной дроби. В квартальном ответе — последовательное, в годовом — год к году. Возвращается, только когда его можно рассчитать."
    },
    "net_income_yoy_chg": {
      "type": "number",
      "description": "Изменение чистой прибыли год к году относительно того же фискального квартала годом ранее, в виде десятичной дроби. Только в квартальном ответе. Возвращается, только когда его можно рассчитать."
    },
    "net_margin": {
      "type": "number",
      "description": "Чистая маржа в виде десятичной дроби (net_income / revenue). Возвращается, только когда её можно рассчитать."
    },
    "net_margin_chg_bps": {
      "type": "number",
      "description": "Абсолютное изменение чистой маржи относительно предыдущего периода в базисных пунктах. Возвращается, только когда его можно рассчитать."
    },
    "net_margin_chg_pct": {
      "type": "number",
      "description": "Изменение чистой маржи относительно предыдущего периода в виде десятичной дроби. Возвращается, только когда его можно рассчитать."
    },
    "net_margin_yoy_chg_bps": {
      "type": "number",
      "description": "Изменение чистой маржи год к году относительно того же фискального квартала годом ранее, в базисных пунктах. Только в квартальном ответе. Возвращается, только когда его можно рассчитать."
    },
    "net_margin_yoy_chg_pct": {
      "type": "number",
      "description": "Изменение чистой маржи год к году в процентах относительно того же фискального квартала годом ранее, в виде десятичной дроби. Только в квартальном ответе. Возвращается, только когда его можно рассчитать."
    },
    "weighted_average_shares": {
      "type": [
        "number",
        "null"
      ]
    },
    "weighted_average_shares_diluted": {
      "type": [
        "number",
        "null"
      ]
    },
    "cash_and_equivalents": {
      "type": [
        "number",
        "null"
      ]
    },
    "change_in_cash_and_equivalents": {
      "type": [
        "number",
        "null"
      ]
    },
    "total_debt": {
      "type": [
        "number",
        "null"
      ]
    },
    "total_assets": {
      "type": [
        "number",
        "null"
      ]
    },
    "total_liabilities": {
      "type": [
        "number",
        "null"
      ]
    },
    "shareholders_equity": {
      "type": [
        "number",
        "null"
      ]
    },
    "net_cash_flow_from_operations": {
      "type": [
        "number",
        "null"
      ]
    },
    "net_cash_flow_from_operations_chg": {
      "type": "number",
      "description": "Изменение чистого денежного потока от операционной деятельности относительно предыдущего периода в виде десятичной дроби. В квартальном ответе — последовательное, в годовом — год к году. Возвращается, только когда его можно рассчитать."
    },
    "net_cash_flow_from_operations_yoy_chg": {
      "type": "number",
      "description": "Изменение чистого денежного потока от операционной деятельности год к году относительно того же фискального квартала годом ранее, в виде десятичной дроби. Только в квартальном ответе. Возвращается, только когда его можно рассчитать."
    },
    "net_cash_flow_from_investing": {
      "type": [
        "number",
        "null"
      ]
    },
    "net_cash_flow_from_investing_chg": {
      "type": "number",
      "description": "Изменение чистого денежного потока от инвестиционной деятельности относительно предыдущего периода в виде десятичной дроби. В квартальном ответе — последовательное, в годовом — год к году. Возвращается, только когда его можно рассчитать."
    },
    "net_cash_flow_from_investing_yoy_chg": {
      "type": "number",
      "description": "Изменение чистого денежного потока от инвестиционной деятельности год к году относительно того же фискального квартала годом ранее, в виде десятичной дроби. Только в квартальном ответе. Возвращается, только когда его можно рассчитать."
    },
    "net_cash_flow_from_financing": {
      "type": [
        "number",
        "null"
      ]
    },
    "net_cash_flow_from_financing_chg": {
      "type": "number",
      "description": "Изменение чистого денежного потока от финансовой деятельности относительно предыдущего периода в виде десятичной дроби. В квартальном ответе — последовательное, в годовом — год к году. Возвращается, только когда его можно рассчитать."
    },
    "net_cash_flow_from_financing_yoy_chg": {
      "type": "number",
      "description": "Изменение чистого денежного потока от финансовой деятельности год к году относительно того же фискального квартала годом ранее, в виде десятичной дроби. Только в квартальном ответе. Возвращается, только когда его можно рассчитать."
    },
    "capital_expenditure": {
      "type": [
        "number",
        "null"
      ]
    },
    "capital_expenditure_chg": {
      "type": "number",
      "description": "Изменение капитальных затрат относительно предыдущего периода в виде десятичной дроби. В квартальном ответе — последовательное, в годовом — год к году. Возвращается, только когда его можно рассчитать."
    },
    "capital_expenditure_yoy_chg": {
      "type": "number",
      "description": "Изменение капитальных затрат год к году относительно того же фискального квартала годом ранее, в виде десятичной дроби. Только в квартальном ответе. Возвращается, только когда его можно рассчитать."
    },
    "free_cash_flow": {
      "type": [
        "number",
        "null"
      ]
    },
    "free_cash_flow_chg": {
      "type": "number",
      "description": "Изменение свободного денежного потока относительно предыдущего периода в виде десятичной дроби. В квартальном ответе — последовательное, в годовом — год к году. Возвращается, только когда его можно рассчитать."
    },
    "free_cash_flow_yoy_chg": {
      "type": "number",
      "description": "Изменение свободного денежного потока год к году относительно того же фискального квартала годом ранее, в виде десятичной дроби. Только в квартальном ответе. Возвращается, только когда его можно рассчитать."
    }
  }
}
```

### ResponseE40Feb4D3D6B_Signal

`#/components/schemas/ResponseE40Feb4D3D6B_Signal`

```json
{
  "type": "object",
  "description": "Отобранный инсайт, способный повлиять на рынок, полученный из этого документа. Предварительно отрендеренный `headline` подходит для прямого отображения; `details` содержит структурированные поля для фильтрации и программного использования. Сигналы возвращаются в порядке приоритета (сначала самые значимые); сам `type` кодирует масштаб (например, `STRONG_REVENUE_INCREASE` против `REVENUE_INCREASE`).",
  "required": [
    "type",
    "headline"
  ],
  "properties": {
    "type": {
      "type": "string",
      "description": "Категория сигнала. MARGIN_EXPANSION/MARGIN_CONTRACTION: любая из валовой/операционной/чистой маржи изменилась год к году на ≥100 б.п. GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED: изменение прогноза на будущее, отражённое в документе. SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: лучший или худший отчётный сегмент по росту органической выручки. NON_GAAP_DIVERGENCE: скорректированный/non-GAAP показатель существенно отличается от своего аналога GAAP за тот же период. BACKLOG_SURGE/BACKLOG_DECLINE: портфель заказов или оставшиеся обязательства по исполнению изменились год к году на ≥20%. REVENUE_INCREASE/STRONG_REVENUE_INCREASE и варианты DECLINE: ступенчатое изменение выручки год к году (масштаб ≥10% / ≥20%). NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE и варианты DECLINE: ступенчатое изменение чистой прибыли год к году (≥15% / ≥30%). EPS_INCREASE/STRONG_EPS_INCREASE и варианты DECLINE: ступенчатое изменение EPS год к году (≥15% / ≥30%); независимо от чистой прибыли, поскольку обратный выкуп акций может усиливать движение EPS. CAPEX_INCREASE/STRONG_CAPEX_INCREASE и варианты DECLINE: ступенчатое изменение капитальных затрат год к году по масштабу расходов (≥15% / ≥30%).",
      "enum": [
        "MARGIN_EXPANSION",
        "MARGIN_CONTRACTION",
        "GUIDANCE_RAISED",
        "GUIDANCE_LOWERED",
        "GUIDANCE_REAFFIRMED",
        "GUIDANCE_INITIATED",
        "SEGMENT_OUTPERFORMANCE",
        "SEGMENT_UNDERPERFORMANCE",
        "NON_GAAP_DIVERGENCE",
        "BACKLOG_SURGE",
        "BACKLOG_DECLINE",
        "REVENUE_INCREASE",
        "REVENUE_DECLINE",
        "STRONG_REVENUE_INCREASE",
        "STRONG_REVENUE_DECLINE",
        "NET_INCOME_INCREASE",
        "NET_INCOME_DECLINE",
        "STRONG_NET_INCOME_INCREASE",
        "STRONG_NET_INCOME_DECLINE",
        "EPS_INCREASE",
        "EPS_DECLINE",
        "STRONG_EPS_INCREASE",
        "STRONG_EPS_DECLINE",
        "CAPEX_INCREASE",
        "CAPEX_DECLINE",
        "STRONG_CAPEX_INCREASE",
        "STRONG_CAPEX_DECLINE"
      ]
    },
    "metric": {
      "type": [
        "string",
        "null"
      ],
      "description": "Показатель, на который ссылается этот сигнал, если применимо (например, `revenue`, `earnings_per_share`, `operating_margin` или название показателя прогноза/KPI)."
    },
    "period": {
      "type": [
        "string",
        "null"
      ],
      "description": "Фискальный период, на который ссылается сигнал (например, `2026-Q1`, `FY 2026`). Сигналы прогноза ссылаются на прогнозируемый период; финансовые сигналы ссылаются на отчётный период этого документа."
    },
    "headline": {
      "type": "string",
      "description": "Предварительно отрендеренная, понятная человеку сводка, подходящая для прямого отображения."
    },
    "details": {
      "type": "object",
      "description": "Структурированные поля, специфичные для типа сигнала. Содержимое варьируется: сигналы прогноза содержат `low`, `high`, `point_estimate`, `prior_value`, `revision_pct`; сегментные сигналы — `best`, `worst`, `spread_pp`; сигналы non-GAAP — `gaap_field`, `non_gaap_value`, `gaap_value`, `divergence_pct`; сигналы роста — `current`, `yoy_chg`. Значения null опускаются. См. примеры для конкретных типов.",
      "additionalProperties": true
    }
  }
}
```