API фундаментальных показателей компаний: баланс, денежный поток и сделки инсайдеров для финансовых агентов

Цены говорят, что думает рынок; фундаментал говорит, прав ли он. Вот API фундаментальных показателей, сформированный под AI-агентов — отчётность, дивиденды и сделки инсайдеров в одном эндпоинте — и как он сравнивается с сырым SEC EDGAR и поставщиками API отчётности.
Кратко
- •Фундаментал = слой «а бизнес-то реально здоров»: баланс, отчёт о прибылях и убытках, движение денежных средств, дивиденды, сделки инсайдеров.
- •Можно парсить бесплатно из SEC EDGAR (XBRL), но нормализация XBRL по разным заявителям и периодам — это реальная непрерывная инженерия — и это только США и в ритме отчётности, а не в формате запроса.
- •API Pick Financials Search возвращает все пять фундаментальных показателей компаний США за одним POST-эндпоинтом — 200 кредитов/вызов, только за успех — заранее подготовлено под рассуждение LLM.
- •Сделки инсайдеров (Form 4) и история дивидендов — недооценённые сигналы: дёшево подтянуть здесь, мучительно собирать из EDGAR.
- •Сочетайте Financials с SEC Filings (качественный текст 10-K/10-Q) и Markets (цена) для полной заземлённой картины.
Цена — это мнение; фундаментал — это доказательства
Вызов рыночных данных говорит вашему агенту, сколько стоит акция. Он не может сказать, растёт ли бизнес за ней, тонет ли он в долгах или его тихо распродают собственные руководители. Это слой фундаментала — и именно здесь исследовательский агент переходит от «котирует цены» к «формирует мнение».
Пять наборов данных несут большую часть сигнала: баланс, отчёт о прибылях и убытках, отчёт о движении денежных средств, история дивидендов и сделки инсайдеров.
Налог EDGAR
Всё это публично и бесплатно в SEC EDGAR. Загвоздка — XBRL. JSON company-facts огромен и непоследователен: один и тот же концепт тегируется по-разному у разных заявителей, пересмотры отчётности замутняют историю, и вам надо сопоставить разросшуюся таксономию с чистой схемой, прежде чем что-либо ниже по потоку сможет её использовать. Данные инсайдеров (Form 4) и дивиденды — отдельные типы отчётности, которые вы парсите сами по себе. Сделать это один раз для одного тикера — выходные; делать это надёжно для агента, запрашивающего любую компанию, — это сопровождаемый конвейер.
Фундаментал как один инструмент
Financials Search возвращает балансы, отчёты о прибылях и убытках, движение денежных средств, дивиденды и сделки инсайдеров для публичных компаний США за одним POST-эндпоинтом — 200 кредитов за вызов, только за успех, заранее подготовлено под LLM.
import httpx, os
API, HEADERS = "https://api.apipick.com/v1", {"x-api-key": os.environ["APIPICK_KEY"]}
def fundamentals(query: str):
return httpx.post(f"{API}/search/financials", headers=HEADERS,
json={"query": query}).json()["results"]
fundamentals("Apple latest balance sheet and cash flow")
fundamentals("recent insider transactions at Meta")
fundamentals("Microsoft revenue and net income trend")EDGAR vs. поставщик vs. набор
| Парсить SEC EDGAR | Поставщик API отчётности | API Pick Financials | |
|---|---|---|---|
| Стоимость | Бесплатно + инженерия | Подписка | 200 кредитов/вызов, только за успех |
| Настройка | Конвейер нормализации XBRL | Интеграция типизированных эндпоинтов | Один эндпоинт, один формат |
| Покрытие | США, организовано по отчётности | Глубоко, длинная история | Фундаментал США + инсайдеры + дивиденды |
| Стиль запроса | По отчётности/концепту | Типизированные параметры | Естественный язык |
| Лучше всего для | Разовое / полный контроль | Фундаментал как продукт | Финансовые агенты (один инструмент из многих) |
Полная картина
Фундаментал естественно сочетается с SEC Filings Search для качественной стороны (факторы риска, MD&A, формулировки отчётных звонков) и с Markets Search для цены. Вместе они — хребет агента инвестиционного анализа. Один ключ, JSON повсюду, только за успех. Начните бесплатно со 100 кредитами, без карты.
Часто задаваемые вопросы
Разве я не могу просто получить фундаментал бесплатно из SEC EDGAR?
Можете — данные company-facts и XBRL в EDGAR бесплатны и авторитетны. Цена — это инженерия: теги XBRL дрейфуют между заявителями и периодами, пересмотры отчётности усложняют историю, и вам надо сопоставить тысячи концептов таксономии с чистой схемой, прежде чем модель (или график) сможет их использовать. Это ещё и только США и организовано по отчётности, а не по вопросу. Для одной компании время от времени EDGAR подходит. Для агента, запрашивающего множество компаний на естественном языке, нормализованный API экономит недели.
Что покрыто — и это только США?
Балансы, отчёты о прибылях и убытках, отчёты о движении денежных средств, история дивидендов и сделки инсайдеров для публичных компаний, листингованных в США. Это фундаментал США; для не-американских эмитентов вы бы использовали другой источник. Для самого текста отчётности (факторы риска 10-K, MD&A 10-Q, отчётные звонки) используйте отдельный эндпоинт SEC Filings Search.
Почему стоит выделять сделки инсайдеров и дивиденды?
Они высокосигнальны и раздражающе сложны для самостоятельной сборки. Покупки/продажи инсайдеров (SEC Form 4) — наблюдаемый поведенческий сигнал; история дивидендов важна для скринов по доходу и качеству. Оба требуют парсинга конкретных типов отчётности из EDGAR. Здесь это первоклассные поля в том же эндпоинте, что и отчётность.
Как это сравнивается с поставщиками API финансовой отчётности?
Специализированные поставщики (например, API финансовой отчётности) дают глубокие, типизированные эндпоинты и длинную историю — отлично, если фундаментал — это весь ваш продукт. Угол API Pick другой: фундаментал как один инструмент в наборе (рынки, SEC, экономика, новости) за одним ключом, в формате запроса для агента, с тарификацией только за успех. Если вы строите финансового агента, а не продукт по фундаменталу, набор в одном формате — более быстрый путь.
Это инвестиционный совет?
Нет. Это структурированные публичные финансовые данные для исследования и заземления агента. Они информируют анализ квалифицированным лицом или контролируемым агентом; это не совет, и они не должны управлять автоматической торговлей без человеческой ответственности и риск-контроля.
API, использованные в статье
Сара Чой — CEO API Pick. Пишет о продакшен-готовых API для AI-агентов и LLM-воркфлоу.