이 MCP로 할 수 있는 일
Provides U.S. SEC Form 4 insider-trading data, 13F institutional holdings, superinvestor activity, stock overviews, and related searches.
기능
도구
14
도구
get_data_coverage
Data coverage and freshness
What data Livermore has and how fresh it is: the Form 4 filing-date range, the 13F quarters loaded (with the number of filers), the latest complete 13F quarter, the number of curated superinvestors, the Schedule 13D, 13G and Form 144 filing-date ranges, the filing-date range of politicians' trade reports (the congress field: reports by members of the U.S. Congress), the last successful data updates (ISO 8601 UTC), the update schedule and the usage limits of this server. Call it to check whether a date or quarter is covered.
읽기 전용
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['website', 'sources', 'form4', 'f13', 'superinvestors', 'ownership', 'congress', 'last_successful_update', 'update_schedule', 'limits', 'docs_url', 'llms_txt_url'], 'properties': {'f13': {'type': 'object', 'required': ['latest_complete_quarter', 'in_progress_quarter', 'market_wide_quarters', 'earliest_quarter', 'note'], 'properties': {'note': {'type': 'string'}, 'earliest_quarter': {'type': ['string', 'null']}, 'in_progress_quarter': {'type': ['string', 'null']}, 'market_wide_quarters': {'type': 'array', 'items': {'type': 'object', 'required': ['quarter', 'period', 'filers'], 'properties': {'filers': {'type': 'number'}, 'period': {'type': 'string'}, 'quarter': {'type': 'string'}}, 'additionalProperties': False}}, 'latest_complete_quarter': {'type': 'string'}}, 'additionalProperties': False}, 'form4': {'type': 'object', 'required': ['earliest_filed_date', 'latest_filed_at', 'latest_filed_date'], 'properties': {'latest_filed_at': {'type': ['string', 'null']}, 'latest_filed_date': {'type': ['string', 'null']}, 'earliest_filed_date': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'limits': {'type': 'object', 'required': ['max_rows_per_call', 'requests_per_minute_per_ip'], 'properties': {'max_rows_per_call': {'type': 'number'}, 'requests_per_minute_per_ip': {'type': 'number'}}, 'additionalProperties': False}, 'sources': {'type': 'string'}, 'website': {'type': 'string'}, 'congress': {'type': 'object', 'required': ['earliest_filed_date', 'latest_filed_date', 'note'], 'properties': {'note': {'type': 'string'}, 'latest_filed_date': {'type': ['string', 'null']}, 'earliest_filed_date': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'docs_url': {'type': 'string'}, 'ownership': {'type': 'object', 'required': ['schedule_13d', 'schedule_13g', 'form144', 'note'], 'properties': {'note': {'type': 'string'}, 'form144': {'anyOf': [{'type': 'object', 'required': ['earliest_filed_date', 'latest_filed_at', 'latest_filed_date'], 'properties': {'latest_filed_at': {'type': 'string'}, 'latest_filed_date': {'type': 'string'}, 'earliest_filed_date': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'schedule_13d': {'anyOf': [{'type': 'object', 'required': ['earliest_filed_date', 'latest_filed_at', 'latest_filed_date'], 'properties': {'latest_filed_at': {'type': 'string'}, 'latest_filed_date': {'type': 'string'}, 'earliest_filed_date': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'schedule_13g': {'anyOf': [{'type': 'object', 'required': ['earliest_filed_date', 'latest_filed_at', 'latest_filed_date'], 'properties': {'latest_filed_at': {'type': 'string'}, 'latest_filed_date': {'type': 'string'}, 'earliest_filed_date': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}, 'llms_txt_url': {'type': 'string'}, 'superinvestors': {'type': 'number'}, 'update_schedule': {'type': 'string'}, 'last_successful_update': {'type': 'object', 'required': ['sec_filings', 'tickers', 'cusip_mapping', 'congress'], 'properties': {'tickers': {'type': ['string', 'null']}, 'congress': {'type': ['string', 'null']}, 'sec_filings': {'type': ['string', 'null']}, 'cusip_mapping': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'additionalProperties': False}
get_form144_notices
Form 144 notices of proposed sales
Form 144 notices of proposed sales of restricted or control stock by insiders (officers, directors, large holders), newest first, like livermore.club/en/ownership/144. A notice is a plan to sell, not a completed sale. Notices replaced by a Form 144/A are left out. Filter by ticker (one company's whole history), seller_cik, query (seller or company name, or a ticker) and filing dates. Without ticker or seller_cik the query is market-wide and limited to 365 days of filings (default: the last 30 days), and notices whose market value is clearly misreported are left out, as on the website; with ticker or seller_cik they are listed with value_outlier true. A notice is flagged when the price per share its market value implies is far above the company's reference prices from Form 4 trades and 13F holdings around the planned sale date; values that are too low are not flagged. Each row has the company, the seller and their relationships to it, shares_to_sell, market_value_usd, shares_outstanding, approx_sale_date, plan_adoption_date (a Rule 10b5-1 plan, when given), the broker, and links to livermore.club and the SEC filing. Coverage: XML notices since 2023 (required since 2023-04-13); call get_data_coverage for the loaded date range. At most 200 rows per call; use page for more.
읽기 전용
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Latest filing date, YYYY-MM-DD, inclusive.'}, 'from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Earliest filing date, YYYY-MM-DD (US Eastern).'}, 'page': {'type': 'integer', 'default': 1, 'maximum': 500, 'minimum': 1, 'description': 'Page number starting at 1; each page has `limit` rows. Check has_more.'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 200, 'minimum': 1, 'description': 'Maximum rows to return (1-200, default 25).'}, 'query': {'type': 'string', 'maxLength': 80, 'minLength': 2, 'description': "Seller or company name contains this text, or a ticker for that company's notices (like the search box on livermore.club/en/ownership/144)."}, 'ticker': {'type': 'string', 'maxLength': 12, 'minLength': 1, 'description': 'Only notices for this company (all share classes; Form 144 has no CUSIP), whole history.'}, 'seller_cik': {'type': 'string', 'pattern': '^(CIK)?\\d{1,10}$', 'description': 'Only notices by this seller, whole history. Sellers use the same CIK as their Form 4 filings.'}}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['scope', 'stock', 'seller', 'filters', 'note', 'page', 'limit', 'has_more', 'rows', 'url'], 'properties': {'url': {'type': 'string'}, 'note': {'type': ['string', 'null']}, 'page': {'type': 'number'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['accession', 'form', 'amendment', 'filed_at', 'filed_date', 'issuer_cik', 'issuer_name', 'ticker', 'seller_cik', 'seller_name', 'relationships', 'security_class', 'shares_to_sell', 'market_value_usd', 'shares_outstanding', 'approx_sale_date', 'plan_adoption_date', 'broker', 'value_outlier', 'seller_url', 'stock_url', 'sec_url'], 'properties': {'form': {'type': 'string'}, 'broker': {'type': ['string', 'null']}, 'ticker': {'type': ['string', 'null']}, 'sec_url': {'type': 'string'}, 'filed_at': {'type': 'string'}, 'accession': {'type': 'string'}, 'amendment': {'type': 'boolean'}, 'stock_url': {'type': ['string', 'null']}, 'filed_date': {'type': 'string'}, 'issuer_cik': {'type': 'string'}, 'seller_cik': {'type': ['string', 'null']}, 'seller_url': {'type': ['string', 'null']}, 'issuer_name': {'type': ['string', 'null']}, 'seller_name': {'type': ['string', 'null']}, 'relationships': {'type': 'array', 'items': {'type': 'string'}}, 'value_outlier': {'type': 'boolean'}, 'security_class': {'type': ['string', 'null']}, 'shares_to_sell': {'type': ['number', 'null']}, 'approx_sale_date': {'type': ['string', 'null']}, 'market_value_usd': {'type': ['number', 'null']}, 'plan_adoption_date': {'type': ['string', 'null']}, 'shares_outstanding': {'type': ['number', 'null']}}, 'additionalProperties': False}}, 'limit': {'type': 'number'}, 'scope': {'enum': ['stock', 'seller', 'stock_and_seller', 'market'], 'type': 'string'}, 'stock': {'anyOf': [{'type': 'object', 'required': ['ticker', 'name', 'cik', 'url'], 'properties': {'cik': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'ticker': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'seller': {'anyOf': [{'type': 'object', 'required': ['cik', 'name', 'url'], 'properties': {'cik': {'type': 'string'}, 'url': {'type': ['string', 'null']}, 'name': {'type': ['string', 'null']}}, 'additionalProperties': False}, {'type': 'null'}]}, 'filters': {'type': 'object', 'required': ['query', 'from', 'to'], 'properties': {'to': {'type': ['string', 'null']}, 'from': {'type': ['string', 'null']}, 'query': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'has_more': {'type': 'boolean'}}, 'additionalProperties': False}
get_insider_lists
Insider trading screens
Ready-made insider trading screens, the same lists as livermore.club/en/insiders: cluster-buys (companies where 3 or more different insiders bought on the open market in the last 30 days, ranked by total value; returned in `companies`), ceo-cfo-buys (CEO or CFO open-market purchases of $25,000 or more in 30 days, newest first), top-buys-week and top-buys-month (largest open-market purchases filed in the last 7 or 30 days), top-sells-week and top-sells-month (largest open-market sales). Windows count back from now by SEC filing time. Non-derivative transactions only; rows flagged as price outliers, duplicate filings (the same trade reported again in a later filing) and issuers without a ticker are excluded. Trade rows have the same fields as get_insider_trades. Amounts in USD. At most 200 rows.
읽기 전용
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['list'], 'properties': {'list': {'enum': ['cluster-buys', 'ceo-cfo-buys', 'top-buys-week', 'top-buys-month', 'top-sells-week', 'top-sells-month'], 'type': 'string', 'description': 'cluster-buys, ceo-cfo-buys, top-buys-week, top-buys-month, top-sells-week or top-sells-month.'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 200, 'minimum': 1, 'description': 'Maximum rows to return (1-200, default 25).'}}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['list', 'title', 'definition', 'window_days', 'url', 'companies', 'trades'], 'properties': {'url': {'type': 'string'}, 'list': {'type': 'string'}, 'title': {'type': 'string'}, 'trades': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['accession', 'filed_at', 'filed_date', 'trade_date_first', 'trade_date_last', 'ticker', 'issuer_cik', 'issuer_name', 'insider_cik', 'insider_name', 'insider_roles', 'insider_title', 'reporting_owners', 'code', 'acquired_or_disposed', 'derivative', 'security_title', 'ownership', 'shares', 'avg_price_usd', 'value_usd', 'shares_owned_after', 'ownership_change_pct', 'lots', 'rule_10b5_1', 'amendment', 'carried_from', 'price_outlier', 'url', 'sec_url'], 'properties': {'url': {'type': ['string', 'null']}, 'code': {'type': ['string', 'null']}, 'lots': {'type': 'number'}, 'shares': {'type': ['number', 'null']}, 'ticker': {'type': ['string', 'null']}, 'sec_url': {'type': 'string'}, 'filed_at': {'type': 'string'}, 'accession': {'type': 'string'}, 'amendment': {'type': 'boolean'}, 'ownership': {'anyOf': [{'enum': ['direct', 'indirect'], 'type': 'string'}, {'type': 'null'}]}, 'value_usd': {'type': ['number', 'null']}, 'derivative': {'type': 'boolean'}, 'filed_date': {'type': 'string'}, 'issuer_cik': {'type': 'string'}, 'insider_cik': {'type': ['string', 'null']}, 'issuer_name': {'type': ['string', 'null']}, 'rule_10b5_1': {'type': ['boolean', 'null']}, 'carried_from': {'type': ['string', 'null']}, 'insider_name': {'type': ['string', 'null']}, 'avg_price_usd': {'type': ['number', 'null']}, 'insider_roles': {'type': 'array', 'items': {'enum': ['director', 'officer', 'ten_percent_owner', 'other'], 'type': 'string'}}, 'insider_title': {'type': ['string', 'null']}, 'price_outlier': {'type': 'boolean'}, 'security_title': {'type': ['string', 'null']}, 'trade_date_last': {'type': ['string', 'null']}, 'reporting_owners': {'type': 'number'}, 'trade_date_first': {'type': ['string', 'null']}, 'shares_owned_after': {'type': ['number', 'null']}, 'acquired_or_disposed': {'anyOf': [{'enum': ['acquired', 'disposed'], 'type': 'string'}, {'type': 'null'}]}, 'ownership_change_pct': {'type': ['number', 'null']}}, 'additionalProperties': False}}, {'type': 'null'}]}, 'companies': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['ticker', 'issuer_cik', 'issuer_name', 'insiders', 'value_usd', 'last_filed_at', 'last_filed_date', 'url'], 'properties': {'url': {'type': 'string'}, 'ticker': {'type': 'string'}, 'insiders': {'type': 'number'}, 'value_usd': {'type': ['number', 'null']}, 'issuer_cik': {'type': 'string'}, 'issuer_name': {'type': 'string'}, 'last_filed_at': {'type': 'string'}, 'last_filed_date': {'type': 'string'}}, 'additionalProperties': False}}, {'type': 'null'}]}, 'definition': {'type': 'string'}, 'window_days': {'type': 'number'}}, 'additionalProperties': False}
get_insider_trades
Insider trades (Form 4)
Insider transactions from SEC Form 4 filings (coverage starts July 2021; updated daily). One row per filing and transaction type: same-day lots are combined, avg_price_usd is value-weighted, value_usd is the USD total, shares_owned_after is the holding after the last lot, ownership_change_pct is the change in the insider's holding in percent (null = new position or not computable). Filter by ticker, insider_cik, filing-date range, codes, the primary insider's role and minimum value. Without ticker or insider_cik the query is market-wide and limited to 30 days of filings (default: last 7 days). Codes: P = open-market or private purchase, S = sale, A = grant or award, D = disposition to the issuer, F = shares withheld for taxes, G = gift, M = option exercise under a company plan, X = in-the-money exercise, C = conversion, W = inheritance, J = other. Default codes P and S. Dates are YYYY-MM-DD; filed_at is ISO 8601 UTC and filed_date its US Eastern date; backfilled filings may only have the date (filed_at at midnight Eastern). price_outlier is true when the reported price or value is not reliable (a typo, a wrong unit or a foreign company's home-market shares priced in local currency instead of US dollars); avg_price_usd and value_usd are then as filed, and the site leaves these rows out of rankings and totals. carried_from is set on rows that a Form 4/A carried over from the original filing: an amendment that restates only some lines leaves the original's other transactions standing, so they are listed under the amendment's accession (amendment true), with the original's accession in carried_from and the original's filed_at and sec_url; it is null otherwise. rule_10b5_1 is null for filings before 2023. Each row links to livermore.club (url) and the SEC filing that reports the transaction (sec_url). At most 200 rows per call; use page for more.
읽기 전용
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Latest SEC filing date, YYYY-MM-DD, inclusive.'}, 'from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Earliest SEC filing date, YYYY-MM-DD (US Eastern).'}, 'page': {'type': 'integer', 'default': 1, 'maximum': 500, 'minimum': 1, 'description': 'Page number starting at 1; each page has `limit` rows. Check has_more.'}, 'sort': {'enum': ['filed', 'trade_date', 'value'], 'type': 'string', 'default': 'filed', 'description': 'filed = newest filing first (default); trade_date = most recent trade date first; value = largest USD value first (rows flagged as price outliers or duplicate filings are left out).'}, 'codes': {'anyOf': [{'type': 'string', 'const': 'all'}, {'type': 'array', 'items': {'type': 'string', 'pattern': '^[A-Za-z]$'}, 'maxItems': 20, 'minItems': 1}], 'default': ['P', 'S'], 'description': 'Form 4 transaction codes to include, e.g. ["P"] for purchases only, or "all". Default ["P","S"] (open-market purchases and sales).'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 200, 'minimum': 1, 'description': 'Maximum rows to return (1-200, default 25).'}, 'roles': {'type': 'array', 'items': {'enum': ['ceo', 'cfo', 'director', 'officer', 'owner10'], 'type': 'string'}, 'default': [], 'maxItems': 5, 'description': 'Keep rows whose primary reporting owner has any of these roles: ceo, cfo, director, officer, owner10 (10% owner). Empty = any role.'}, 'ticker': {'type': 'string', 'maxLength': 12, 'minLength': 1, 'description': "Only this company's filings (all share classes of the issuer), e.g. AAPL or BRK.B."}, 'insider_cik': {'type': 'string', 'pattern': '^(CIK)?\\d{1,10}$', 'description': 'Only filings on which this insider (reporting owner) appears, across all companies. Get the CIK from search.'}, 'min_value_usd': {'type': 'number', 'maximum': 10000000000000, 'minimum': 0, 'description': 'Minimum transaction value in USD (rows without a price are then excluded).'}}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['scope', 'stock', 'insider', 'filters', 'note', 'page', 'limit', 'has_more', 'rows', 'url'], 'properties': {'url': {'type': 'string'}, 'note': {'type': ['string', 'null']}, 'page': {'type': 'number'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['accession', 'filed_at', 'filed_date', 'trade_date_first', 'trade_date_last', 'ticker', 'issuer_cik', 'issuer_name', 'insider_cik', 'insider_name', 'insider_roles', 'insider_title', 'reporting_owners', 'code', 'acquired_or_disposed', 'derivative', 'security_title', 'ownership', 'shares', 'avg_price_usd', 'value_usd', 'shares_owned_after', 'ownership_change_pct', 'lots', 'rule_10b5_1', 'amendment', 'carried_from', 'price_outlier', 'url', 'sec_url'], 'properties': {'url': {'type': ['string', 'null']}, 'code': {'type': ['string', 'null']}, 'lots': {'type': 'number'}, 'shares': {'type': ['number', 'null']}, 'ticker': {'type': ['string', 'null']}, 'sec_url': {'type': 'string'}, 'filed_at': {'type': 'string'}, 'accession': {'type': 'string'}, 'amendment': {'type': 'boolean'}, 'ownership': {'anyOf': [{'enum': ['direct', 'indirect'], 'type': 'string'}, {'type': 'null'}]}, 'value_usd': {'type': ['number', 'null']}, 'derivative': {'type': 'boolean'}, 'filed_date': {'type': 'string'}, 'issuer_cik': {'type': 'string'}, 'insider_cik': {'type': ['string', 'null']}, 'issuer_name': {'type': ['string', 'null']}, 'rule_10b5_1': {'type': ['boolean', 'null']}, 'carried_from': {'type': ['string', 'null']}, 'insider_name': {'type': ['string', 'null']}, 'avg_price_usd': {'type': ['number', 'null']}, 'insider_roles': {'type': 'array', 'items': {'enum': ['director', 'officer', 'ten_percent_owner', 'other'], 'type': 'string'}}, 'insider_title': {'type': ['string', 'null']}, 'price_outlier': {'type': 'boolean'}, 'security_title': {'type': ['string', 'null']}, 'trade_date_last': {'type': ['string', 'null']}, 'reporting_owners': {'type': 'number'}, 'trade_date_first': {'type': ['string', 'null']}, 'shares_owned_after': {'type': ['number', 'null']}, 'acquired_or_disposed': {'anyOf': [{'enum': ['acquired', 'disposed'], 'type': 'string'}, {'type': 'null'}]}, 'ownership_change_pct': {'type': ['number', 'null']}}, 'additionalProperties': False}}, 'limit': {'type': 'number'}, 'scope': {'enum': ['stock', 'insider', 'stock_and_insider', 'market'], 'type': 'string'}, 'stock': {'anyOf': [{'type': 'object', 'required': ['ticker', 'name', 'cik', 'url'], 'properties': {'cik': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'ticker': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'filters': {'type': 'object', 'required': ['codes', 'roles', 'min_value_usd', 'from', 'to', 'sort'], 'properties': {'to': {'type': ['string', 'null']}, 'from': {'type': ['string', 'null']}, 'sort': {'type': 'string'}, 'codes': {'anyOf': [{'type': 'string', 'const': 'all'}, {'type': 'array', 'items': {'type': 'string'}}]}, 'roles': {'type': 'array', 'items': {'type': 'string'}}, 'min_value_usd': {'type': ['number', 'null']}}, 'additionalProperties': False}, 'insider': {'anyOf': [{'type': 'object', 'required': ['cik', 'name', 'url'], 'properties': {'cik': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'has_more': {'type': 'boolean'}}, 'additionalProperties': False}
get_institution
13F institution and its holdings
One 13F filer (an institution or a curated superinvestor) by SEC CIK: names (and the superinvestor's manager and style), the quarters it filed (newest 12, with quarters_total: number of positions, portfolio value in USD, filing time, amendments), and its holdings for one quarter (default: the latest it filed) with shares, market value in USD at quarter end, pct_of_portfolio (percent) and the change versus the previous calendar quarter (new/added/reduced/unchanged, share_change_pct in percent). When a stock split between the two quarters, previous_shares is converted to this quarter's shares before comparing (split_factor = new shares per old share) and a change within 0.5% counts as unchanged; a split that changed the CUSIP is shown as one row under the new CUSIP. Also returns the 10 largest positions sold out that quarter and the 10 largest option positions (put/call market value), each with its total count. Portfolio value counts long positions and excludes options. If the institution did not file the previous quarter, changes and sold-out positions are not reported. Securities without a ticker (bonds, some ETFs and foreign shares) have url null. At most 200 holdings per call; use page.
읽기 전용
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['cik'], 'properties': {'cik': {'type': 'string', 'pattern': '^(CIK)?\\d{1,10}$', 'description': 'SEC CIK of the 13F filer, e.g. 0001067983 (Berkshire Hathaway). Get it from search.'}, 'page': {'type': 'integer', 'default': 1, 'maximum': 500, 'minimum': 1, 'description': 'Page number starting at 1; each page has `limit` rows. Check has_more.'}, 'sort': {'enum': ['value', 'shares', 'change', 'pct'], 'type': 'string', 'default': 'value', 'description': 'value = largest market value first (default); shares; change = largest share increase first; pct = largest share of the portfolio first.'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 200, 'minimum': 1, 'description': 'Maximum rows to return (1-200, default 25).'}, 'quarter': {'type': 'string', 'maxLength': 12, 'description': 'Quarter to show, e.g. 2026-q2. Default: the latest quarter this institution filed.'}}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['institution', 'quarters_total', 'quarters', 'quarter', 'period', 'previous_quarter', 'previous_quarter_filed', 'changes_available', 'note', 'summary', 'holdings', 'sold_out', 'options', 'url'], 'properties': {'url': {'type': 'string'}, 'note': {'type': ['string', 'null']}, 'period': {'type': ['string', 'null']}, 'options': {'anyOf': [{'type': 'object', 'required': ['total', 'rows'], 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['ticker', 'cusip', 'name_of_issuer', 'title_of_class', 'put_value_usd', 'call_value_usd', 'url'], 'properties': {'url': {'type': ['string', 'null']}, 'cusip': {'type': 'string'}, 'ticker': {'type': ['string', 'null']}, 'put_value_usd': {'type': ['number', 'null']}, 'call_value_usd': {'type': ['number', 'null']}, 'name_of_issuer': {'type': ['string', 'null']}, 'title_of_class': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'total': {'type': 'number'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'quarter': {'type': ['string', 'null']}, 'summary': {'anyOf': [{'type': 'object', 'required': ['positions', 'value_usd', 'previous_value_usd', 'filed_at', 'amended'], 'properties': {'amended': {'type': 'boolean'}, 'filed_at': {'type': 'string'}, 'positions': {'type': 'number'}, 'value_usd': {'type': 'number'}, 'previous_value_usd': {'type': ['number', 'null']}}, 'additionalProperties': False}, {'type': 'null'}]}, 'holdings': {'anyOf': [{'type': 'object', 'required': ['sort', 'page', 'limit', 'has_more', 'rows'], 'properties': {'page': {'type': 'number'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['ticker', 'cusip', 'name_of_issuer', 'title_of_class', 'shares', 'value_usd', 'pct_of_portfolio', 'previous_shares', 'previous_value_usd', 'share_change', 'share_change_pct', 'split_factor', 'action', 'url', 'holding_history_url'], 'properties': {'url': {'type': ['string', 'null']}, 'cusip': {'type': 'string'}, 'action': {'anyOf': [{'enum': ['new', 'added', 'reduced', 'unchanged', 'sold_out', 'not_filed'], 'type': 'string'}, {'type': 'null'}]}, 'shares': {'type': ['number', 'null']}, 'ticker': {'type': ['string', 'null']}, 'value_usd': {'type': ['number', 'null']}, 'share_change': {'type': ['number', 'null']}, 'split_factor': {'type': ['number', 'null'], 'description': 'Stock split between the two quarters: new shares per old share (10 = 10-for-1, 0.1 = 1-for-10 reverse split); previous_shares is converted by it. null when there was none.'}, 'name_of_issuer': {'type': ['string', 'null']}, 'title_of_class': {'type': ['string', 'null']}, 'previous_shares': {'type': ['number', 'null']}, 'pct_of_portfolio': {'type': ['number', 'null']}, 'share_change_pct': {'type': ['number', 'null']}, 'previous_value_usd': {'type': ['number', 'null']}, 'holding_history_url': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'sort': {'type': 'string'}, 'limit': {'type': 'number'}, 'has_more': {'type': 'boolean'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'quarters': {'type': 'array', 'items': {'type': 'object', 'required': ['quarter', 'period', 'positions', 'value_usd', 'filed_at', 'filed_date', 'amended', 'url'], 'properties': {'url': {'type': 'string'}, 'period': {'type': 'string'}, 'amended': {'type': 'boolean'}, 'quarter': {'type': 'string'}, 'filed_at': {'type': 'string'}, 'positions': {'type': 'number'}, 'value_usd': {'type': 'number'}, 'filed_date': {'type': 'string'}}, 'additionalProperties': False}}, 'sold_out': {'anyOf': [{'type': 'object', 'required': ['total', 'rows'], 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['ticker', 'cusip', 'name_of_issuer', 'title_of_class', 'shares', 'value_usd', 'pct_of_portfolio', 'previous_shares', 'previous_value_usd', 'share_change', 'share_change_pct', 'split_factor', 'action', 'url', 'holding_history_url'], 'properties': {'url': {'type': ['string', 'null']}, 'cusip': {'type': 'string'}, 'action': {'anyOf': [{'enum': ['new', 'added', 'reduced', 'unchanged', 'sold_out', 'not_filed'], 'type': 'string'}, {'type': 'null'}]}, 'shares': {'type': ['number', 'null']}, 'ticker': {'type': ['string', 'null']}, 'value_usd': {'type': ['number', 'null']}, 'share_change': {'type': ['number', 'null']}, 'split_factor': {'type': ['number', 'null'], 'description': 'Stock split between the two quarters: new shares per old share (10 = 10-for-1, 0.1 = 1-for-10 reverse split); previous_shares is converted by it. null when there was none.'}, 'name_of_issuer': {'type': ['string', 'null']}, 'title_of_class': {'type': ['string', 'null']}, 'previous_shares': {'type': ['number', 'null']}, 'pct_of_portfolio': {'type': ['number', 'null']}, 'share_change_pct': {'type': ['number', 'null']}, 'previous_value_usd': {'type': ['number', 'null']}, 'holding_history_url': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'total': {'type': 'number'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'institution': {'type': 'object', 'required': ['cik', 'name', 'sec_name', 'is_superinvestor', 'name_zh', 'manager', 'manager_zh', 'style', 'predecessors', 'successor', 'url', 'sec_filings_url'], 'properties': {'cik': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'style': {'type': 'array', 'items': {'type': 'string'}}, 'manager': {'type': ['string', 'null']}, 'name_zh': {'type': ['string', 'null']}, 'sec_name': {'type': 'string'}, 'successor': {'anyOf': [{'type': 'object', 'required': ['cik', 'name', 'url'], 'properties': {'cik': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'manager_zh': {'type': ['string', 'null']}, 'predecessors': {'type': 'array', 'items': {'type': 'object', 'required': ['cik', 'name', 'url'], 'properties': {'cik': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}}, 'additionalProperties': False}}, 'sec_filings_url': {'type': 'string'}, 'is_superinvestor': {'type': 'boolean'}}, 'additionalProperties': False}, 'quarters_total': {'type': 'number'}, 'previous_quarter': {'type': ['string', 'null']}, 'changes_available': {'type': 'boolean'}, 'previous_quarter_filed': {'type': 'boolean'}}, 'additionalProperties': False}
get_major_holders
Current 5% holders of a stock (13D/13G)
The current holders of 5% or more of a stock according to their latest Schedule 13D or 13G filing, largest first, like the Major holders tab on livermore.club. Each holder has pct_of_class (percent of the share class, 7.5 = 7.5%) and shares from its latest filing, the change against the previous filing of the same position (previous_pct_of_class, pct_of_class_change in percentage points; new_position is true for a first filing), the form (13D, 13G, 13D/A, 13G/A), filing and event dates, when the position was first filed and how many filings it has, and links to the holder's livermore.club page (institutions and insiders) and the SEC filing. In a group filing each member reports the shares it counts as its own, so the figure is the largest single stake, not a sum. Share classes (GOOG, GOOGL) are split by the CUSIP in the filing. Limits: holders stop filing after a company is acquired or delisted, and holders whose latest filing is an older SC 13D or SC 13G (before 2024-12-18) have no percent and are not counted. Structured 13D/13G filings (voluntary since 2023-12-18, required since 2024-12-18) carry the percent, shares and event date; older SC 13D and SC 13G filings (since 2021) list only the filer, the company and the date (legacy true). Call get_data_coverage for the loaded date range.
읽기 전용
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ticker'], 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 200, 'minimum': 1, 'description': 'Maximum rows to return (1-200, default 25).'}, 'ticker': {'type': 'string', 'maxLength': 12, 'minLength': 1, 'description': 'Stock ticker, e.g. AAPL or BRK.B (share classes use a dot; BRK-B also works).'}}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ticker', 'name', 'cik', 'holders_total', 'holders', 'note', 'url'], 'properties': {'cik': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'note': {'type': ['string', 'null']}, 'ticker': {'type': 'string'}, 'holders': {'type': 'array', 'items': {'type': 'object', 'required': ['filer_cik', 'filer_name', 'superinvestor', 'pct_of_class', 'shares', 'previous_pct_of_class', 'pct_of_class_change', 'new_position', 'form', 'schedule', 'amendment', 'accession', 'filed_at', 'filed_date', 'event_date', 'first_filed_date', 'filings', 'security_class', 'filer_url', 'sec_url'], 'properties': {'form': {'type': 'string'}, 'shares': {'type': ['number', 'null']}, 'filings': {'type': 'number'}, 'sec_url': {'type': 'string'}, 'filed_at': {'type': 'string'}, 'schedule': {'enum': ['13D', '13G'], 'type': 'string'}, 'accession': {'type': 'string'}, 'amendment': {'type': 'boolean'}, 'filer_cik': {'type': 'string'}, 'filer_url': {'type': ['string', 'null']}, 'event_date': {'type': ['string', 'null']}, 'filed_date': {'type': 'string'}, 'filer_name': {'type': 'string'}, 'new_position': {'type': 'boolean'}, 'pct_of_class': {'type': 'number'}, 'superinvestor': {'type': ['string', 'null']}, 'security_class': {'type': ['string', 'null']}, 'first_filed_date': {'type': 'string'}, 'pct_of_class_change': {'type': ['number', 'null']}, 'previous_pct_of_class': {'type': ['number', 'null']}}, 'additionalProperties': False}}, 'holders_total': {'type': 'number'}}, 'additionalProperties': False}
get_ownership_filings
Schedule 13D and 13G filings
Schedule 13D and 13G filings by holders of more than 5% of a company, newest first, like livermore.club/en/ownership. 13D is filed by holders who may seek to influence the company (activists), 13G by passive holders; /A marks an amendment. Filter by form, ticker (one stock's whole history), filer_cik (an institution's or person's filings, including those it is named in), query (filer or company name, or a ticker) and filing dates. Without ticker or filer_cik the query is market-wide and limited to 365 days of filings (default: the last 30 days); note says when the range was narrowed. Each row has the company (issuer_cik, issuer_name, ticker), the filer (filer_cik, filer_name, the superinvestor name when it is one, reporting_persons in a group filing), pct_of_class and shares, the change against the previous filing of the same position (previous_pct_of_class, pct_of_class_change in percentage points, new_position), below_5_pct (an exit or a drop below the threshold), the event date, and links to livermore.club (filer_url, stock_url) and the SEC filing. Structured 13D/13G filings (voluntary since 2023-12-18, required since 2024-12-18) carry the percent, shares and event date; older SC 13D and SC 13G filings (since 2021) list only the filer, the company and the date (legacy true). Call get_data_coverage for the loaded date range. At most 200 rows per call; use page for more.
읽기 전용
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Latest filing date, YYYY-MM-DD, inclusive.'}, 'form': {'enum': ['13D', '13G'], 'type': 'string', 'description': '13D (holders who may seek to influence the company) or 13G (passive holders). Default: both.'}, 'from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Earliest filing date, YYYY-MM-DD (US Eastern).'}, 'page': {'type': 'integer', 'default': 1, 'maximum': 500, 'minimum': 1, 'description': 'Page number starting at 1; each page has `limit` rows. Check has_more.'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 200, 'minimum': 1, 'description': 'Maximum rows to return (1-200, default 25).'}, 'query': {'type': 'string', 'maxLength': 80, 'minLength': 2, 'description': "Filer or company name contains this text, or a ticker for that company's filings (like the search box on livermore.club/en/ownership)."}, 'ticker': {'type': 'string', 'maxLength': 12, 'minLength': 1, 'description': "Only filings for this stock (the company's filings for this share class), whole history."}, 'filer_cik': {'type': 'string', 'pattern': '^(CIK)?\\d{1,10}$', 'description': 'Only filings this filer submitted or is named in as a reporting person, whole history. Get the CIK from search (institutions and insiders).'}}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['scope', 'stock', 'filer', 'filters', 'note', 'page', 'limit', 'has_more', 'rows', 'url'], 'properties': {'url': {'type': 'string'}, 'note': {'type': ['string', 'null']}, 'page': {'type': 'number'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['accession', 'form', 'schedule', 'amendment', 'legacy', 'filed_at', 'filed_date', 'event_date', 'issuer_cik', 'issuer_name', 'ticker', 'security_class', 'filer_cik', 'filer_name', 'superinvestor', 'reporting_persons', 'pct_of_class', 'shares', 'previous_pct_of_class', 'pct_of_class_change', 'new_position', 'below_5_pct', 'filer_url', 'stock_url', 'sec_url'], 'properties': {'form': {'type': 'string'}, 'legacy': {'type': 'boolean'}, 'shares': {'type': ['number', 'null']}, 'ticker': {'type': ['string', 'null']}, 'sec_url': {'type': 'string'}, 'filed_at': {'type': 'string'}, 'schedule': {'enum': ['13D', '13G'], 'type': 'string'}, 'accession': {'type': 'string'}, 'amendment': {'type': 'boolean'}, 'filer_cik': {'type': 'string'}, 'filer_url': {'type': ['string', 'null']}, 'stock_url': {'type': ['string', 'null']}, 'event_date': {'type': ['string', 'null']}, 'filed_date': {'type': 'string'}, 'filer_name': {'type': 'string'}, 'issuer_cik': {'type': ['string', 'null']}, 'below_5_pct': {'type': 'boolean'}, 'issuer_name': {'type': ['string', 'null']}, 'new_position': {'type': 'boolean'}, 'pct_of_class': {'type': ['number', 'null']}, 'superinvestor': {'type': ['string', 'null']}, 'security_class': {'type': ['string', 'null']}, 'reporting_persons': {'type': 'number'}, 'pct_of_class_change': {'type': ['number', 'null']}, 'previous_pct_of_class': {'type': ['number', 'null']}}, 'additionalProperties': False}}, 'filer': {'anyOf': [{'type': 'object', 'required': ['cik', 'name', 'url'], 'properties': {'cik': {'type': 'string'}, 'url': {'type': ['string', 'null']}, 'name': {'type': ['string', 'null']}}, 'additionalProperties': False}, {'type': 'null'}]}, 'limit': {'type': 'number'}, 'scope': {'enum': ['stock', 'filer', 'stock_and_filer', 'market'], 'type': 'string'}, 'stock': {'anyOf': [{'type': 'object', 'required': ['ticker', 'name', 'cik', 'url'], 'properties': {'cik': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'ticker': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'filters': {'type': 'object', 'required': ['form', 'query', 'from', 'to'], 'properties': {'to': {'type': ['string', 'null']}, 'form': {'type': ['string', 'null']}, 'from': {'type': ['string', 'null']}, 'query': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'has_more': {'type': 'boolean'}}, 'additionalProperties': False}
get_politician
Politician (member of the U.S. Congress)
One politician (a member of the U.S. Congress: House or Senate), by bioguide ID or name: party, chamber, state, district, in office or former, terms served with start and end dates; a profile with the official photo_url, position (e.g. U.S. Representative for California's 11th district), district code (CA-11), birthday and age, official website, social accounts and Wikipedia as URLs, leadership roles (Speaker, whips, caucus chairs; current first) and, for politicians in office, current committee and subcommittee seats with titles (chair, ranking_member and so on); trade statistics since 2020 for the chosen assets (listed securities by default: trades, buys, sells, estimated volume in USD, median filing delay in days, late trades and the reports that contain them), unlisted_trades (trades in bonds, private holdings and other assets, whatever asset is), the number of reports and how many are paper or scanned, the latest filing date, and the 5 tickers the politician traded most in the chosen assets, with livermore.club links. Use get_politician_trades with the bioguide ID for the trades. Profiles, committees and photos come from the unitedstates project (public domain), refreshed daily. Data: House and Senate periodic transaction reports (PTRs) filed since 2020-01-01, from the U.S. House Clerk and the Senate Office of Public Records (eFD), updated daily. Only listed securities are included by default: stocks (including ADRs), ETFs and options, the assets with an exchange ticker. Politicians also report Treasury bills and notes, municipal and corporate bonds, private companies, private funds, crypto and other assets; pass asset=other for those or asset=all for everything. Amounts are the statutory ranges members of Congress report, not exact values: amount_min_usd to amount_max_usd, where a null amount_max_usd is an 'Over $X' range; estimated volumes add up range midpoints (an 'Over $X' range counts as X), so treat them as rough sizes. Trades replaced by an amendment and duplicates reported again in a later filing are left out. Paper and scanned reports are listed on politician pages but their trades are not read.
읽기 전용
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['politician'], 'properties': {'asset': {'enum': ['listed', 'stock', 'option', 'other', 'all'], 'type': 'string', 'default': 'listed', 'description': 'Which assets to include: listed (default) = listed securities, that is stocks including ADRs, ETFs and options; stock = listed stocks and ETFs without options; option = options; other = Treasury bills and notes, municipal and corporate bonds, private companies, private funds, crypto and other assets; all = everything. The statistics and top tickers cover these assets.'}, 'politician': {'type': 'string', 'maxLength': 100, 'minLength': 2, 'description': 'A bioguide ID (e.g. P000197) or a name (e.g. Pelosi, Nancy Pelosi, Bernie Sanders). A name that matches several politicians returns an error listing them.'}}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['politician', 'profile', 'asset', 'stats', 'top_tickers', 'note', 'url'], 'properties': {'url': {'type': 'string'}, 'note': {'type': ['string', 'null']}, 'asset': {'enum': ['listed', 'stock', 'option', 'other', 'all'], 'type': 'string', 'description': 'The assets that stats and top_tickers cover.'}, 'stats': {'type': 'object', 'required': ['trades', 'buys', 'sells', 'estimated_volume_usd', 'median_delay_days', 'late_trades', 'late_filings', 'unlisted_trades', 'filings', 'paper_filings', 'latest_filed_date'], 'properties': {'buys': {'type': 'number'}, 'sells': {'type': 'number'}, 'trades': {'type': 'number'}, 'filings': {'type': 'number'}, 'late_trades': {'type': 'number'}, 'late_filings': {'type': 'number'}, 'paper_filings': {'type': 'number'}, 'unlisted_trades': {'type': 'number', 'description': 'Trades in bonds, private holdings and other assets that are not listed securities, whatever asset is.'}, 'latest_filed_date': {'type': ['string', 'null']}, 'median_delay_days': {'type': ['number', 'null']}, 'estimated_volume_usd': {'type': ['number', 'null']}}, 'additionalProperties': False}, 'profile': {'type': 'object', 'required': ['photo_url', 'position', 'district', 'birthday', 'age', 'website', 'social', 'wikipedia_url', 'leadership', 'committees'], 'properties': {'age': {'type': ['number', 'null'], 'description': 'Age today (US Eastern), for politicians in office only: the source has no date of death, so it is null for former members.'}, 'social': {'type': 'object', 'required': ['x', 'facebook', 'youtube', 'instagram', 'mastodon'], 'properties': {'x': {'type': ['string', 'null']}, 'youtube': {'type': ['string', 'null']}, 'facebook': {'type': ['string', 'null']}, 'mastodon': {'type': ['string', 'null']}, 'instagram': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'website': {'type': ['string', 'null'], 'description': 'Official website; politicians in office only.'}, 'birthday': {'type': ['string', 'null']}, 'district': {'type': ['string', 'null'], 'description': 'House seat code of the latest term, e.g. CA-11; AK-AL for an at-large seat, DC-AL for a delegate; null for senators.'}, 'position': {'type': 'string', 'description': "The seat in English, e.g. U.S. Representative for California's 11th district."}, 'photo_url': {'type': ['string', 'null'], 'description': 'Official portrait, 360x450 WebP, public domain; null when there is no photo.'}, 'committees': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'side', 'title', 'title_raw', 'chamber', 'url', 'subcommittees'], 'properties': {'id': {'type': 'string'}, 'url': {'type': ['string', 'null']}, 'name': {'type': 'string'}, 'side': {'type': ['string', 'null']}, 'title': {'anyOf': [{'enum': ['chair', 'vice_chair', 'ranking_member', 'ex_officio', 'co_chair', 'other'], 'type': 'string'}, {'type': 'null'}], 'description': "chair, vice_chair, ranking_member, ex_officio, co_chair or other (the source's wording is in title_raw); null for a regular member."}, 'chamber': {'type': 'string', 'description': 'house, senate or joint.'}, 'title_raw': {'type': ['string', 'null']}, 'subcommittees': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'side', 'title', 'title_raw'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'side': {'type': ['string', 'null']}, 'title': {'anyOf': [{'enum': ['chair', 'vice_chair', 'ranking_member', 'ex_officio', 'co_chair', 'other'], 'type': 'string'}, {'type': 'null'}], 'description': "chair, vice_chair, ranking_member, ex_officio, co_chair or other (the source's wording is in title_raw); null for a regular member."}, 'title_raw': {'type': ['string', 'null']}}, 'additionalProperties': False}}}, 'additionalProperties': False}}, 'leadership': {'type': 'array', 'items': {'type': 'object', 'required': ['title', 'chamber', 'start', 'end', 'current'], 'properties': {'end': {'type': ['string', 'null'], 'description': 'The end date, or null when the source gives none (the role is held).'}, 'start': {'type': 'string'}, 'title': {'type': 'string'}, 'chamber': {'type': 'string'}, 'current': {'type': 'boolean'}}, 'additionalProperties': False}}, 'wikipedia_url': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'politician': {'type': 'object', 'required': ['bioguide', 'name', 'party', 'chamber', 'state', 'district', 'in_office', 'url', 'terms'], 'properties': {'url': {'type': 'string'}, 'name': {'type': 'string'}, 'party': {'type': ['string', 'null']}, 'state': {'type': 'string'}, 'terms': {'type': 'array', 'items': {'type': 'object', 'required': ['chamber', 'start', 'end'], 'properties': {'end': {'type': 'string'}, 'start': {'type': 'string'}, 'chamber': {'enum': ['house', 'senate'], 'type': 'string'}}, 'additionalProperties': False}}, 'chamber': {'enum': ['house', 'senate'], 'type': 'string'}, 'bioguide': {'type': 'string'}, 'district': {'type': ['number', 'null']}, 'in_office': {'type': 'boolean'}}, 'additionalProperties': False}, 'top_tickers': {'type': 'array', 'items': {'type': 'object', 'required': ['ticker', 'trades', 'estimated_volume_usd', 'stock_url'], 'properties': {'ticker': {'type': 'string'}, 'trades': {'type': 'number'}, 'stock_url': {'type': ['string', 'null']}, 'estimated_volume_usd': {'type': ['number', 'null']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
get_politician_trades
Politician trades (U.S. Congress: House and Senate)
Trades in stocks, ETFs, options and, on request, other assets reported by politicians (members of the U.S. Congress: House and Senate), one row per trade, newest report first by default. Filter by politician (bioguide ID or name), ticker, asset (listed by default, or stock, option, other, all), chamber, party, type (buy, sell, exchange), report filing dates (filed_from, filed_to) and trade dates (traded_from, traded_to). Each row has the politician (politician_bioguide, politician_name, party, chamber, state), the asset and reported ticker, asset_class, type (purchase, sale_full, sale_partial, sale or exchange), owner (self, spouse, joint or child), traded_date and filed_date, delay_days (days from the trade to its first report; null when the reported trade date is after the filing date, a typo flagged by trade_date_error), late (reported more than 45 days after the trade), the amount range, the official source_url, and livermore.club links for the politician and the stock (stock_url is null when the asset is not a listed company). totals summarize all trades matching the filters, not just this page. Data: House and Senate periodic transaction reports (PTRs) filed since 2020-01-01, from the U.S. House Clerk and the Senate Office of Public Records (eFD), updated daily. Only listed securities are included by default: stocks (including ADRs), ETFs and options, the assets with an exchange ticker. Politicians also report Treasury bills and notes, municipal and corporate bonds, private companies, private funds, crypto and other assets; pass asset=other for those or asset=all for everything. Amounts are the statutory ranges members of Congress report, not exact values: amount_min_usd to amount_max_usd, where a null amount_max_usd is an 'Over $X' range; estimated volumes add up range midpoints (an 'Over $X' range counts as X), so treat them as rough sizes. Trades replaced by an amendment and duplicates reported again in a later filing are left out. Paper and scanned reports are listed on politician pages but their trades are not read. At most 200 rows per call; use page for more.
읽기 전용
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'default': 1, 'maximum': 500, 'minimum': 1, 'description': 'Page number starting at 1; each page has `limit` rows. Check has_more.'}, 'sort': {'enum': ['filed', 'traded', 'amount'], 'type': 'string', 'default': 'filed', 'description': 'filed = newest report first (default); traded = most recent trade first; amount = largest amount range first.'}, 'type': {'enum': ['buy', 'sell', 'exchange'], 'type': 'string', 'description': 'buy (purchases), sell (full, partial or unspecified sales) or exchange.'}, 'asset': {'enum': ['listed', 'stock', 'option', 'other', 'all'], 'type': 'string', 'default': 'listed', 'description': 'Which assets to include: listed (default) = listed securities, that is stocks including ADRs, ETFs and options; stock = listed stocks and ETFs without options; option = options; other = Treasury bills and notes, municipal and corporate bonds, private companies, private funds, crypto and other assets; all = everything.'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 200, 'minimum': 1, 'description': 'Maximum rows to return (1-200, default 25).'}, 'party': {'enum': ['democrat', 'republican', 'independent'], 'type': 'string', 'description': "democrat, republican or independent (the politician's latest party)."}, 'ticker': {'type': 'string', 'maxLength': 12, 'minLength': 1, 'description': 'Only trades in this company (all its share classes, options and former tickers), e.g. MSFT. A ticker that is not a listed company (many ETFs and funds) matches the ticker as reported.'}, 'chamber': {'enum': ['house', 'senate'], 'type': 'string', 'description': 'house or senate.'}, 'filed_to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Latest filing date of the report, YYYY-MM-DD, inclusive.'}, 'traded_to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Latest trade date, YYYY-MM-DD, inclusive.'}, 'filed_from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Earliest filing date of the report, YYYY-MM-DD.'}, 'politician': {'type': 'string', 'maxLength': 100, 'minLength': 2, 'description': 'Only this politician (a member of the U.S. Congress): a bioguide ID (e.g. P000197) or a name (e.g. Pelosi, Nancy Pelosi, Bernie Sanders). A name that matches several politicians returns an error listing them.'}, 'traded_from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Earliest trade date, YYYY-MM-DD.'}}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['politician', 'stock', 'ticker', 'filters', 'totals', 'note', 'page', 'limit', 'has_more', 'rows', 'url'], 'properties': {'url': {'type': 'string'}, 'note': {'type': ['string', 'null']}, 'page': {'type': 'number'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['filing_id', 'seq', 'politician_bioguide', 'politician_name', 'party', 'chamber', 'state', 'traded_date', 'trade_date_error', 'filed_date', 'delay_days', 'late', 'owner', 'type', 'asset_name', 'asset_class', 'ticker', 'issuer_cik', 'issuer_name', 'amount_min_usd', 'amount_max_usd', 'amount_text', 'description', 'comment', 'source_url', 'politician_url', 'stock_url'], 'properties': {'seq': {'type': 'number'}, 'late': {'type': ['boolean', 'null']}, 'type': {'anyOf': [{'enum': ['purchase', 'sale_full', 'sale_partial', 'sale', 'exchange'], 'type': 'string'}, {'type': 'null'}]}, 'owner': {'anyOf': [{'enum': ['self', 'spouse', 'joint', 'child'], 'type': 'string'}, {'type': 'null'}]}, 'party': {'type': ['string', 'null']}, 'state': {'type': 'string'}, 'ticker': {'type': ['string', 'null']}, 'chamber': {'enum': ['house', 'senate'], 'type': 'string'}, 'comment': {'type': ['string', 'null']}, 'filing_id': {'type': 'string'}, 'stock_url': {'type': ['string', 'null']}, 'asset_name': {'type': 'string'}, 'delay_days': {'type': ['number', 'null']}, 'filed_date': {'type': 'string'}, 'issuer_cik': {'type': ['string', 'null']}, 'source_url': {'type': 'string'}, 'amount_text': {'type': ['string', 'null']}, 'asset_class': {'anyOf': [{'enum': ['stock', 'option', 'etf', 'mutual_fund', 'corporate_bond', 'municipal', 'government', 'crypto', 'private_stock', 'other'], 'type': 'string'}, {'type': 'null'}]}, 'description': {'type': ['string', 'null']}, 'issuer_name': {'type': ['string', 'null']}, 'traded_date': {'type': ['string', 'null']}, 'amount_max_usd': {'type': ['number', 'null']}, 'amount_min_usd': {'type': ['number', 'null']}, 'politician_url': {'type': 'string'}, 'politician_name': {'type': 'string'}, 'trade_date_error': {'type': 'boolean'}, 'politician_bioguide': {'type': 'string'}}, 'additionalProperties': False}}, 'limit': {'type': 'number'}, 'stock': {'anyOf': [{'type': 'object', 'required': ['ticker', 'name', 'cik', 'url'], 'properties': {'cik': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'ticker': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'ticker': {'type': ['string', 'null'], 'description': 'The ticker filter when it is not a listed company and is matched as reported.'}, 'totals': {'type': 'object', 'required': ['trades', 'filings', 'politicians', 'buys', 'sells', 'estimated_volume_usd', 'estimated_buy_usd', 'estimated_sell_usd'], 'properties': {'buys': {'type': 'number'}, 'sells': {'type': 'number'}, 'trades': {'type': 'number'}, 'filings': {'type': 'number'}, 'politicians': {'type': 'number'}, 'estimated_buy_usd': {'type': ['number', 'null']}, 'estimated_sell_usd': {'type': ['number', 'null']}, 'estimated_volume_usd': {'type': ['number', 'null']}}, 'additionalProperties': False}, 'filters': {'type': 'object', 'required': ['asset', 'chamber', 'party', 'type', 'filed_from', 'filed_to', 'traded_from', 'traded_to', 'sort'], 'properties': {'sort': {'type': 'string'}, 'type': {'type': ['string', 'null']}, 'asset': {'enum': ['listed', 'stock', 'option', 'other', 'all'], 'type': 'string'}, 'party': {'type': ['string', 'null']}, 'chamber': {'type': ['string', 'null']}, 'filed_to': {'type': ['string', 'null']}, 'traded_to': {'type': ['string', 'null']}, 'filed_from': {'type': ['string', 'null']}, 'traded_from': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'has_more': {'type': 'boolean'}, 'politician': {'anyOf': [{'type': 'object', 'required': ['bioguide', 'name', 'party', 'chamber', 'state', 'district', 'in_office', 'url'], 'properties': {'url': {'type': 'string'}, 'name': {'type': 'string'}, 'party': {'type': ['string', 'null']}, 'state': {'type': 'string'}, 'chamber': {'enum': ['house', 'senate'], 'type': 'string'}, 'bioguide': {'type': 'string'}, 'district': {'type': ['number', 'null']}, 'in_office': {'type': 'boolean'}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}
get_stock
Stock overview
Overview of one US-listed stock: company facts (SEC name, CIK, exchange, SIC industry, other share classes), open-market insider activity in the last 90 days (Form 4 codes P and S, non-derivative: number of filings and total USD), institutional ownership from 13F for the latest complete quarter (number of holders, total shares and market value in USD, and the previous quarter for comparison), and the curated superinvestors holding it (shares, market value, pct_of_portfolio = percent of that superinvestor's 13F portfolio). A quarter is complete once its 45-day filing deadline has passed and the data is loaded; in_progress_quarter is a newer quarter still being filed. Share classes (GOOG/GOOGL, BRK.A/BRK.B) are separate tickers because 13F reports each class separately. A ticker that is no longer on the SEC's list (active false; delisted true when the company has no listed common stock left, with the Form 25 delisting date in delisted_on when known) keeps its page, and its 13F figures are for its last quarter with a full set of 13F holders (f13.note). Use get_insider_trades and get_stock_13f_holders for the full lists.
읽기 전용
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'maxLength': 12, 'minLength': 1, 'description': 'Stock ticker, e.g. AAPL or BRK.B (share classes use a dot; BRK-B also works).'}}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ticker', 'name', 'cik', 'exchange', 'active', 'delisted', 'delisted_on', 'sic', 'industry', 'other_share_classes', 'url', 'insiders_url', 'holders_url', 'sec_filings_url', 'insider_activity', 'f13', 'superinvestors'], 'properties': {'cik': {'type': 'string'}, 'f13': {'anyOf': [{'type': 'object', 'required': ['quarter', 'period', 'latest_complete_quarter', 'in_progress_quarter', 'holders', 'shares', 'value_usd', 'previous', 'note', 'url'], 'properties': {'url': {'type': 'string'}, 'note': {'type': ['string', 'null'], 'description': 'Why the quarter is older than latest_complete_quarter (inactive tickers).'}, 'period': {'type': 'string'}, 'shares': {'type': ['number', 'null']}, 'holders': {'type': 'number'}, 'quarter': {'type': 'string'}, 'previous': {'anyOf': [{'type': 'object', 'required': ['quarter', 'period', 'holders', 'shares', 'value_usd'], 'properties': {'period': {'type': 'string'}, 'shares': {'type': ['number', 'null']}, 'holders': {'type': 'number'}, 'quarter': {'type': 'string'}, 'value_usd': {'type': ['number', 'null']}}, 'additionalProperties': False}, {'type': 'null'}]}, 'value_usd': {'type': ['number', 'null']}, 'in_progress_quarter': {'type': ['string', 'null']}, 'latest_complete_quarter': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'sic': {'type': ['string', 'null']}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'active': {'type': 'boolean', 'description': "false when the ticker is no longer on the SEC's list of tickers."}, 'ticker': {'type': 'string'}, 'delisted': {'type': 'boolean', 'description': 'true when the ticker is inactive and the company has no active common-stock ticker left (delisted or acquired). An inactive ticker whose company still trades under another ticker (a ticker change) is not delisted.'}, 'exchange': {'type': ['string', 'null']}, 'industry': {'type': ['string', 'null']}, 'delisted_on': {'type': ['string', 'null'], 'description': 'Delisting date (YYYY-MM-DD) of a delisted stock: the SEC filing date of the Form 25 that removed its common stock from the exchange. null when the stock is not delisted or no Form 25 was found (for example a company that kept trading over the counter).'}, 'holders_url': {'type': 'string'}, 'insiders_url': {'type': 'string'}, 'superinvestors': {'type': 'array', 'items': {'type': 'object', 'required': ['cik', 'name', 'manager', 'shares', 'value_usd', 'pct_of_portfolio', 'url', 'holding_url'], 'properties': {'cik': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'shares': {'type': ['number', 'null']}, 'manager': {'type': ['string', 'null']}, 'value_usd': {'type': ['number', 'null']}, 'holding_url': {'type': 'string'}, 'pct_of_portfolio': {'type': ['number', 'null']}}, 'additionalProperties': False}}, 'sec_filings_url': {'type': 'string'}, 'insider_activity': {'type': 'object', 'required': ['window_days', 'buy_filings', 'buy_value_usd', 'sell_filings', 'sell_value_usd'], 'properties': {'buy_filings': {'type': 'number'}, 'window_days': {'type': 'number'}, 'sell_filings': {'type': 'number'}, 'buy_value_usd': {'type': ['number', 'null']}, 'sell_value_usd': {'type': ['number', 'null']}}, 'additionalProperties': False}, 'other_share_classes': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}
get_stock_13f_holders
13F institutional holders of a stock
Institutions that reported holding a stock in their 13F-HR filings for one calendar quarter (default: the latest complete quarter, or for a ticker that is no longer listed its last quarter with a full set of 13F holders; 13F is filed up to 45 days after quarter end and covers long positions in US-listed securities only). Each row: institution, shares, market value in USD at quarter end as reported, pct_of_portfolio (percent of that institution's 13F portfolio), and the change versus the previous calendar quarter (action new/added/reduced/unchanged/sold_out, share_change, share_change_pct in percent). When the stock split between the two quarters, previous_shares is converted to this quarter's shares before comparing (split_factor = new shares per old share; the filed count is previous_shares / split_factor) and a change within 0.5% counts as unchanged; the previous totals are as filed. Institutions that held the stock last quarter and filed this quarter without it are listed after the holders as sold_out; institutions that held it last quarter but have not filed this quarter yet are listed at the very end as not_filed (not a sale, shares and value null). Totals (holders, shares, value_usd) cover all holders, not just this page. Multiple CUSIPs of the same ticker are combined. changes_available is false (and the change fields are null) when the previous quarter cannot be compared; `note` explains incomplete or still-filing quarters. At most 200 rows per call; use page.
읽기 전용
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ticker'], 'properties': {'page': {'type': 'integer', 'default': 1, 'maximum': 500, 'minimum': 1, 'description': 'Page number starting at 1; each page has `limit` rows. Check has_more.'}, 'sort': {'enum': ['value', 'shares', 'change'], 'type': 'string', 'default': 'value', 'description': 'value = largest market value first (default); shares = most shares; change = largest share increase first. Sold-out holders are always listed last.'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 200, 'minimum': 1, 'description': 'Maximum rows to return (1-200, default 25).'}, 'ticker': {'type': 'string', 'maxLength': 12, 'minLength': 1, 'description': 'Stock ticker, e.g. AAPL or BRK.B (share classes use a dot; BRK-B also works).'}, 'quarter': {'type': 'string', 'maxLength': 12, 'description': 'Quarter to show, e.g. 2026-q2. Default: the latest complete quarter; for a ticker that is no longer listed, its last quarter with a full set of 13F holders.'}}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ticker', 'name', 'quarter', 'period', 'previous_quarter', 'latest_complete_quarter', 'in_progress_quarter', 'holders', 'shares', 'value_usd', 'previous', 'changes_available', 'split_factor', 'note', 'sort', 'page', 'limit', 'has_more', 'rows', 'url'], 'properties': {'url': {'type': 'string'}, 'name': {'type': 'string'}, 'note': {'type': ['string', 'null']}, 'page': {'type': 'number'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['institution_cik', 'institution_name', 'superinvestor', 'shares', 'value_usd', 'pct_of_portfolio', 'previous_shares', 'share_change', 'share_change_pct', 'action', 'url', 'holding_url'], 'properties': {'url': {'type': 'string'}, 'action': {'anyOf': [{'enum': ['new', 'added', 'reduced', 'unchanged', 'sold_out', 'not_filed'], 'type': 'string'}, {'type': 'null'}]}, 'shares': {'type': ['number', 'null']}, 'value_usd': {'type': ['number', 'null']}, 'holding_url': {'type': 'string'}, 'share_change': {'type': ['number', 'null']}, 'superinvestor': {'type': ['string', 'null']}, 'institution_cik': {'type': 'string'}, 'previous_shares': {'type': ['number', 'null']}, 'institution_name': {'type': 'string'}, 'pct_of_portfolio': {'type': ['number', 'null']}, 'share_change_pct': {'type': ['number', 'null']}}, 'additionalProperties': False}}, 'sort': {'type': 'string'}, 'limit': {'type': 'number'}, 'period': {'type': 'string'}, 'shares': {'type': ['number', 'null']}, 'ticker': {'type': 'string'}, 'holders': {'type': 'number'}, 'quarter': {'type': 'string'}, 'has_more': {'type': 'boolean'}, 'previous': {'anyOf': [{'type': 'object', 'required': ['quarter', 'period', 'holders', 'shares', 'value_usd'], 'properties': {'period': {'type': 'string'}, 'shares': {'type': ['number', 'null']}, 'holders': {'type': 'number'}, 'quarter': {'type': 'string'}, 'value_usd': {'type': ['number', 'null']}}, 'additionalProperties': False}, {'type': 'null'}]}, 'value_usd': {'type': ['number', 'null']}, 'split_factor': {'type': ['number', 'null'], 'description': 'Stock split between previous_quarter and quarter: new shares per old share (10 = 10-for-1 split, 0.1 = 1-for-10 reverse split); null when there was none.'}, 'previous_quarter': {'type': 'string'}, 'changes_available': {'type': 'boolean'}, 'in_progress_quarter': {'type': ['string', 'null']}, 'latest_complete_quarter': {'type': 'string'}}, 'additionalProperties': False}
get_superinvestor_activity
Superinvestor quarterly buys and sells
What the curated superinvestors bought and sold in one quarter according to 13F, compared with the previous calendar quarter (default: the latest complete quarter). Without superinvestor_cik: most_bought (stocks the most superinvestors opened or added to), most_sold (reduced or sold out) and per-superinvestor counts of new/added/reduced/sold-out positions. With superinvestor_cik: that superinvestor's individual moves grouped by action, largest positions first (shares_change_pct in percent for added and reduced). Only superinvestors that filed both quarters are compared; added and reduced are decided by share count, not value, and when a stock split between the two quarters the previous share count is converted first (split_factor). Securities are merged by ticker (CUSIP when there is none). 13F is filed up to 45 days after quarter end.
읽기 전용
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 50, 'minimum': 1, 'description': 'Maximum rows per list (1-50, default 25).'}, 'quarter': {'type': 'string', 'maxLength': 12, 'description': 'Quarter to compare with the previous calendar quarter, e.g. 2026-q2. Default: the latest complete quarter that can be compared.'}, 'superinvestor_cik': {'type': 'string', 'pattern': '^(CIK)?\\d{1,10}$', 'description': "Show this superinvestor's individual moves instead of the cross-superinvestor summary."}}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['quarter', 'period', 'previous_quarter', 'superinvestors_compared', 'url', 'most_bought', 'most_sold', 'by_superinvestor', 'superinvestor'], 'properties': {'url': {'type': 'string'}, 'period': {'type': 'string'}, 'quarter': {'type': 'string'}, 'most_sold': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['ticker', 'cusip', 'name_of_issuer', 'title_of_class', 'url', 'superinvestors', 'reduced_positions', 'sold_out_positions'], 'properties': {'url': {'type': ['string', 'null']}, 'cusip': {'type': 'string'}, 'ticker': {'type': ['string', 'null']}, 'name_of_issuer': {'type': ['string', 'null']}, 'superinvestors': {'type': 'number'}, 'title_of_class': {'type': ['string', 'null']}, 'reduced_positions': {'type': 'number'}, 'sold_out_positions': {'type': 'number'}}, 'additionalProperties': False}}, {'type': 'null'}]}, 'most_bought': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['ticker', 'cusip', 'name_of_issuer', 'title_of_class', 'url', 'superinvestors', 'new_positions', 'added_positions'], 'properties': {'url': {'type': ['string', 'null']}, 'cusip': {'type': 'string'}, 'ticker': {'type': ['string', 'null']}, 'new_positions': {'type': 'number'}, 'name_of_issuer': {'type': ['string', 'null']}, 'superinvestors': {'type': 'number'}, 'title_of_class': {'type': ['string', 'null']}, 'added_positions': {'type': 'number'}}, 'additionalProperties': False}}, {'type': 'null'}]}, 'superinvestor': {'anyOf': [{'type': 'object', 'required': ['cik', 'name', 'manager', 'filed_current', 'filed_previous', 'note', 'value_usd', 'counts', 'new', 'added', 'reduced', 'sold_out', 'url'], 'properties': {'cik': {'type': 'string'}, 'new': {'type': 'array', 'items': {'type': 'object', 'required': ['ticker', 'cusip', 'name_of_issuer', 'title_of_class', 'url', 'shares_change_pct', 'split_factor'], 'properties': {'url': {'type': ['string', 'null']}, 'cusip': {'type': 'string'}, 'ticker': {'type': ['string', 'null']}, 'split_factor': {'type': ['number', 'null'], 'description': 'Stock split between the two quarters that shares_change_pct was converted for: new shares per old share (10 = 10-for-1, 0.1 = 1-for-10 reverse split); null when there was none.'}, 'name_of_issuer': {'type': ['string', 'null']}, 'title_of_class': {'type': ['string', 'null']}, 'shares_change_pct': {'type': ['number', 'null']}}, 'additionalProperties': False}}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'note': {'type': ['string', 'null']}, 'added': {'type': 'array', 'items': {'type': 'object', 'required': ['ticker', 'cusip', 'name_of_issuer', 'title_of_class', 'url', 'shares_change_pct', 'split_factor'], 'properties': {'url': {'type': ['string', 'null']}, 'cusip': {'type': 'string'}, 'ticker': {'type': ['string', 'null']}, 'split_factor': {'type': ['number', 'null'], 'description': 'Stock split between the two quarters that shares_change_pct was converted for: new shares per old share (10 = 10-for-1, 0.1 = 1-for-10 reverse split); null when there was none.'}, 'name_of_issuer': {'type': ['string', 'null']}, 'title_of_class': {'type': ['string', 'null']}, 'shares_change_pct': {'type': ['number', 'null']}}, 'additionalProperties': False}}, 'counts': {'type': 'object', 'required': ['new', 'added', 'reduced', 'sold_out'], 'properties': {'new': {'type': 'number'}, 'added': {'type': 'number'}, 'reduced': {'type': 'number'}, 'sold_out': {'type': 'number'}}, 'additionalProperties': False}, 'manager': {'type': ['string', 'null']}, 'reduced': {'type': 'array', 'items': {'type': 'object', 'required': ['ticker', 'cusip', 'name_of_issuer', 'title_of_class', 'url', 'shares_change_pct', 'split_factor'], 'properties': {'url': {'type': ['string', 'null']}, 'cusip': {'type': 'string'}, 'ticker': {'type': ['string', 'null']}, 'split_factor': {'type': ['number', 'null'], 'description': 'Stock split between the two quarters that shares_change_pct was converted for: new shares per old share (10 = 10-for-1, 0.1 = 1-for-10 reverse split); null when there was none.'}, 'name_of_issuer': {'type': ['string', 'null']}, 'title_of_class': {'type': ['string', 'null']}, 'shares_change_pct': {'type': ['number', 'null']}}, 'additionalProperties': False}}, 'sold_out': {'type': 'array', 'items': {'type': 'object', 'required': ['ticker', 'cusip', 'name_of_issuer', 'title_of_class', 'url', 'shares_change_pct', 'split_factor'], 'properties': {'url': {'type': ['string', 'null']}, 'cusip': {'type': 'string'}, 'ticker': {'type': ['string', 'null']}, 'split_factor': {'type': ['number', 'null'], 'description': 'Stock split between the two quarters that shares_change_pct was converted for: new shares per old share (10 = 10-for-1, 0.1 = 1-for-10 reverse split); null when there was none.'}, 'name_of_issuer': {'type': ['string', 'null']}, 'title_of_class': {'type': ['string', 'null']}, 'shares_change_pct': {'type': ['number', 'null']}}, 'additionalProperties': False}}, 'value_usd': {'type': ['number', 'null']}, 'filed_current': {'type': 'boolean'}, 'filed_previous': {'type': 'boolean'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'by_superinvestor': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['cik', 'name', 'manager', 'filed_current', 'filed_previous', 'value_usd', 'new', 'added', 'reduced', 'sold_out', 'url'], 'properties': {'cik': {'type': 'string'}, 'new': {'type': 'number'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'added': {'type': 'number'}, 'manager': {'type': ['string', 'null']}, 'reduced': {'type': 'number'}, 'sold_out': {'type': 'number'}, 'value_usd': {'type': ['number', 'null']}, 'filed_current': {'type': 'boolean'}, 'filed_previous': {'type': 'boolean'}}, 'additionalProperties': False}}, {'type': 'null'}]}, 'previous_quarter': {'type': 'string'}, 'superinvestors_compared': {'type': 'number'}}, 'additionalProperties': False}
list_superinvestors
Curated superinvestors
The curated list of superinvestors (well-known long-term investors such as Warren Buffett's Berkshire Hathaway, Bill Ackman's Pershing Square, Li Lu's Himalaya Capital) with their latest 13F quarter: portfolio value in USD (long positions, excluding options), number of positions, filing date, and the 3 largest holdings with pct_of_portfolio (percent). Sorted by portfolio value. Names are in English with Chinese names in name_zh and manager_zh. source_cik is set when the latest quarter was filed under a predecessor CIK (pass it to get_institution to see that quarter). Use get_institution(cik) for full holdings and get_superinvestor_activity for what they bought and sold in a quarter.
읽기 전용
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['count', 'superinvestors', 'url'], 'properties': {'url': {'type': 'string'}, 'count': {'type': 'number'}, 'superinvestors': {'type': 'array', 'items': {'type': 'object', 'required': ['cik', 'name', 'name_zh', 'manager', 'manager_zh', 'style', 'quarter', 'value_usd', 'positions', 'filed_date', 'source_cik', 'top_holdings', 'url'], 'properties': {'cik': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'style': {'type': 'array', 'items': {'type': 'string'}}, 'manager': {'type': ['string', 'null']}, 'name_zh': {'type': ['string', 'null']}, 'quarter': {'type': ['string', 'null']}, 'positions': {'type': ['number', 'null']}, 'value_usd': {'type': ['number', 'null']}, 'filed_date': {'type': ['string', 'null']}, 'manager_zh': {'type': ['string', 'null']}, 'source_cik': {'type': ['string', 'null']}, 'top_holdings': {'type': 'array', 'items': {'type': 'object', 'required': ['ticker', 'name', 'pct_of_portfolio'], 'properties': {'name': {'type': ['string', 'null']}, 'ticker': {'type': ['string', 'null']}, 'pct_of_portfolio': {'type': ['number', 'null']}}, 'additionalProperties': False}}}, 'additionalProperties': False}}}, 'additionalProperties': False}
search
Search stocks, institutions, insiders and politicians
Find US stocks, 13F institutions (including the curated superinvestors, matched by fund or manager name, e.g. 'Buffett' or 'Pershing', and large asset managers matched by their common name, e.g. 'Fidelity' finds FMR LLC and 'Capital Group' its three 13F filers), corporate insiders (Form 4 reporting persons) and politicians (members of the U.S. Congress: House and Senate members who served in 2019 or later, by name, nickname, last name or bioguide ID; current members first) by ticker or name. Returns up to `limit` matches per group, best match first, with the identifier the other tools take: `ticker` for get_stock, get_insider_trades, get_stock_13f_holders, get_major_holders and the other stock filters; institution `cik` for get_institution and get_ownership_filings(filer_cik); insider `cik` for get_insider_trades(insider_cik) and get_form144_notices(seller_cik); politician `bioguide` for get_politician and get_politician_trades(politician). Names are SEC names in English (insiders appear as 'Cook Timothy D'); superinvestors and those asset managers also match their Chinese names. Tickers match exactly or by prefix; a CIK (e.g. 1067983) or a 9-character CUSIP (e.g. 037833100) matches exactly; names need at least 2 characters. Stocks carry the company in `name`; `detail` is the manager for superinvestors ('13F filer' for other institutions) and the latest title and company for insiders. Politicians have party (D, R, I), chamber (house or senate), state, district (House seats; 0 is at-large) and in_office. Every item has its livermore.club `url`.
읽기 전용
멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 5, 'maximum': 20, 'minimum': 1, 'description': 'Maximum matches per group (1-20, default 5).'}, 'query': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Ticker, company, fund, manager, person or politician name, CIK or CUSIP.'}}}
출력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query', 'stocks', 'institutions', 'insiders', 'politicians'], 'properties': {'query': {'type': 'string'}, 'stocks': {'type': 'array', 'items': {'type': 'object', 'required': ['ticker', 'name', 'active', 'url'], 'properties': {'url': {'type': 'string'}, 'name': {'type': ['string', 'null']}, 'active': {'type': 'boolean', 'description': "false when the ticker is no longer on the SEC's list of tickers (the company was delisted or changed its ticker); its page and history are still available."}, 'ticker': {'type': 'string'}}, 'additionalProperties': False}}, 'insiders': {'type': 'array', 'items': {'type': 'object', 'required': ['cik', 'name', 'detail', 'url'], 'properties': {'cik': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'detail': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'politicians': {'type': 'array', 'items': {'type': 'object', 'required': ['bioguide', 'name', 'party', 'chamber', 'state', 'district', 'in_office', 'url'], 'properties': {'url': {'type': 'string'}, 'name': {'type': 'string'}, 'party': {'type': ['string', 'null']}, 'state': {'type': 'string'}, 'chamber': {'enum': ['house', 'senate'], 'type': 'string'}, 'bioguide': {'type': 'string'}, 'district': {'type': ['number', 'null']}, 'in_office': {'type': 'boolean'}}, 'additionalProperties': False}}, 'institutions': {'type': 'array', 'items': {'type': 'object', 'required': ['cik', 'name', 'detail', 'url'], 'properties': {'cik': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'detail': {'type': ['string', 'null']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
기록
최근 도구 변경
삭제됨
get_congress_trades
2026년 10월 2일 2:40 AM
삭제됨
get_congress_member
2026년 10월 2일 2:40 AM
변경됨
get_data_coverage
2026년 10월 2일 2:40 AM
추가됨
get_politician
2026년 10월 2일 2:40 AM
추가됨
get_politician_trades
2026년 10월 2일 2:40 AM
변경됨
get_form144_notices
2026년 10월 2일 2:40 AM
변경됨
search
2026년 10월 2일 2:40 AM
변경됨
get_data_coverage
2026년 9월 30일 2:40 AM
추가됨
get_congress_member
2026년 9월 30일 2:40 AM
추가됨
get_congress_trades
2026년 9월 30일 2:40 AM
추가됨
get_form144_notices
2026년 9월 30일 2:40 AM
추가됨
get_ownership_filings
2026년 9월 30일 2:40 AM
추가됨
get_major_holders
2026년 9월 30일 2:40 AM
변경됨
search
2026년 9월 30일 2:40 AM
추가됨
get_data_coverage
2026년 9월 28일 2:40 AM
추가됨
get_superinvestor_activity
2026년 9월 28일 2:40 AM
추가됨
list_superinvestors
2026년 9월 28일 2:40 AM
추가됨
get_institution
2026년 9월 28일 2:40 AM
추가됨
get_insider_lists
2026년 9월 28일 2:40 AM
추가됨
get_insider_trades
2026년 9월 28일 2:40 AM
추가됨
get_stock_13f_holders
2026년 9월 28일 2:40 AM
추가됨
get_stock
2026년 9월 28일 2:40 AM
추가됨
search
2026년 9월 28일 2:40 AM
탐색
유사한 MCP 서버
AlpineDataWorks Intelligence Server
com.alpinedataworks/adw-intelligence-server
Provides economic, market, supply-chain, real-estate, energy, consumer, labor, and other scored intelligence indices with histori…
Stratalize Finance
com.stratalize/finance
Provides financial, macroeconomic, banking, credit, commodities, M&A, ESG, labor, and regulatory benchmarks for analysis and plan…
Valuein — SEC EDGAR Fundamentals & Smart-Money Data
io.github.valuein/mcp-sec-edgar
Provides point-in-time SEC EDGAR fundamentals, filings, ownership signals, financial analysis, valuation models, research reports…
equibles
io.github.daniel3303/equibles
Provides equity and market research tools covering SEC filings, company financials, portfolios, prices, options, macroeconomic da…
DFX Real Estate Intelligence
io.github.Capital-W-Holdings/us-property-parcel-real-estate-debt
Provides US commercial real estate, parcel, debt maturity, bank CRE exposure, private capital, investor, ownership, occupancy, an…
simplefunctions
io.github.spfunctions/simplefunctions
Provides prediction-market data, thesis analysis, market signals, portfolio tracking, and automated intent-based trading workflow…
EventTrader MCP
com.cymetica/event-trader-mcp
Provides prediction-market research and trading capabilities, including real-time event-market data, CLOB execution paths, fund i…
Signal8
ai.signal8/mcp
Provides SEC filings, dilution data, insider and institutional ownership, and political-trade data.