> ## Documentation Index > Fetch the complete documentation index at: https://api.unusualwhales.com/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > API requests use the base URL https://api.unusualwhales.com and require a bearer token in the `Authorization` header (`Authorization: Bearer `). Create and manage API tokens at https://unusualwhales.com/dashboard/api. > For live market data inside an AI tool, use the Unusual Whales MCP server at https://unusualwhales.com/public-api/mcp. > Instructions for agents using Unusual Whales tools: https://unusualwhales.com/skill.md # List of Institutions > Returns a list of institutions. WARNING: An institution's 13F reporting can move to a different CIK. Check the `succession` field of each row before you request holdings, sectors or activity for an institution. Those endpoints return the data filed under one CIK and do not include quarters reported under a predecessor's or successor's CIK. If you are looking to build a database of insitutional positions use https://unusualwhales.com/skills/institutional.md **Succession** A succession is recorded when a filer that previously filed 13F holdings reports files a 13F notice (form 13F-NT) naming exactly one other manager, and that manager filed a 13F holdings report for the same quarter. From that quarter on, the other manager reports the filer's holdings. `effective_report_date` is the end date of that quarter in ISO format. - `succeeded_by` is the institution that took over this institution's reporting. Request its CIK for quarters on or after `succeeded_by.effective_report_date`. It is `null` if this institution's reporting has not moved. - `current_holder` is the last institution in the chain of successors. It is set only when the reporting moved again after `succeeded_by` took over, and it is `null` otherwise. It has no `effective_report_date`. - `predecessors` lists the institutions whose reporting this institution took over directly, oldest `effective_report_date` first. Request a predecessor's CIK for quarters before its `effective_report_date`. The array is empty when there are none. - `succession` is `null` when the institution has neither a successor nor predecessors. The field has one of five shapes. **A. No succession** ```json { "succession": null } ``` **B. Succeeded.** Starting with the quarter ending 2026-06-30, PERSHING SQUARE INC. reports the holdings of PERSHING SQUARE CAPITAL MANAGEMENT, L.P. This is the row of PERSHING SQUARE CAPITAL MANAGEMENT, L.P. ```json { "succession": { "succeeded_by": { "name": "PERSHING SQUARE INC.", "cik": "0002026053", "effective_report_date": "2026-06-30" }, "current_holder": null, "predecessors": [] } } ``` **C. Succeeded, and the holdings moved again.** Starting with the quarter ending 2017-06-30, BTG PACTUAL GLOBAL ASSET MANAGEMENT LTD reported this institution's holdings. They later moved to BTG PACTUAL ASSET MANAGEMENT US LLC, the last institution in the chain. Request `current_holder.cik` for the latest quarters. ```json { "succession": { "succeeded_by": { "name": "BTG PACTUAL GLOBAL ASSET MANAGEMENT LTD", "cik": "0001567992", "effective_report_date": "2017-06-30" }, "current_holder": { "name": "BTG PACTUAL ASSET MANAGEMENT US LLC", "cik": "0001569579" }, "predecessors": [] } } ``` **D. Took over another filer.** This is the row of PERSHING SQUARE INC. It reports the holdings of PERSHING SQUARE CAPITAL MANAGEMENT, L.P. starting with the quarter ending 2026-06-30. Holdings for earlier quarters are filed under CIK 0001336528. ```json { "succession": { "succeeded_by": null, "current_holder": null, "predecessors": [ { "name": "PERSHING SQUARE CAPITAL MANAGEMENT, L.P.", "cik": "0001336528", "effective_report_date": "2026-06-30" } ] } } ``` **E. Both sides at once.** This institution took over the reporting of BTG PACTUAL ASSET MANAGEMENT S.A. DTVM starting with the quarter ending 2017-06-30, and handed its own reporting to BTG PACTUAL ASSET MANAGEMENT US LLC starting with the quarter ending 2024-06-30. `current_holder` is `null` because BTG PACTUAL ASSET MANAGEMENT US LLC has not handed its reporting on. ```json { "succession": { "succeeded_by": { "name": "BTG PACTUAL ASSET MANAGEMENT US LLC", "cik": "0001569579", "effective_report_date": "2024-06-30" }, "current_holder": null, "predecessors": [ { "name": "BTG PACTUAL ASSET MANAGEMENT S.A. DTVM", "cik": "0001569785", "effective_report_date": "2017-06-30" } ] } } ``` ## OpenAPI ````yaml /openapi.yaml get /api/institutions openapi: 3.0.0 info: description: > For API Support or any questions email: support@unusualwhales.com Documentation for the official [UnusualWhales](https://unusualwhales.com) api ## Startup Tier Building a product on our data? Get started immediately with our self-serve Startup tier at $750/mo — 500 req/min, 80K daily requests, 90-day lookback, and commercial use included. Annual plan available at $7,500/yr (2 months free) with 1,000 req/min and 10 concurrent requests for market-open bursts. [Start building →](https://unusualwhales.com/checkout?plan=enterprise_startup&interval=monthly) Need Kafka streaming? Our Startup + Kafka tier at $3,000/mo adds real-time Kafka cluster access. Annual plan available at $30,000/yr (2 months free) with the same 1,000 req/min burst allowance. [Start building →](https://unusualwhales.com/checkout?plan=enterprise_startup_kafka&interval=monthly) ## Enterprise/Professional Subscribers For custom enterprise pricing, redistribution licenses, or bespoke solutions, email [oskar@unusualwhales.com, enterprise@unusualwhales.com or nastja.petrovic@unusualwhales.com](mailto:oskar@unusualwhales.com?cc=enterprise@unusualwhales.com,nastja.petrovic@unusualwhales.com). ## Changelog # 2026.09.28 - The websocket documentation moved to [https://api.unusualwhales.com/docs/websocket](https://api.unusualwhales.com/docs/websocket), with one page per channel. REST endpoints that serve the same data as a websocket channel link to that channel's page. # 2026.09.21 - Added a new websocket channel [`stock_screener`](https://api.unusualwhales.com/docs/websocket/stock-screener). It streams the latest stock screener row of every ticker and is the live counterpart of [`/screener/stocks`](https://api.unusualwhales.com/docs/operations/PublicApi.ScreenerController.stock_screener). # 2026.09.12 - Added a new websocket channel [`ta_1d_live:{TICKER}`](https://api.unusualwhales.com/docs/websocket/technical-analysis-indicators). The channel streams technical-analysis indicator values (moving averages, RSI, MACD, Bollinger bands, ADX, Aroon, ATR, CCI, MFI, OBV, stochastics and Williams %R) computed on daily candles for one ticker. During regular trading hours it resends the day that is still forming as the price moves, so the newest message for a `date` replaces the ones before it. An indicator reads as `null` until enough daily history exists to compute it. The `1d` in the name is the candle interval and `live` means the values track the open session. # 2026.09.04 - Added new websocket channels [`quotes` and `quotes:{TICKER}`](https://api.unusualwhales.com/docs/websocket/stock-quotes). They stream the live best bid and ask - for every ticker at once, or for a single ticker - and are the live counterpart of [`/stock/:ticker/quote`](https://api.unusualwhales.com/docs/operations/PublicApi.StockQuoteController.show). # 2026.09.01 - Added a global [`greeks`](https://api.unusualwhales.com/docs/websocket/greeks) websocket channel. It streams the same per-contract option greeks as `greeks:`, but for every underlying at once. This is a high volume firehose - prefer the per-ticker channel unless you need the full tape. # 2026.08.30 - MCP now advertises build guidance: `instructions` on initialize; builder prompts `build_dashboard_app`, `build_confluence_alert`, `build_trading_bot`, `build_data_stream`, `start_from_example`, and `setup_api_project`; tools `get_build_recipe` and `get_api_examples` (scripts from [https://github.com/unusual-whales/api-examples](https://github.com/unusual-whales/api-examples)); and `resources/list` / `resources/templates/list` / `resources/read` for playbooks and example files. # 2026.08.28 - Added a new websocket channel [`risk_reversal_skew`](https://api.unusualwhales.com/docs/websocket/risk-reversal-skew). The channel streams live 25- and 10-delta risk reversal skew (put implied volatility minus call implied volatility) per expiry across every ticker, the live counterpart of [`/stock/:ticker/historical-risk-reversal-skew`](https://api.unusualwhales.com/docs/operations/PublicApi.TickerController.historical_risk_reversal_skew). The channel is global only; there is no per-ticker variant. # 2026.08.22 - Updated [`/stock/:ticker/gex-levels`](https://api.unusualwhales.com/docs/operations/PublicApi.TickerController.gex_levels) to derive its levels from directionalized volume instead of a cumulative total over the static open-interest snapshot. - Added `date`, `time`, `source`, and `nearby_flips` to the [`/stock/:ticker/gex-levels`](https://api.unusualwhales.com/docs/operations/PublicApi.TickerController.gex_levels) response. `nearby_flips` lists the five zero-gamma crossings nearest spot, ordered by distance from it. `time` is when the underlying exposure snapshot was calculated. # 2026.08.21 - Added new websocket channels [`interpolated_iv` and `interpolated_iv:TICKER`](https://api.unusualwhales.com/docs/websocket/interpolated-iv). The channels stream interpolated implied volatility and expected moves at fixed horizons (1-365 trading days), the live counterpart of [`/stock/:ticker/interpolated-iv`](https://api.unusualwhales.com/docs/operations/PublicApi.TickerController.interpolated_iv). - Added new websocket channels [`iv_term_structure` and `iv_term_structure:TICKER`](https://api.unusualwhales.com/docs/websocket/iv-term-structure). The channels stream ATM implied volatility and expected moves per real option expiry — the raw entries behind `interpolated_iv` — the live counterpart of [`/stock/:ticker/volatility/term-structure`](https://api.unusualwhales.com/docs/operations/PublicApi.TickerController.implied_volatility_term_structure). # 2026.04.30 Added a new advanced-tier endpoint group. All routes below require API Advanced, Enterprise Startup, Enterprise Startup + Kafka, or Enterprise tier. ### Company fundamentals - Added [`/companies/:ticker/profile`](https://api.unusualwhales.com/docs/operations/PublicApi.CompaniesController.profile) for sector, industry, market cap, P/E, EPS, dividend yield, analyst targets, 52-week range, moving averages, and the full analyst rating breakdown. - Added [`/companies/:ticker/dividends`](https://api.unusualwhales.com/docs/operations/PublicApi.CompaniesController.dividends) for historical dividend events. - Added [`/companies/:ticker/splits`](https://api.unusualwhales.com/docs/operations/PublicApi.CompaniesController.splits) for historical stock-split events. - Added [`/companies/:ticker/earnings-estimates`](https://api.unusualwhales.com/docs/operations/PublicApi.CompaniesController.earnings_estimates) for forward analyst earnings and revenue estimates by quarter and year. - Added [`/companies/:ticker/transcripts/:quarter`](https://api.unusualwhales.com/docs/operations/PublicApi.CompaniesController.transcript) for earnings-call transcripts with speakers, statements, and per-statement sentiment. - Added [`/companies/listings`](https://api.unusualwhales.com/docs/operations/PublicApi.IntelController.listings) for the master list of US-traded securities (active or delisted). ### Macro - Added [`/commodities/:name`](https://api.unusualwhales.com/docs/operations/PublicApi.CommoditiesController.show) for long-running price series across WTI, Brent, natural gas, copper, aluminum, wheat, corn, cotton, sugar, coffee, and the global commodities index. - Added [`/economy/:indicator`](https://api.unusualwhales.com/docs/operations/PublicApi.EconomyController.show) for US economic indicator series (GDP, GDP per capita, treasury yield, fed funds rate, CPI, inflation, retail sales, durables, unemployment, payrolls). ### Forex - Added [`/forex/rate`](https://api.unusualwhales.com/docs/operations/PublicApi.ForexController.rate) for live FX spot rates with bid and ask. - Added [`/forex/intraday`](https://api.unusualwhales.com/docs/operations/PublicApi.ForexController.intraday) for 1min through 60min FX OHLC bars. - Added [`/forex/history`](https://api.unusualwhales.com/docs/operations/PublicApi.ForexController.history) for daily, weekly, and monthly FX OHLC bars. ### Digital currencies - Added [`/digital-currencies/intraday`](https://api.unusualwhales.com/docs/operations/PublicApi.DigitalCurrenciesController.intraday) for intraday OHLC bars priced against a fiat market. - Added [`/digital-currencies/history`](https://api.unusualwhales.com/docs/operations/PublicApi.DigitalCurrenciesController.history) for daily, weekly, and monthly OHLC bars. ### Market intel and analytics - Added [`/market/movers`](https://api.unusualwhales.com/docs/operations/PublicApi.IntelController.movers) for pre-ranked top gainers, top losers, and most actively traded US tickers. - Added [`/calendar/ipo`](https://api.unusualwhales.com/docs/operations/PublicApi.IntelController.ipo_calendar) for upcoming IPOs over the next 3 months. - Added [`/analytics/window`](https://api.unusualwhales.com/docs/operations/PublicApi.IntelController.analytics_window) for fixed-window statistical analytics across baskets of tickers (mean, stddev, correlation, drawdown, autocorrelation, covariance, and more). - Added [`/analytics/sliding`](https://api.unusualwhales.com/docs/operations/PublicApi.IntelController.analytics_sliding) for sliding-window statistical analytics. ### Congressional unusual trades (scope `unusual-trades`) - Added [`/congress/unusual-trades`](https://api.unusualwhales.com/docs/operations/PublicApi.UnusualTradesController.recent) for unusual congressional trades filtered by reason tag (committee_conflict, first_person_to_trade, low_marketcap, unusual_industry, unusually_large_trade, fec_donation_conflict). - Added [`/congress/unusual-trades/by-tickers`](https://api.unusualwhales.com/docs/operations/PublicApi.UnusualTradesController.by_tickers) with ticker, transaction type, date range, and politician filters. - Added [`/congress/unusual-trades/chart-data`](https://api.unusualwhales.com/docs/operations/PublicApi.UnusualTradesController.chart_data) returning trade points with SPY benchmark closes. - Added [`/congress/unusual-trades/stats`](https://api.unusualwhales.com/docs/operations/PublicApi.UnusualTradesController.stats) for aggregate overview statistics. ### Private markets (scope `private-markets`) - Added [`/private-markets/companies`](https://api.unusualwhales.com/docs/operations/PublicApi.PrivateMarketsController.companies) for the full Nasdaq Private Markets company list with sector and name filters. - Added [`/private-markets/companies/:npm_ticker`](https://api.unusualwhales.com/docs/operations/PublicApi.PrivateMarketsController.company_profile) for the company profile with latest price, total funding, and investor count. - Added [`/private-markets/companies/:npm_ticker/funding`](https://api.unusualwhales.com/docs/operations/PublicApi.PrivateMarketsController.funding) for funding round history. - Added [`/private-markets/companies/:npm_ticker/investors`](https://api.unusualwhales.com/docs/operations/PublicApi.PrivateMarketsController.investors) for disclosed investors. - Added [`/private-markets/companies/:npm_ticker/management`](https://api.unusualwhales.com/docs/operations/PublicApi.PrivateMarketsController.management) for disclosed leadership. - Added [`/private-markets/companies/:npm_ticker/pricing`](https://api.unusualwhales.com/docs/operations/PublicApi.PrivateMarketsController.pricing) for historical implied per-share pricing. - Added [`/private-markets/investors`](https://api.unusualwhales.com/docs/operations/PublicApi.PrivateMarketsController.top_investors) for top investors ranked by distinct company count. - Added [`/private-markets/investors/:name`](https://api.unusualwhales.com/docs/operations/PublicApi.PrivateMarketsController.investor_profile) for an investor's portfolio. - Added [`/private-markets/search`](https://api.unusualwhales.com/docs/operations/PublicApi.PrivateMarketsController.search) for substring search across companies and investors. ### MCP - Added 5 premium MCP catalogs covering the new endpoints: `uw_companies_extras`, `uw_macro`, `uw_forex`, `uw_digital_currencies`, `uw_intel`. Plus `uw_unusual_trades` and `uw_private_markets` for the scope-gated catalogs above. - Premium MCP catalogs and individual premium commands (`uw_stock.ownership`, `uw_flow.full_tape`, `uw_politicians`) are now hidden by default. Operators opt in via `UW_ENABLE_PREMIUM_TOOLS=true` (all on) or `UW_PREMIUM_TOOLS=uw_companies_extras,uw_macro,...` (per-tool allowlist supporting `` or `.` form). # 2026.04.29 - Added MCP tool `get_short_volume_ratio_by_exchange` for [`/shorts/:ticker/volumes-by-exchange`](https://api.unusualwhales.com/docs/operations/PublicApi.ShortController.short_volume_by_exchange) data. - Added MCP tool `get_short_volume_ratio_by_ticker` for [`/shorts/:ticker/volume-and-ratio`](https://api.unusualwhales.com/docs/operations/PublicApi.ShortController.short_volume_and_ratio) data. - Added MCP tool `get_short_screener` for [`/short_screener`](https://api.unusualwhales.com/docs/operations/PublicApi.ShortController.short_screener) - Added MCP tool `get_short_data_by_ticker` for [`/shorts/:ticker/data`](https://api.unusualwhales.com/docs/operations/PublicApi.ShortController.short_data) # 2026.04.14 - Enhanced MCP [`/api/mcp`](https://api.unusualwhales.com/docs) `tools/call` validation to reject unsupported arguments, missing required arguments, and invalid enum values before tool execution. - MCP tool errors now include retry guidance telling clients to inspect `tools/list` `inputSchema` and retry with supported arguments. # 2026.03.02 - Added authenticated MCP endpoint [`/api/mcp`](https://api.unusualwhales.com/docs) to expose existing AI tools to API subscribers using the same `Authorization: Bearer ` flow. - Supports MCP `initialize`, `tools/list`, and `tools/call` methods backed by the existing internal tool registry and execution pipeline. # 2026.01.20 - Updated interest-float endpoint with new version and deprecated old version - [`/shorts/:ticker/interest-float/v2`](https://api.unusualwhales.com/docs#/operations/PublicApi.ShortController.short_interest_and_float_v2) - Added interest-float search screener endpoint - [`/short_screener`](https://api.unusualwhales.com/docs#/operations/PublicApi.ShortController.short_screener) # 2025.09.23 - Added new websocket channels [`lit_trades`](https://api.unusualwhales.com/docs/websocket/lit-trades) and [`off_lit_trades`](https://api.unusualwhales.com/docs/websocket/off-lit-trades) to stream live lit (exchange-based) and off-lit (dark pool) trades respectively. # 2025.09.22 - Added `newer_than` and `older_than` time filtering parameters to [`/alerts`](https://api.unusualwhales.com/docs#/operations/PublicApi.AlertsController.alerts) endpoint with 14-day maximum lookback period for custom alerts queries # 2025.08.20 - Added [`/market/top-net-impact`](https://api.unusualwhales.com/docs#/operations/PublicApi.MarketController.top_net_impact) endpoint to get the top tickers by net premium (split between bullish and bearish). Supports filtering by `issue_types[]`, `date`, and `limit` (default 20, max 100). # 2025.06.18 - Added [`/market/:sector/sector-tide`](https://api.unusualwhales.com/docs#/operations/PublicApi.MarketController.sec_indst) endpoint to get the market tide for a specific sector # 2025.06.02 - Added [`/stock/:ticker/interpolated-iv`](https://api.unusualwhales.com/docs#/operations/PublicApi.TickerController.interpolated_iv) endpoint to get the interpolated iv for various days # 2025.05.29 - Added [`/option-contract/:id/volume-profile`](https://api.unusualwhales.com/docs#/operations/PublicApi.OptionContractController.volume_profile) endpoint to get the volume profile of an option contract (volume by fill price) # 2025.05.23 - Added [`/option-contract/:id/intraday`](https://api.unusualwhales.com/docs#/operations/PublicApi.OptionContractController.intraday) endpoint to get the volume, premium & OHLC for a contract in 1min ticks for a given trading day # 2025.05.07 - Added `prev_close_price` field to [`/stock/:ticker/stock-state`](https://api.unusualwhales.com/docs#/operations/PublicApi.TickerController.last_stock_state) endpoint to provide the previous close price. # 2025.04.30 - Enhanced [`/option-trades/full-tape/{date}`](https://api.unusualwhales.com/docs#/operations/PublicApi.OptionTradeController.full_tape) to allow users with `websocket` scope to access the last two trading days of data # 2025.04.23 - Added [`/net-flow/expiry`](https://api.unusualwhales.com/docs#/operations/PublicApi.NetFlowController.expiry) endpoint to track net premium flow by tide type, moneyness, and expiration categories. This powers charts like those found on the [zero-DTE dashboard](https://unusualwhales.com/zero-dte) # 2025.04.08 - Enhanced [`/market/correlations`](https://api.unusualwhales.com/docs#/operations/PublicApi.MarketController.correlations) endpoint with new date filtering options: `start_date` and `end_date` parameters to specify custom date ranges, complementing the existing `interval` parameter # 2025.03.23 - Updated [`/stock/{ticker}/net-prem-ticks`](https://api.unusualwhales.com/docs#/operations/PublicApi.TickerController.net_prem_ticks) endpoint to include `call_volume`, `put_volume`, `call_volume_bid_side`, `put_volume_bid_side`, `call_volume_ask_side`, `put_volume_ask_side` & `net_delta`. # 2025.03.10 - Added [`/news/headlines`](https://api.unusualwhales.com/docs#/operations/PublicApi.NewsController.headlines) endpoint to access financial news headlines with filtering capabilities - Added Shorts API endpoints: - [`/shorts/:ticker/data`](https://api.unusualwhales.com/docs#/operations/PublicApi.ShortController.short_data) - [`/shorts/:ticker/volumes-by-exchange`](https://api.unusualwhales.com/docs#/operations/PublicApi.ShortController.short_volume_by_exchange) - [`/shorts/:ticker/ftds`](https://api.unusualwhales.com/docs#/operations/PublicApi.ShortController.failures_to_deliver) - [`/shorts/:ticker/interest-float`](https://api.unusualwhales.com/docs#/operations/PublicApi.ShortController.short_interest_and_float) - [`/shorts/:ticker/volume-and-ratio`](https://api.unusualwhales.com/docs#/operations/PublicApi.ShortController.short_volume_and_ratio) # 2025.02.19 - The endpoint [`/stock/:ticker/spot-exposures/:expiry/strike`](https://api.unusualwhales.com/docs#/operations/PublicApi.TickerController.spot_exposures_by_strike_expiry) has been deprecated and been replaced by [`/stock/:ticker/spot-exposures/expiry-strike`](https://api.unusualwhales.com/docs#/operations/PublicApi.TickerController.spot_exposures_by_strike_expiry_v2) To migrate over replace all your `/api/stock/:ticker/spot-exposures/:expiry/strike` calls with `/api/stock/:ticker/spot-exposures/expiry-strike?expirations[]=expiry` # 2025.02.13 - The endpoint `/congress/recent-reports` has been removed as it returns the same data as `/congress/recent-trades`. # 2025.02.05 - Enhanced [`/market/fda-calendar`](https://api.unusualwhales.com/docs#/operations/PublicApi.MarketController.fda_calendar) with better FDA data, additional fields (notes, outcomes, sources), and filtering by company metrics # 2025.02.03 - Updated dark pool/off lit endpoints to allow filtering for size, premium & consolidated volume # 2025.01.22 - Added [`gex_strike_expiry:`](https://api.unusualwhales.com/docs/websocket/gex) channel to the websocket - Added `call_option_symbol` & `put_option_symbol` to [`/stock/{ticker}/greeks`](https://api.unusualwhales.com/docs#/operations/PublicApi.TickerController.greeks) # 2025.01.16 - Added [`/stock/:ticker/spot-exposures/:expiry/strike`](https://api.unusualwhales.com/docs#/operations/PublicApi.TickerController.spot_exposures_by_strike_expiry) # 2024.12.11 - Added [`/alerts/configuration`](https://api.unusualwhales.com/docs#/operations/PublicApi.AlertsController.configs) - Added [`/alerts`](https://api.unusualwhales.com/docs#/operations/PublicApi.AlertsController.alerts) This allows one to grab all the alerts that have been triggerd for any alert that one has configured. With an existing unusualwhales account you can view and configure alerts directly on the [website](https://unusualwhales.com/custom-alerts) # 2024.12.02 - Added [`/stock/:ticker/oi-per-strike`](https://api.unusualwhales.com/docs#/operations/PublicApi.TickerController.oi_per_strike) - Added [`/stock/:ticker/oi-per-expiry`](https://api.unusualwhales.com/docs#/operations/PublicApi.TickerController.oi_per_expiry) # 2024.11.19 - Improved all earnings endpoint # 2024.11.09 - Added `perc_of_total` & `perc_of_share_value` to [`/institution/:name/holdings`](https://api.unusualwhales.com/docs#/operations/PublicApi.InstitutionController.holdings) # 2024.10.30 - Added [`/stock/:ticker/nope`](https://api.unusualwhales.com/docs#/operations/PublicApi.TickerController.nope) # 2024.10.28 - Added [`/group-flow/:flow_group/greek-flow`](https://api.unusualwhales.com/docs#/operations/PublicApi.GroupFlowController.greek_flow) - Added [`/group-flow/:flow_group/greek-flow/:expiry`](https://api.unusualwhales.com/docs#/operations/PublicApi.GroupFlowController.greek_flow_expiry) - Added [`/stock/:ticker/greek-flow`](https://api.unusualwhales.com/docs#/operations/PublicApi.TickerController.greek_flow) - Added [`/stock/:ticker/greek-flow/:epxiry`](https://api.unusualwhales.com/docs#/operations/PublicApi.TickerController.greek_flow_expiry) # 2024.10.16 - Added etf inflow & outflow endpoint [`/etfs/:ticker/in_outflow`](PublicApi.EtfController.in_outflow) # 2024.10.15 - Added institutional latest filings endpoint [`/institution/latest_filings`](PublicApi.InstitutionController.latest_filings) - Added institutional ownership endpoint [`/institution/:ticker/ownership`](PublicApi.InstitutionController.ownership) # 2024.10.14 - Added 2 new fields: `days_of_oi_increases` & `days_of_vol_greater_than_oi` to [`/market/oi-change`](PublicApi.MarketController.oi_change) ``` days_of_oi_increases: The number of consecutive days that the open interest has increased for this contract. If on any day the open interest decreases or does not change the count will reset. days_of_vol_greater_than_oi: The number of consecutive days that the volume has been greater than the open interest for this contract. If on any day the volume is less than or equal to the open interest the count will reset. ```
# 2024.10.10 - Added institutional activity endpoint [`/institution/:name/activity`](PublicApi.InstitutionController.activity) # 2024.10.09 - Added institutional list endpoint [`institutions`](PublicApi.InstitutionController.list) - Added institutional holdings endpoint [`/institution/:name/holdings`](PublicApi.InstitutionController.holdings) - Added institutional sector exposure endpoint [`/institution/:name/sectors`](PublicApi.InstitutionController.sectors) # 2024.08.01 - Added new flow per strike intraday endpoint [`/stock/:ticker/flow-per-strike-intraday`](PublicApi.TickerController.flow_per_strike_intraday) # 2024.07.11 - Added new correlation endpoint [`/market/correlations?tickers=SPY,QQQ,JPM,BAC`](PublicApi.MarketController.correlations) # 2024.05.30 - Added the ability to filter [`/darkpool/:ticker`](PublicApi.DarkPoolController.darkpool_ticker) by timestamps through the two new query parameters `older_than` and `newer_than` # 2024.05.21 - Added directionalized volume fields to [`/stock/:ticker/spot-exposures`](PublicApi.TickerController.spot_exposures_one_minute) and [`/stock/:ticker/spot-exposures/strike`](PublicApi.TickerController.spot_exposures_by_strike) # 2024.05.17 - Added the channels `gex:TICKER` & `gex_strike:TICKER` to the [websocket](https://api.unusualwhales.com/docs/websocket) # 2024.05.07 - Added the ability to filter [`/option-trades/flow-alerts`](PublicApi.OptionTradeController.flow_alerts) by timestamps through the two new query parameters `older_than` and `newer_than` # 2024.05.06 - Added endpoint [`/stock/:ticker/stock-state`](PublicApi.TickerController.last_stock_state) to retrieve the last stock price & volume - Added endpoint [`/stock/:ticker/volatility/realized`](PublicApi.TickerController.realized_volatility) to retrieve a stock's realized volatility # 2024.05.03 - The data returned by /stock/:ticker/option-contracts has been limited to 500 results # 2024.05.02 - Added endpoint [`/market/:ticker/etf-tide`](PublicApi.MarketController.etf_tide) # 2024.05.01 - Added endpoint [`/stock/:ticker/spot-exposures/strike`](PublicApi.TickerController.spot_exposures_by_strike) - Added new channel [`price:TICKER`](https://api.unusualwhales.com/docs/websocket) to the websocket. The channel will push live price updates for the given ticker. # 2024.04.25 - Added endpoint [`/stock/:ticker/greek-exposure/strike`](PublicApi.TickerController.greek_exposure_by_strike) - Added endpoint [`/stock/:ticker/greek-exposure/expiry`](PublicApi.TickerController.greek_exposure_by_expiry) - Added endpoint [`/stock/:ticker/greek-exposure/strike-expiry`](PublicApi.TickerController.greek_exposure_by_strike_expiry) # 2024.03.28 - Fixed field name volatility -> risk_reversal for endpoint [`/stock/:ticker/historical_risk_reversal_skew`](PublicApi.TickerController.historical_risk_reversal_skew) # 2024.03.26 - Added endpoint [`/stock/:ticker/greeks`](PublicApi.TickerController.greeks) - Added endpoint [`/stock/:ticker/historical_risk_reversal_skew`](PublicApi.TickerController.historical_risk_reversal_skew) # 2024.03.23 - BREAKING CHANGE: Previously `/option-contract/:id/flow` would return the data as a json list. This has been now changed so that the endpoint returns the data in the format `{"data": [], "date": "2024-03-22"}`. Secondly, the endpoint will now only return data for a single trading day. # 2024.03.06 - Added endpoint [`/option-trades/flow-alerts`](PublicApi.OptionTradeController.flow_alerts) - Added flow-alerts streaming to the WebSocket. # 2024.03.04 - Added endpoint [`/stock/:ticker/max-pain`](https://api.unusualwhales.com/docs#/operations/PublicApi.TickerController.max_pain) # 2024.02.16 - Added new endpoint section [`Seasonality`](https://api.unusualwhales.com/docs#/operations/PublicApi.SeasonalityController.market_seasonality) with new endpoints: - [`/seasonality/market`](https://api.unusualwhales.com/docs#/operations/PublicApi.SeasonalityController.market_seasonality) - [`/seasonality/:month/performers`](https://api.unusualwhales.com/docs#/operations/PublicApi.SeasonalityController.month_performers) - [`/seasonality/:ticker/monthly`](https://api.unusualwhales.com/docs#/operations/PublicApi.SeasonalityController.monthly) - [`/seasonality/:ticker/year-month`](https://api.unusualwhales.com/docs#/operations/PublicApi.SeasonalityController.year_month) # 2024.02.07 - Added endpoints [`/stock/:ticker/expiry-breakdown`](https://api.unusualwhales.com/docs#/operations/PublicApi.OptionContractController.expiry_breakdown) & [`/stock/:ticker/option-contracts`](https://api.unusualwhales.com/docs#/operations/PublicApi.OptionContractController.option_contracts). These 2 endpoints allow access to the data located here: [https://unusualwhales.com/stock/AAPL/option-chains](https://unusualwhales.com/stock/AAPL/option-chains) title: UnusualWhales Api version: '1.0' servers: - url: https://api.unusualwhales.com variables: {} security: - authorization: [] tags: [] paths: /api/institutions: get: tags: - institution summary: List of Institutions description: > Returns a list of institutions. WARNING: An institution's 13F reporting can move to a different CIK. Check the `succession` field of each row before you request holdings, sectors or activity for an institution. Those endpoints return the data filed under one CIK and do not include quarters reported under a predecessor's or successor's CIK. If you are looking to build a database of insitutional positions use https://unusualwhales.com/skills/institutional.md **Succession** A succession is recorded when a filer that previously filed 13F holdings reports files a 13F notice (form 13F-NT) naming exactly one other manager, and that manager filed a 13F holdings report for the same quarter. From that quarter on, the other manager reports the filer's holdings. `effective_report_date` is the end date of that quarter in ISO format. - `succeeded_by` is the institution that took over this institution's reporting. Request its CIK for quarters on or after `succeeded_by.effective_report_date`. It is `null` if this institution's reporting has not moved. - `current_holder` is the last institution in the chain of successors. It is set only when the reporting moved again after `succeeded_by` took over, and it is `null` otherwise. It has no `effective_report_date`. - `predecessors` lists the institutions whose reporting this institution took over directly, oldest `effective_report_date` first. Request a predecessor's CIK for quarters before its `effective_report_date`. The array is empty when there are none. - `succession` is `null` when the institution has neither a successor nor predecessors. The field has one of five shapes. **A. No succession** ```json { "succession": null } ``` **B. Succeeded.** Starting with the quarter ending 2026-06-30, PERSHING SQUARE INC. reports the holdings of PERSHING SQUARE CAPITAL MANAGEMENT, L.P. This is the row of PERSHING SQUARE CAPITAL MANAGEMENT, L.P. ```json { "succession": { "succeeded_by": { "name": "PERSHING SQUARE INC.", "cik": "0002026053", "effective_report_date": "2026-06-30" }, "current_holder": null, "predecessors": [] } } ``` **C. Succeeded, and the holdings moved again.** Starting with the quarter ending 2017-06-30, BTG PACTUAL GLOBAL ASSET MANAGEMENT LTD reported this institution's holdings. They later moved to BTG PACTUAL ASSET MANAGEMENT US LLC, the last institution in the chain. Request `current_holder.cik` for the latest quarters. ```json { "succession": { "succeeded_by": { "name": "BTG PACTUAL GLOBAL ASSET MANAGEMENT LTD", "cik": "0001567992", "effective_report_date": "2017-06-30" }, "current_holder": { "name": "BTG PACTUAL ASSET MANAGEMENT US LLC", "cik": "0001569579" }, "predecessors": [] } } ``` **D. Took over another filer.** This is the row of PERSHING SQUARE INC. It reports the holdings of PERSHING SQUARE CAPITAL MANAGEMENT, L.P. starting with the quarter ending 2026-06-30. Holdings for earlier quarters are filed under CIK 0001336528. ```json { "succession": { "succeeded_by": null, "current_holder": null, "predecessors": [ { "name": "PERSHING SQUARE CAPITAL MANAGEMENT, L.P.", "cik": "0001336528", "effective_report_date": "2026-06-30" } ] } } ``` **E. Both sides at once.** This institution took over the reporting of BTG PACTUAL ASSET MANAGEMENT S.A. DTVM starting with the quarter ending 2017-06-30, and handed its own reporting to BTG PACTUAL ASSET MANAGEMENT US LLC starting with the quarter ending 2024-06-30. `current_holder` is `null` because BTG PACTUAL ASSET MANAGEMENT US LLC has not handed its reporting on. ```json { "succession": { "succeeded_by": { "name": "BTG PACTUAL ASSET MANAGEMENT US LLC", "cik": "0001569579", "effective_report_date": "2024-06-30" }, "current_holder": null, "predecessors": [ { "name": "BTG PACTUAL ASSET MANAGEMENT S.A. DTVM", "cik": "0001569785", "effective_report_date": "2017-06-30" } ] } } ``` operationId: PublicApi.InstitutionController.list parameters: - description: '' in: query name: name required: false schema: $ref: '#/components/schemas/Institution' - description: '' in: query name: min_total_value required: false schema: $ref: '#/components/schemas/MinValue' - description: '' in: query name: max_total_value required: false schema: $ref: '#/components/schemas/MaxValue' - description: '' in: query name: min_share_value required: false schema: $ref: '#/components/schemas/MinValue' - description: '' in: query name: max_share_value required: false schema: $ref: '#/components/schemas/MaxValue' - description: '' in: query name: tags[] required: false schema: $ref: '#/components/schemas/Institution_Tags' - description: '' in: query name: order required: false schema: $ref: '#/components/schemas/Institutional_List_Order_By' - description: '' in: query name: order_direction required: false schema: $ref: '#/components/schemas/OrderDirection' - description: '' in: query name: limit required: false schema: $ref: '#/components/schemas/Default_500_Max_500_Min_1' - description: '' in: query name: page required: false schema: $ref: '#/components/schemas/Page' responses: '200': content: application/json: schema: $ref: '#/components/schemas/Institution_Summary' description: '' '401': content: application/json: schema: $ref: '#/components/schemas/Authentication_Error' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/Forbidden_Error' description: Forbidden '422': content: application/json: schema: $ref: '#/components/schemas/Error_Message' description: Unprocessable Entity '500': content: text/plain: schema: $ref: >- #/components/schemas/Error_Message_on_an_internal_server_error. description: Internal Server Error callbacks: {} components: schemas: Institution: description: >- A large entity that manages funds and investments for others. Queryable by name or cik. example: VANGUARD GROUP INC or 0000102909 title: Institution type: string MinValue: description: The min value of the given field. example: '0.5' title: MinValue type: string MaxValue: description: The max value of the given field. example: '10.0' title: MaxValue type: string Institution_Tags: description: An array of institution tags example: - activist items: $ref: '#/components/schemas/Institution_Tag' title: Institution Tags type: array Institutional_List_Order_By: description: Optional columns to order the result by enum: - name - call_value - put_value - share_value - call_holdings - put_holdings - share_holdings - total_value - warrant_value - fund_value - pfd_value - debt_value - total_holdings - warrant_holdings - fund_holdings - pfd_holdings - debt_holdings - percent_of_total - date - buy_value - sell_value example: name title: Institutional List Order By type: string OrderDirection: default: desc description: Whether to sort descending or ascending. Descending by default. enum: - desc - asc example: asc title: OrderDirection type: string Default_500_Max_500_Min_1: default: 500 description: >- How many items to return. Max: 500. Min: 1. Returns up to 500 when omitted. example: 10 maximum: 500 minimum: 1 title: Default 500 Max 500 Min 1 type: integer Page: description: Page number (use with limit). Starts on page 0. example: 1 title: Page type: integer Institution_Summary: description: The summary data for an institution. example: data: - buy_value: '359232.0' call_holdings: '359232.0' call_value: '359232.0' cik: '0001791786' date: '2024-12-31T00:00:00.000Z' debt_holdings: '359232.0' debt_value: '359232.0' description: >- Elliott Management Corporation is an American investment management firm. It is also one of the largest activist funds in the world. filing_date: '2024-10-01T00:00:00.000Z' founder_img_url: >- https://storage.googleapis.com/uwassets/institution-img/ELLIOTT%20INVESTMENT%20MANAGEMENT%20L.P.%20Paul%20Singer.jpg fund_holdings: '359232.0' fund_value: '359232.0' is_hedge_fund: true logo_url: >- https://storage.googleapis.com/uwassets/institution-img/ELLIOTT%20INVESTMENT%20MANAGEMENT%20L.P.%20logo.webp name: ELLIOTT INVESTMENT MANAGEMENT L.P. people: - Paul Singer pfd_holdings: '359232.0' pfd_value: '359232.0' put_holdings: '359232.0' put_value: '359232.0' sell_value: '359232.0' share_holdings: '359232.0' share_value: '359232.0' short_name: Elliott Investment Management succession: null tags: - activist total_value: '359232.0' warrant_holdings: '359232.0' warrant_value: '359232.0' website: https://elliott.com properties: buy_value: $ref: '#/components/schemas/Buy_Value' call_holdings: $ref: '#/components/schemas/Call_Holding_Units' call_value: $ref: '#/components/schemas/Call_Value' cik: $ref: '#/components/schemas/CIK' date: $ref: '#/components/schemas/Report_Period_End_Date' debt_holdings: $ref: '#/components/schemas/Debt_Holding_Units' debt_value: $ref: '#/components/schemas/Debt_Value' description: $ref: '#/components/schemas/Description' filing_date: $ref: '#/components/schemas/Filing_Date' founder_img_url: $ref: '#/components/schemas/Founder_Image_URL' fund_holdings: $ref: '#/components/schemas/Fund_Holding_Units' fund_value: $ref: '#/components/schemas/Fund_Value' is_hedge_fund: $ref: '#/components/schemas/Is_Hedge_Fund' logo_url: $ref: '#/components/schemas/Logo_URL' name: $ref: '#/components/schemas/Name' people: $ref: '#/components/schemas/People' pfd_holdings: $ref: '#/components/schemas/Preferred_Share_Holding_Units' pfd_value: $ref: '#/components/schemas/Preferred_Share_Value' put_holdings: $ref: '#/components/schemas/Put_Holding_Units' put_value: $ref: '#/components/schemas/Put_Value' sell_value: $ref: '#/components/schemas/Sell_Value' share_value: $ref: '#/components/schemas/Share_Value' short_name: $ref: '#/components/schemas/Short_Name' succession: $ref: '#/components/schemas/Succession' tags: $ref: '#/components/schemas/Tags' total_value: $ref: '#/components/schemas/Total_Value' warrant_holdings: $ref: '#/components/schemas/Warrant_Holding_Units' warrant_value: $ref: '#/components/schemas/Warrant_Value' website: $ref: '#/components/schemas/Website' title: Institution Summary type: object Authentication_Error: description: >- Returned with HTTP 401 when a request carries no API token, or carries one the API cannot use. The response also carries a `WWW-Authenticate` header with the `Bearer` challenge. Branch on `reason` rather than on `message`, whose wording can change. example: code: authentication_required documentation_url: https://api.unusualwhales.com/docs expected_format: uuid message: >- The API token provided is not in the expected format. Unusual Whales API tokens are UUIDs, such as 123e4567-e89b-12d3-a456-426614174000. reason: malformed_token request_id: GNI_YTC1CRnw2LACGBvE retryable: false support_email: dev@unusualwhales.com token_url: https://unusualwhales.com/dashboard/api properties: code: description: Always `authentication_required`. enum: - authentication_required type: string documentation_url: description: Where to read this API documentation. type: string expected_format: description: >- Present only when `reason` is `malformed_token`. The format the token must take. enum: - uuid type: string message: description: A plain description of the failure, written for a person. type: string reason: description: >- Which authentication failure occurred. `missing_token` means the request carried no token. `malformed_token` means a token was supplied but is not a UUID. `unrecognized_token` means the token is a UUID that no active token matches, which happens after a token is revoked or regenerated, or when it belongs to a different account. enum: - missing_token - malformed_token - unrecognized_token type: string request_id: description: >- Identifies this request in Unusual Whales logs. Quote it when contacting support. It matches the `x-request-id` response header, and is absent when no request id was assigned. type: string retryable: description: >- Always `false`. Replaying the same request unchanged returns the same error. Retrying with a corrected token can succeed. enum: - false type: boolean support_email: description: Where to send questions about API access. type: string token_url: description: Where to create and manage API tokens. type: string title: Authentication Error type: object Forbidden_Error: description: >- Returned with HTTP 403 when the API token is valid and recognized, but is not entitled to what the request asked for. Branch on `code`, which names the entitlement that is missing; `message` is written for a person and its wording can change. Unlike a 401 this response carries no `WWW-Authenticate` header, because presenting different credentials for the same token does not change the outcome. Only `code` and `message` are guaranteed. The remaining fields are sent by some checks and not others, so treat every one of them as optional. A 403 whose body is not JSON, or is JSON without a `code` field, did not come from this API. Those are produced by Cloudflare in front of the API, or by a proxy on the caller's own network, and neither says anything about the token or the subscription. example: code: missing_access documentation_url: https://api.unusualwhales.com/docs message: >- The API token provided is valid but is not permitted to access this route. reason: route_not_permitted request_id: GNI_YTC1CRnw2LACGBvE retryable: false support_email: dev@unusualwhales.com token_url: https://unusualwhales.com/dashboard/api properties: code: description: >- Which entitlement is missing. `missing_access` means the token is restricted to a set of routes that excludes the requested one. `historic_data_access_missing` means a date in the request predates the earliest date the token may query. `advanced_tier_required`, `futures_access_required`, `politics_scope_required` and `volatility_scope_required` each mean the endpoint needs a subscription tier or data add-on the account does not have. `admin_required` means the endpoint is internal to Unusual Whales. enum: - missing_access - historic_data_access_missing - advanced_tier_required - futures_access_required - politics_scope_required - volatility_scope_required - admin_required type: string documentation_url: description: Where to read this API documentation. type: string message: description: >- A plain description of what is missing and how to obtain it, written for a person. Do not branch on this string. type: string reason: description: >- Present only when `code` is `missing_access`. Narrows the cause within that code. enum: - route_not_permitted type: string request_id: description: >- Identifies this request in Unusual Whales logs. Quote it when contacting support. It matches the `x-request-id` response header, and is absent when no request id was assigned. type: string retryable: description: >- When present, always `false`. Replaying the same request unchanged returns the same error. Changing the request, the token, or the subscription can succeed. enum: - false type: boolean support_email: description: Where to send questions about API access. type: string token_url: description: Where to create and manage API tokens. type: string required: - code - message title: Forbidden Error type: object Error_Message: description: A json object containing information on the error cause. example: msg: >- Invalid path input: MSFT12 (valid example: AAPL) - Invalid query input(s): date=2023-02-140 (valid example: date=2024-01-18) path: /api/darkpool/MSFT12 query: date=2023-02-140 url: localhost:4000/api/darkpool/MSFT12?date=2023-02-140 properties: msg: description: An error message containing information about the faulty input. type: string path: description: The URL path segment. type: string query: description: The URL query segment. type: string url: description: The full URL causing the error. type: string title: Error Message type: object Error_Message_on_an_internal_server_error.: description: >- A plain message informing, that an internal server error occured. In this case please send a mail with the full URL that caused the issue to support@unusualwhales.com. example: Something went wrong title: Error Message on an internal server error. type: string Institution_Tag: description: '' enum: - advisor - value_investor - brokerage - hedge_fund - private_fund - biotech - activist - top_fund - tiger_club - esg - credit - 13d_activist - energy - small_cap - event - real_estate - technology - all - public_companies - known example: activist title: Institution Tag type: string Buy_Value: description: The rounded total buy value in the institution's portfolio. example: '2394292.0' title: Buy Value type: string Call_Holding_Units: description: The number of call units in the institution's portfolio. example: '2394292.0' title: Call Holding Units type: string Call_Value: description: The rounded total call value in the institution's portfolio. example: '2394292.0' title: Call Value type: string CIK: description: The institution's CIK. example: '0000102909' title: CIK type: string Report_Period_End_Date: description: The end date of the report period in ISO format. example: '2024-10-02T00:00:00.000Z' title: Report Period End Date type: string Debt_Holding_Units: description: The number of debt units in the institution's portfolio. example: '2394292.0' title: Debt Holding Units type: string Debt_Value: description: The rounded total debt value in the institution's portfolio. example: '2394292.0' title: Debt Value type: string Description: description: The institution's description. example: >- Florida-based hedge fund founded in 1977 by Paul Singer. Elliott and Singer himself are famous activists known for acquiring board seats and influencing management, but Elliott has many active arms and runs multiple strategies concurrently like distressed debt, convertible arbitrage, equity long/short, and more. title: Description type: string Filing_Date: description: The latest filing date in ISO format. example: '2024-10-02T00:00:00.000Z' title: Filing Date type: string Founder_Image_URL: description: The URL to the institution's founder's image. example: >- https://storage.googleapis.com/uwassets/institution-img/ELLIOTT%20INVESTMENT%20MANAGEMENT%20L.P.%20Paul%20Singer.jpg title: Founder Image URL type: string Fund_Holding_Units: description: The number of fund units in the institution's portfolio. example: '2394292.0' title: Fund Holding Units type: string Fund_Value: description: The rounded total fund value in the institution's portfolio. example: '2394292.0' title: Fund Value type: string Is_Hedge_Fund: description: '' example: true title: Is Hedge Fund type: boolean Logo_URL: description: The URL to the institution's logo. example: >- https://storage.googleapis.com/uwassets/institution-img/ELLIOTT%20INVESTMENT%20MANAGEMENT%20L.P.%20logo.webp title: Logo URL type: string Name: description: The institution's name. example: VANGUARD GROUP INC title: Name type: string People: description: Persons of interest in the institution. example: - Paul Singer items: type: string title: People type: array Preferred_Share_Holding_Units: description: The number of preferred share units in the institution's portfolio. example: '2394292.0' title: Preferred Share Holding Units type: string Preferred_Share_Value: description: The rounded total preferred share value in the institution's portfolio. example: '2394292.0' title: Preferred Share Value type: string Put_Holding_Units: description: The number of put units in the institution's portfolio. example: '2394292.0' title: Put Holding Units type: string Put_Value: description: The rounded total put value in the institution's portfolio. example: '2394292.0' title: Put Value type: string Sell_Value: description: The rounded total sell value in the institution's portfolio. example: '2394292.0' title: Sell Value type: string Share_Value: description: The rounded total share value in the institution's portfolio. example: '2394292.0' title: Share Value type: string Short_Name: description: The institution's short name. example: Vanguard title: Short Name type: string Succession: description: >- Whether this institution's 13F reporting moved to or from another CIK, and which institutions are involved. It is `null` when the institution has neither a successor nor predecessors. The description of the institutions list endpoint shows all five possible shapes. example: current_holder: null predecessors: - cik: '0001569785' effective_report_date: '2017-06-30T00:00:00.000Z' name: BTG PACTUAL ASSET MANAGEMENT S.A. DTVM succeeded_by: cik: '0001569579' effective_report_date: '2024-06-30T00:00:00.000Z' name: BTG PACTUAL ASSET MANAGEMENT US LLC nullable: true properties: current_holder: description: >- The last institution in the chain of successors. It is set only when the reporting moved again after `succeeded_by` took over, and it is `null` otherwise. nullable: true properties: cik: description: The institution's CIK. example: '0001569579' type: string name: description: The institution's name. example: BTG PACTUAL ASSET MANAGEMENT US LLC type: string type: object predecessors: description: >- The institutions whose reporting this institution took over directly, oldest `effective_report_date` first. The array is empty when there are none. items: properties: cik: description: The institution's CIK. example: '0002026053' type: string effective_report_date: description: >- The end date, in ISO format, of the first quarter for which the successor reports the predecessor's holdings. example: '2026-06-30T00:00:00.000Z' type: string name: description: The institution's name. example: PERSHING SQUARE INC. type: string type: object type: array succeeded_by: description: >- The institution that reports this institution's holdings starting with the quarter ending `effective_report_date`. It is `null` if this institution's reporting has not moved. nullable: true properties: cik: description: The institution's CIK. example: '0002026053' type: string effective_report_date: description: >- The end date, in ISO format, of the first quarter for which the successor reports the predecessor's holdings. example: '2026-06-30T00:00:00.000Z' type: string name: description: The institution's name. example: PERSHING SQUARE INC. type: string type: object title: Succession type: object Tags: description: Tags related to the institution. example: - activist - value_investor items: type: string title: Tags Total_Value: description: The rounded total value of the institution's portfolio. example: '2394292.0' title: Total Value type: string Warrant_Holding_Units: description: The number of warrant units in the institution's portfolio. example: '2394292.0' title: Warrant Holding Units type: string Warrant_Value: description: The rounded total warrant value in the institution's portfolio. example: '2394292.0' title: Warrant Value type: string Website: description: The institution's website. example: https://www.elliottmgmt.com/ title: Website type: string securitySchemes: authorization: scheme: bearer type: http ````