pickelfintech/the13f-mcp

Исследует только публичные данные. Возвращает раскрытые институциональные позиции; не делайте выводов о намерениях управляющего или будущих направлениях. Сравнивает двух управляющих один к одному: общие позиции, разницу в весах и то, что уникально для каждого. Мгновенное сравнение двух управляющих за квартал. Возвращает позиции, которые держат оба (с весом портфеля каждой стороны и разницей между ними), позиции, уникальные для каждого, а также метрики пересечения (количество общих позиций, пересечение по весу). Аргументы: cik_a: десятизначный SEC CIK первого управляющего с лидирующими нулями. cik_b: CIK второго управляющего. quarter: код квартала. По умолчанию — последний квартал. limit: максимальное количество общих / уникальных позиций для вывода на сторону, 1–250, по умолчанию 50 (полное количество всегда выводится независимо от этого). Возвращает: { "quarter": "...", "manager_a": {"cik", "name", "n_positions", "total_value_usd"}, "manager_b": {...}, "overlap": {"n_shared", "n_unique_to_a", "n_unique_to_b", "weight_overlap_pct", "name_overlap_pct"}, "shared_positions": [{"ticker", "cusip", "name", "weight_a_pct", "weight_b_pct", "weight_gap_pp", "value_a_usd", "value_b_usd"}, ...], "unique_to_a": [{"ticker", "cusip", "name", "weight_pct", "value_usd"}, ...], "unique_to_b": [...], "disclaimer": "..." }

Исследовательские данные только. Возвращает раскрытые институциональные позиции; не делайте выводов о намерениях управляющего или будущем направлении. Сопоставляет портфель с универсумом 13F и возвращает ближайших (или намеренно отличающихся) управляющих. Аргументы: holdings: список {"ticker": "AAPL", "weight": 0.05}; weight опционально (по умолчанию равные веса). quarter: по умолчанию последний квартал, если None. top_n: 1-50, по умолчанию 10. direction: "similar" (ближайшие совпадения) или "unlike" (наиболее отличающиеся). Возвращает: {"quarter": "...", "matches": [{"cik": ..., "similarity_score": ..., ...}, ...], "disclaimer": "..."}

Только исследовательские данные. Возвращает раскрытые позиции институциональных инвесторов; не делайте выводов о намерениях управляющего или будущем направлении. Возвращает топ-N консенсусный портфель — ценные бумаги, принадлежащие наибольшему числу институциональных управляющих. Аргументы: quarter: код квартала (например "q4y2025"). Возвращает: {"quarter": "...", "count": 50, "securities": [{"ticker": ..., "weight_pct": ..., ...}, ...]}

Только исследовательские данные. Возвращает раскрытые институциональные позиции; не делайте выводов о намерениях управляющего или будущем направлении. Возвращает то, что податель отчёта 13F купил, продал, добавил и сократил по сравнению с предыдущим кварталом. Самый востребованный отчёт 13F — без ручного сравнения двух списков позиций. Позиции сгруппированы по новым покупкам, выходам, увеличениям и уменьшениям, каждая с дельтой в долларах и акциях. Первый квартал в наборе данных не имеет предыдущего квартала для сравнения, поэтому списки изменений возвращаются пустыми, а previous_quarter = null. Аргументы: cik: 10-значный CIK SEC с ведущими нулями (например, "0001037389"). quarter: код квартала вида "q4y2025". По умолчанию — последний квартал. Возвращает: { "manager": {"cik": ..., "name": ...}, "quarter": "...", "previous_quarter": "..." | null, "summary": {"n_new", "n_exited", "n_increased", "n_decreased", "n_unchanged", "new_positions_value_usd", "exited_positions_value_usd", "increased_value_change_usd", "decreased_value_change_usd", "net_value_change_usd", ...}, "new_positions": [{"ticker", "cusip", "name", "value_usd", "shares", "weight"}, ...], "exited_positions": [{"ticker", "cusip", "name", "previous_value_usd", ...}, ...], "increased_positions": [{..., "value_change_usd", "shares_change", "value_percentage_change"}, ...], "decreased_positions": [...], "disclaimer": "..." }

Только исследовательские данные. Возвращает раскрытые институциональные позиции; не делайте выводов о намерениях менеджера или будущем направлении. Возвращает все позиции, которые держал подающий 13F в указанном квартале. Аргументы: cik: 10-значный SEC CIK с ведущими нулями (например, "0001037389"). quarter: код квартала, например "q4y2025". Возвращает: { "cik": "...", "quarter": "...", "n_positions": 3185, "total_value_thousands": 64461244358.0, "holdings": [{"CUSIP": ..., "TICKER": ..., "VALUE": ..., ...}, ...], "disclaimer": "..." }

Исследует только данные. Возвращает раскрытые институциональные позиции; не делайте выводов о намерениях управляющего или будущем направлении. Ищет холдинги для нескольких пар (cik, quarter) за один вызов (Tier 3). Эффективнее, чем вызывать get_manager_holdings многократно: группирует по кварталам, так что каждый parquet-файл читается не более одного раза. Один платеж, сколько бы пар вы ни передали (до 25 за вызов). Args: pairs: список словарей {"cik": "...", "quarter": "..."}. От 1 до 25. Returns: { "results": [ {"cik": "0001067983", "quarter": "q4y2025", "status": "ok", "n_positions": 42, "total_value_thousands": ..., "holdings": [...]}, {"cik": "0001234567", "quarter": "q4y2025", "status": "not_found", "error": "..."}, ... ], "n_requested": 5, "n_ok": 4, "n_failed": 1 } Ошибки на уровне отдельной пары НЕ вызывают исключение — проверяйте поле status у каждого результата. Используйте, когда нужно получить холдинги сразу для нескольких управляющих/кварталов (например, сравнить портфель за разные периоды или проанализировать пул аналогичных организаций).

Только исследовательские данные. Возвращает раскрытые институциональные позиции; не делайте выводов о намерениях менеджера или будущем направлении. Возвращает обзор менеджера за один вызов: динамика AUM и количества позиций плюс моментальный снимок. Представление динамики, для которого иначе потребовалось бы много вызовов holdings. Объединяет поквартальную историю AUM и количества позиций (сначала новые) с моментальным снимком топ-10 позиций последнего заполненного квартала менеджера и базовыми метаданными. Аргументы: cik: дополненный нулями 10-значный SEC CIK. history_quarters: сколько последних кварталов истории включить, 1-60, по умолчанию 12 (3 года). Возвращает: { "manager": {"cik", "name", "state", "manager_style", "sec_file_number", "entity_type"}, "summary": {"latest_quarter", "first_quarter", "n_quarters_filed", "latest_aum_usd", "latest_n_positions", "median_n_positions"}, "history": [{"quarter", "period_end_date", "aum_usd", "n_positions"}, ...], "top_holdings": [{"ticker", "cusip", "weight", "value_usd", "shares"}, ...], "disclaimer": "..." }

Только исследовательские данные. Возвращает раскрытые институциональные позиции; не делайте выводов о намерениях управляющего или будущем направлении. Возвращает снимок институционального режима за квартал (композит IIOI, состояние режима, переход). Аргументы: quarter: код квартала. Возвращает: {"quarter": "...", "iioi_composite": 62.4, "regime_state": "High Optimism", ...}

Только исследовательские данные. Возвращает раскрытые институциональные позиции; не делайте выводов о намерениях управляющего или будущих направлениях. Возвращает новые/выход/добавление/сокращение по нескольким последним кварталам за один вызов. Многоквартальное представление get_manager_changes: вместо одного квартала он проходит по последним quarters отчетам и возвращает сгруппированные изменения по каждому кварталу, начиная с самого нового. Кварталы, по которым управляющий не подавал отчеты, пропускаются. Используйте его, чтобы увидеть, как развивался портфель с течением времени, без циклического вызова get_manager_changes. Args: cik: дополненный нулями 10-значный SEC CIK (например, "0001067983"). quarters: сколько последних кварталов включить (1-60, по умолчанию 12). quarter: код последнего квартала, например "q4y2025". По умолчанию последний. Returns: { "manager": {"cik": ..., "name": ...}, "anchor_quarter": "...", "quarters_requested": ..., "quarters_returned": ..., "timeline": [{"quarter", "previous_quarter", "summary", "new_positions", "exited_positions", "increased_positions", "decreased_positions"}, ...], "disclaimer": "..." }

Только исследовательские данные. Возвращает раскрытые институциональные позиции; не делайте выводов о намерениях управляющего или будущем направлении. Возвращает поотраслевую аналитику движения институционального капитала за квартал. Аргументы: quarter: код квартала. sector: опциональный фильтр по сектору GICS (например, "Information Technology"). Возвращает: {"quarter": "...", "sectors": [{"gics_sector": ..., "net_capital_flow_thousands": ..., "risk_posture": ..., ...}, ...]}

Только исследовательские данные. Возвращает раскрытые институциональные позиции; не пытайтесь угадать намерения управляющего или будущее направление. Возвращает, какие податели 13F держат бумагу, и кто её недавно купил или продал. Безопасно-центричное дополнение к get_manager_holdings: вместо «что держит этот управляющий» отвечает на вопрос «кто владеет этой акцией». Держатели ранжируются по стоимости позиции; всегда сообщаются агрегированная стоимость, количество держателей и изменение количества держателей по сравнению с предыдущим кварталом. Аргументы: ticker: тикер (с суффиксом .US или без, например "NVDA" или "NVDA.US"); 8/9-значный CUSIP тоже подходит как запасной вариант. quarter: код квартала. По умолчанию последний квартал. limit: максимальное количество держателей / новых покупателей / вышедших держателей для вывода, 1-250, по умолчанию 50 (полное количество всегда сообщается независимо). Возвращает: { "security": {"ticker", "name", "sector", "cusips": [...], "matched_by"}, "quarter": "...", "previous_quarter": "..." | null, "aggregate": {"holder_count", "previous_holder_count", "holder_count_change", "total_value_usd", "total_shares", "new_buyer_count", "exited_holder_count"}, "holders": [{"cik", "manager_name", "value_usd", "shares", "weight_in_portfolio_pct", "is_new_holder", "value_change_usd"}, ...], "new_buyers": [...], "exited_holders": [...], "holders_truncated": bool, "disclaimer": "..." }

Только исследовательские данные. Возвращает раскрытые позиции институциональных инвесторов; не пытайтесь угадать намерения управляющего или будущее движение. Возвращает полный список филлеров 13F с AUM по каждому управляющему. Аргументы: active_only: если true (по умолчанию), только управляющие, присутствующие в последнем квартале. Возвращает: { "count": 8625, "active_only": true, "managers": [{"cik": "...", "name": "...", "latest_aum": ..., ...}, ...], "disclaimer": "..." } ПРИМЕЧАНИЕ: ответ может быть JSON размером ~6 МБ; рассмотрите возможность фильтрации на стороне клиента.

Только исследовательские данные. Возвращает раскрытые институциональные позиции; не делайте выводов о намерениях управляющего или будущем направлении. Возвращает все коды кварталов с доступными данными. Возвращает: {"quarters": ["q1y2013", ..., "q4y2025"], "latest": "q4y2025"} По умолчанию используйте последний квартал, если пользователь не укажет другой.

Только исследовательские данные. Возвращает раскрытые институциональные позиции; не делайте выводов о намерениях управляющего или будущем направлении. Находит подателей институциональных форм 13F по названию (поиск подстроки без учета регистра, минимум 2 символа). Args: query: подстрока имени управляющего (например, "renaissance", "berkshire"). limit: максимальное количество результатов, 1-50, по умолчанию 10. Returns: { "query": "...", "results": [ {"cik": "0001037389", "name": "Renaissance Technologies Llc", "latest_aum": 64461244358, "available_quarters": [...]}, ... ], "disclaimer": "Research data only..." }