Perpetual futures across 40 venues, perps prop firms and sourced theses on 6,100+ US stocks.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
A stock's full read in one call: the standing investment case, valuation off its filed financials, and the latest quarter. Use when the user asks: is X a buy; is X cheap; what are X's earnings; how was X's quarter; did X beat. response_mode=plain for beginners. Not for: several companies → compare. Args: entity; response_mode.
The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK.
With response_mode plain, who the explanation is written for: 5 a complete beginner, 10 a general reader, 13 an informed investor (unset reads as 13, with precise figures).
"standard" (default): the full read with the investment case; "plain": a short beginner-friendly explanation at the reading_level grade.
A stock's full read in one call: the standing investment case, valuation off its filed financials, and the latest quarter. Use when the user asks: is X a buy; is X cheap; what are X's earnings; how was X's quarter; did X beat. response_mode=plain for beginners. Not for: several companies → compare. Args: entity; response_mode.
| Argument | Type | Description |
|---|---|---|
| entity* | string | The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK. |
| reading_level | any | With response_mode plain, who the explanation is written for: 5 a complete beginner, 10 a general reader, 13 an informed investor (unset reads as 13, with precise figures). |
| response_mode | string | "standard" (default): the full read with the investment case; "plain": a short beginner-friendly explanation at the reading_level grade. |
{
"type": "object",
"title": "answerArguments",
"required": [
"entity"
],
"properties": {
"entity": {
"type": "string",
"title": "Entity",
"description": "The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK."
},
"reading_level": {
"anyOf": [
{
"enum": [
5,
10,
13
],
"type": "integer"
},
{
"type": "null"
}
],
"title": "Reading Level",
"default": null,
"description": "With response_mode plain, who the explanation is written for: 5 a complete beginner, 10 a general reader, 13 an informed investor (unset reads as 13, with precise figures)."
},
"response_mode": {
"enum": [
"standard",
"plain"
],
"type": "string",
"title": "Response Mode",
"default": "standard",
"description": "\"standard\" (default): the full read with the investment case; \"plain\": a short beginner-friendly explanation at the reading_level grade."
}
}
}Two or more companies side by side: each one's valuation, investment case, and what supports or challenges it, so the comparison rests on the cases, not just ratios. Use when the user asks: X vs Y; which is the better buy; is X or Y more defensive. response_mode=plain for beginners. Not for: one company → answer. Args: entities (2-5).
| Argument | Type | Description |
|---|---|---|
| entities* | array | Two to five companies or tickers to set side by side. |
| reading_level | any | With response_mode plain, who the explanation is written for: 5 a complete beginner, 10 a general reader, 13 an informed investor (unset reads as 13, with precise figures). |
| response_mode | string | "standard" (default): the full read with the investment case; "plain": a short beginner-friendly explanation at the reading_level grade. |
{
"type": "object",
"title": "compareArguments",
"required": [
"entities"
],
"properties": {
"entities": {
"type": "array",
"items": {
"type": "string"
},
"title": "Entities",
"description": "Two to five companies or tickers to set side by side."
},
"reading_level": {
"anyOf": [
{
"enum": [
5,
10,
13
],
"type": "integer"
},
{
"type": "null"
}
],
"title": "Reading Level",
"default": null,
"description": "With response_mode plain, who the explanation is written for: 5 a complete beginner, 10 a general reader, 13 an informed investor (unset reads as 13, with precise figures)."
},
"response_mode": {
"enum": [
"standard",
"plain"
],
"type": "string",
"title": "Response Mode",
"default": "standard",
"description": "\"standard\" (default): the full read with the investment case; \"plain\": a short beginner-friendly explanation at the reading_level grade."
}
}
}What is ahead for a company, nearest first: the next earnings date projected from its own filing cadence (held, not rolled, marked overdue when lapsed) and trial readouts. Use when the user asks: when does X report next; what's coming up for X. Not for: past events → get_filings; what the earnings were → answer. Args: entity; types; limit.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Most events, nearest first to return. |
| types | any | Kinds of dated event: "corporate_event" (projected earnings dates) and "fda_event" (clinical trial readouts); unset returns both. |
| entity* | string | The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK. |
{
"type": "object",
"title": "get_calendarArguments",
"required": [
"entity"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 12,
"description": "Most events, nearest first to return."
},
"types": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Types",
"default": null,
"description": "Kinds of dated event: \"corporate_event\" (projected earnings dates) and \"fda_event\" (clinical trial readouts); unset returns both."
},
"entity": {
"type": "string",
"title": "Entity",
"description": "The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK."
}
}
}How a company returns capital: dividend-rate history with each raise or cut, buyback authorizations beside the cash actually spent, splits and name changes. Forward ex-dates are not served. Use when the user asks: did X raise its dividend; is X buying back stock; has X cut it. Args: entity; kind = dividends | buybacks | actions.
| Argument | Type | Description |
|---|---|---|
| kind | string | "dividends" (default): the declared per-share dividend over time, each raise or cut named; "buybacks": repurchase authorisations beside the cash actually spent; "actions": stock splits and name changes; "calendar": the declared dividends (forward ex-dates are not served). |
| limit | integer | Most records to return. |
| entity* | string | The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK. |
| periods | integer | How many of the latest filed periods to read (usually quarters). |
{
"type": "object",
"title": "get_capital_returnsArguments",
"required": [
"entity"
],
"properties": {
"kind": {
"enum": [
"dividends",
"dividend",
"buybacks",
"buyback",
"repurchase",
"repurchases",
"actions",
"action",
"corporate_actions",
"split",
"splits",
"name_change",
"calendar",
"upcoming",
"dividend_calendar"
],
"type": "string",
"title": "Kind",
"default": "dividends",
"description": "\"dividends\" (default): the declared per-share dividend over time, each raise or cut named; \"buybacks\": repurchase authorisations beside the cash actually spent; \"actions\": stock splits and name changes; \"calendar\": the declared dividends (forward ex-dates are not served)."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 10,
"description": "Most records to return."
},
"entity": {
"type": "string",
"title": "Entity",
"description": "The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK."
},
"periods": {
"type": "integer",
"title": "Periods",
"default": 8,
"description": "How many of the latest filed periods to read (usually quarters)."
}
}
}US House stock-trade disclosures (STOCK Act) by ticker or by member, dated by transaction. Use when the user asks: which members of Congress traded X; what did a named member buy; is Congress selling X. Not for: company insiders → get_insider_trades. Args: ticker or member; limit.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Most trades, newest first to return. |
| entity | any | A company name, instead of a ticker. |
| member | any | A House member's name: what that member traded (House only). |
| ticker | any | A stock ticker: which members traded it. |
| chamber | string | "house" (default): US House disclosures by ticker or member. |
{
"type": "object",
"title": "get_congress_tradesArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 25,
"description": "Most trades, newest first to return."
},
"entity": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Entity",
"default": null,
"description": "A company name, instead of a ticker."
},
"member": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Member",
"default": null,
"description": "A House member's name: what that member traded (House only)."
},
"ticker": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Ticker",
"default": null,
"description": "A stock ticker: which members traded it."
},
"chamber": {
"type": "string",
"title": "Chamber",
"default": "house",
"description": "\"house\" (default): US House disclosures by ticker or member."
}
}
}A company's own disclosures: filed 8-K events, its press releases, the text of those 8-Ks, and governance red flags (late filings, auditor changes, selling clusters). Use when the user asks: any red flags at X; what did X announce; latest 8-K from X. Not 10-K/10-Q sections. Args: entity; kind = events | press_releases | event_text | red_flags.
| Argument | Type | Description |
|---|---|---|
| end | any | Window end, YYYY-MM-DD. |
| kind | string | "events" (default): filed 8-K events and how significant; "press_releases": the company's own releases; "event_text": the text of the latest filed events; "red_flags": late filings, auditor changes and insider-selling clusters. |
| limit | integer | Most records to return, newest first. For events it counts the 8-K filings; the declared dividends, insider trades and sentiment reading beside them come in addition, up to as many of each. |
| start | any | Window start, YYYY-MM-DD. |
| entity* | string | The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK. |
{
"type": "object",
"title": "get_filingsArguments",
"required": [
"entity"
],
"properties": {
"end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "End",
"default": null,
"description": "Window end, YYYY-MM-DD."
},
"kind": {
"enum": [
"events",
"event",
"8-k",
"8k",
"press_releases",
"press_release",
"release",
"releases",
"pr",
"event_text",
"text",
"red_flags",
"governance"
],
"type": "string",
"title": "Kind",
"default": "events",
"description": "\"events\" (default): filed 8-K events and how significant; \"press_releases\": the company's own releases; \"event_text\": the text of the latest filed events; \"red_flags\": late filings, auditor changes and insider-selling clusters."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 12,
"description": "Most records to return, newest first. For events it counts the 8-K filings; the declared dividends, insider trades and sentiment reading beside them come in addition, up to as many of each."
},
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Start",
"default": null,
"description": "Window start, YYYY-MM-DD."
},
"entity": {
"type": "string",
"title": "Entity",
"description": "The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK."
}
}
}Form 4 insider transactions for one company, newest first: who, role, code (P buy, S sell, A grant, M exercise, F tax), shares and dollar value. Use when the user asks: are insiders buying X; did X's CEO sell; insider activity at X. Not for: Congress → get_congress_trades. Args: entity; start; end; limit.
| Argument | Type | Description |
|---|---|---|
| end | any | Latest transaction date, YYYY-MM-DD. |
| limit | integer | Most transactions, newest first to return. |
| start | any | Earliest transaction date, YYYY-MM-DD. |
| entity* | string | The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK. |
{
"type": "object",
"title": "get_insider_tradesArguments",
"required": [
"entity"
],
"properties": {
"end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "End",
"default": null,
"description": "Latest transaction date, YYYY-MM-DD."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 25,
"description": "Most transactions, newest first to return."
},
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Start",
"default": null,
"description": "Earliest transaction date, YYYY-MM-DD."
},
"entity": {
"type": "string",
"title": "Entity",
"description": "The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK."
}
}
}One perp market right now, venue by venue: price and premium to the index or stock, open interest, funding, max leverage, liquidation levels, whale trades, positioning; a stock perp's weekend move. Use when the user asks: X funding rate; where do X longs get liquidated. Not for: trends or book depth → get_perps_history. Args: entity.
| Argument | Type | Description |
|---|---|---|
| mode | string | research: detailed hourly evidence; trading: bounded fresh order-book reads on supported venues, never an hourly-price fallback. |
| entity* | string | The market: a ticker or symbol (NVDA, BTC, XAU), a company name (Tesla) or a common asset name (bitcoin, gold, crude oil). |
| max_age_s | number | Trading mode: maximum age of the venue's book in seconds, default 3. |
{
"type": "object",
"title": "get_perpsArguments",
"required": [
"entity"
],
"properties": {
"mode": {
"enum": [
"research",
"trading"
],
"type": "string",
"title": "Mode",
"default": "research",
"description": "research: detailed hourly evidence; trading: bounded fresh order-book reads on supported venues, never an hourly-price fallback."
},
"entity": {
"type": "string",
"title": "Entity",
"description": "The market: a ticker or symbol (NVDA, BTC, XAU), a company name (Tesla) or a common asset name (bitcoin, gold, crude oil)."
},
"max_age_s": {
"type": "number",
"title": "Max Age S",
"default": 3,
"maximum": 30,
"minimum": 0.5,
"description": "Trading mode: maximum age of the venue's book in seconds, default 3."
}
}
}OptimistFi's perps desk: its stories, the traders directory with checked calls, and the Hyperliquid wallets it covered. Use when the user asks: latest perps news on X; is trader Y worth following. Args: view; market; trader; wallet; limit.
| Argument | Type | Description |
|---|---|---|
| dex | string | account view only: Hyperliquid builder dex name, e.g. xyz; empty reads the main dex. |
| view | string | news: the desk's published perps stories, newest first. traders: the perps traders directory, with the desk's checked calls on each. wallets: the Hyperliquid wallets the desk has covered, with their stories. account: a fresh public Hyperliquid wallet state on one dex, with positions and margin; wallet is required. |
| limit | integer | Rows, up to 25. |
| market | any | news and traders: one market (BTC, NVDA, gold). |
| trader | any | traders: one trader by name or X handle. |
| wallet | any | wallets: one 0x address; adds what it holds now. |
| max_age_s | number | account only: maximum source age in seconds, default 3. A stale or undated account is unavailable. |
One perp market over time (1d to 90d): price, open interest, funding, taker buying vs selling, big accounts' net position; plus the latest book depth (±0.5/1/2%) and big accounts' P&L and leverage. Use when the user asks: X funding this week; are whales adding to X; how deep is X's book. Args: entity; window.
| Argument | Type | Description |
|---|---|---|
| entity* | string | The market: a ticker or symbol (NVDA, BTC, XAU), a company name (Tesla) or a common asset name (bitcoin, gold, crude oil). |
| window | string | How far back: 1d (hourly steps), 7d (4-hourly), 30d or 90d (daily). |
{
"type": "object",
"title": "get_perps_historyArguments",
"required": [
"entity"
],
"properties": {
"entity": {
"type": "string",
"title": "Entity",
"description": "The market: a ticker or symbol (NVDA, BTC, XAU), a company name (Tesla) or a common asset name (bitcoin, gold, crude oil)."
},
"window": {
"enum": [
"1d",
"7d",
"30d",
"90d"
],
"type": "string",
"title": "Window",
"default": "7d",
"description": "How far back: 1d (hourly steps), 7d (4-hourly), 30d or 90d (daily)."
}
}
}Perps market research and sized trade costs. trade/cost: BTC/ETH entry, holding and exit dollars from fresh books. Funding, OI, whales and advanced supplied-data studies. Use when the user asks: what does my position cost; where can I trade 100x. Not for: one market overview → get_perps. Args: view; workflow; parameters; market; venue.
| Argument | Type | Description |
|---|---|---|
| side | any | whales and liquidation_feed: buys or sells (a short liquidated counts as a buy, a long as a sell). |
| view | string | trending: where open interest is building over window (1h, 4h or 24h; dollars added, which move with price as well as positions), and the most active markets. movers: the largest price moves up and down over window (5m, 15m, 1h, 4h or 24h). funding: the highest and lowest funding now, annualized (the hour's rate times 8,760, a snapshot) and weighted by open interest, with the venues' settled, running and continuous rates counted. funding_gaps: the same market long on one venue and short on another, what each leg pays or earns after funding and borrow at the latest hourly reading (a snapshot funding spread), each leg's interval and whether its rate is settled or a running estimate, and the two legs' mark-price difference (not executable prices). funding_matrix: every market on every venue, largest open interest first: its funding now (hourly, per 8 hours and annualized), the venue's predicted rate where it publishes one, the funding interval, stablecoin- or coin-margined, and open interest. premium: listings trading furthest above or below the index they settle on (for a stock perp, the stock's price). open_interest: the largest markets by open interest (one side of the market: how much is open, not which way traders lean), with the change over one, four and 24 hours as the site counts it (a listing in whole) and over the markets read at both ends, in USD and in quantity; with venue, that venue's own markets, largest first, and on a pool venue (GMX, gTrade, Jupiter, Ostium, Variational, Vest, Veranta) each market's longs and shorts in USD. liquidations: per market, the dollars of longs and shorts liquidated over window from complete stored hours (stored_comparable_window), most first, with the venues counted and those left out. whales: single trades of $100K or more and single liquidations of $10K or more over window, largest first, plus the newest trades, each market's net whale buying or selling, totals over time, and big accounts' long and short positioning. new_listings: markets venues listed within window. weekend: while US stocks are shut, every stock perp's move since the close (one stock: get_perps). lean: where Hyperliquid's accounts worth $1M or more lean on each market, long against short, with each side's leverage and open profit. hl_cohorts: every Hyperliquid account's positioning across its markets, or one market's with `market`: accounts and dollars long and short, the share of open interest held, and cohorts by account equity and by all-time P&L, each with its accounts in profit and in loss. position_changes: the largest changes in Hyperliquid accounts' positions over window (15m, 1h, 4h or 24h), what each did (opened, added, reduced, closed, flipped) and the account's size cohort, never the account. twaps: Hyperliquid TWAP orders running now, their remaining size and the buying and selling they schedule over the next hour and day. leverage: every perp offered at `leverage` or more, the venues and their caps, and the move that liquidates at each. builds: markets where open interest kept building for two to seven days while the price lagged, ranked. venues: every venue on OptimistFi's perps pages, with its network, settlement, funding interval and markets. hlp: HLP, Hyperliquid's liquidation backstop vault: its account value and cumulative P&L now, its return month by month and year by year, annualized, and its max drawdowns. oi_caps: on Hyperliquid and each of its builder dexes, the markets at their open-interest cap and since when, and each market's cap against its open interest now, nearest the cap first. basis: for one coin (market), each dated future's premium to its index on Deribit, OKX, Kraken and Gate, annualized, and the 90-day constant-maturity basis over 30 days. options: for one coin (market), Deribit's options by expiry: ATM implied volatility (the term structure), 25-delta call and put IVs and skew, call and put open interest and their ratio, volume, max pain (the strike where the expiry's options pay their holders least), open interest by strike, and the 30-day ATM IV and skew over 30 days. market_series: open interest and 24-hour volume in total and per venue over window (24h hourly, 7d every 4 hours, 30d, 90d or 1y daily), the share of BTC, ETH and the rest, each point with the venues it covers, the venues first read inside the window, the like-for-like total over the venues read across all of it (sameVenues), and each venue's liquidations over the hours it recorded. funding_heatmap: funding weighted by open interest, annualized, every 4 hours over the last week, for each market holding $10M or more. returns: how many markets moved how far over window (24h or 7d) in 5% buckets, and the largest gainers and losers with their open-interest change. rsi: RSI(14) on completed hourly, 4-hour and daily closes, each with its last close; window picks the one ranked (1h, 4h, or 24h for daily), or market reads one. sessions: for one market over 30 days, the average return by UTC hour and weekday and the cumulative return of the Asia, Europe and US sessions. liquidation_feed: every single liquidation record the venues publish one by one (event_feed: a record, not a trader), newest first, with the dollars liquidated per coin and per exchange over trailing windows of 1, 4, 12 and 24 hours and each venue's readThrough; it covers other venues and hours than the stored-window liquidations, so the totals differ. cvd: one market's cumulative volume delta per venue and across venues, and its netflow (taker buying less selling) over 1h, 4h, 12h, 24h, 3d and 7d; with no market, the markets with the most net buying and selling. footprint: one market's taker buying and selling at each price, hour by hour. liquidation_max_pain: the price band within 2, 5, 10 or 25% of a market's price where the most perp positions are liquidated, from Hyperliquid's mapped positions (not options max pain); with no market, every mapped market ranked. hyperliquid: Hyperliquid beside its markets, by section: its user count and totals, validators and staking, spot markets, deploy auctions, builder dexes (HIP-3), outcome markets (HIP-4), USDC through its Arbitrum bridge, traders seen, the leaderboard's top 100 by P&L (ranked, never named) and fees. market_overview: per market, open interest and its split by venue, open interest per dollar of volume, market cap, 30-day volume with its change, sector tags and the price change over 5 minutes to a day, ranked by open interest and by 30-day volume. exchanges: per venue, open interest and its share of reported OI, 24-hour volume, liquidations, markets and taker and maker fee, each column ranked on its own. sectors: each sector's open interest, volume and 1-, 7- and 30-day return weighted by open interest. indicators: the technical indicator or index named by `indicator` (one market's TD Sequential, ATR, RSI, MA, EMA, MACD or Bollinger Bands at `interval`; RSI, ATR and MACD lists across markets; Bitfinex margin longs and shorts, borrow rates, futures to spot volume, the altcoin season index; or the catalog of every indicator and its status). btc_cycle: Bitcoin's long-history measures (AHR999, Pi Cycle Top, Golden Ratio Multiplier, 2-Year MA Multiplier, 200-week average, Rainbow, Stock-to-Flow, Puell Multiple, profitable days) and peak signals. fear_greed: our fear and greed index with each of its six inputs. macro: Bitcoin against money supply (M2), its correlations with stocks, gold, the dollar and ether, and the US economic release calendar. etf: every spot ETF on market (BTC, ETH or SOL; a fund ticker such as IBIT for that fund's days, "fund BTC" or "fund ETH" for Grayscale's mini trusts; grayscale for every Grayscale trust), each fund's NAV, shares, net assets, coins held, premium and daily net flow from the issuer's own figures. cot: CFTC Commitments of Traders for market's futures (CME and others), weekly positions by trader group. treasuries: companies holding bitcoin, each count dated and quoted from the SEC filing that states it. orderbook: bids against asks resting within 0.5, 1, 2, 5, 10 and 20% of the mid, per venue and summed across venues, each band's change over 1 hour, 24 hours and 7 days, and the bands over window (for one market), or every market ranked by bid-heavy, ask-heavy, deepest and depth added or pulled in 24 hours. large_orders: every price level resting $100K or more within 10% of the mid, as far as each venue's published book reaches (coverage states the span read), resting now (price, size, side, venue, distance from the mid, size against the market's open interest) and those that ended within window, filled, pulled or unseen, with full counts and totals. orderbook_heatmap: one market's resting dollars by price bucket over window, from its book read every five minutes. week_in_numbers: one week's market-wide figures, frozen once built (period 2026-W42). venue_scorecard: one month's figures per venue (period 2026-10). |
Perps prop firms from their own pages: rules, challenge prices and live codes, country, platforms, assets, max allocation; a named firm's on-chain hedge book, reserves or payouts. Use when the user asks: prop firm rules; X discount code; cheapest $50K challenge; can Propr pay. Args: firm; rule; account_usd; country; asset; on_chain; max_price_usd.
| Argument | Type | Description |
|---|---|---|
| firm | any | One firm by name (Breakout, HyroTrader, Propr): its full record, every challenge and its dated rule changes. Unset: a short record per firm. |
| rule | any | Only firms on one of OptimistFi's rule lists, by its slug. |
| asset | any | Only firms that offer this asset class. |
| country | any | Only firms based in this country: where the firm says it operates, else where its contracting company is registered (United Arab Emirates or UAE, United States or US, Cayman Islands). |
| on_chain | any | true: only firms whose trades execute on an on-chain venue. |
| account_usd | any | Only challenges of this account size in dollars (50000): each firm's challenges at that size, cheapest to get funded first (the price after any live code plus any fee due on passing), and the firm's offers that cover it. |
| max_price_usd |
The standing investment case for a stock: the thesis, its testable claims with the condition that breaks each, the bear case, catalysts, whether it still holds. Use when the user asks: what's the bull case for X; what would break X's thesis; is X's story holding up. response_mode=plain for beginners. Not for: valuation → answer. Args: entity; view.
| Argument | Type | Description |
|---|---|---|
| view | string | "case" (default): the thesis, its testable claims, the bear case and catalysts; "review": the case re-checked against the latest filings; "story": whether the company's own narrative in its releases matches its reported numbers. |
| entity* | string | The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK. |
| reading_level | any | With response_mode plain, who the explanation is written for: 5 a complete beginner, 10 a general reader, 13 an informed investor (unset reads as 13, with precise figures). |
| response_mode | string | "standard" (default): the full read with the investment case; "plain": a short beginner-friendly explanation at the reading_level grade. |
{
"type": "object",
"title": "get_thesisArguments",
"required": [
"entity"
],
"properties": {
"view": {
"type": "string",
"title": "View",
"default": "case",
"description": "\"case\" (default): the thesis, its testable claims, the bear case and catalysts; \"review\": the case re-checked against the latest filings; \"story\": whether the company's own narrative in its releases matches its reported numbers."
},
"entity": {
"type": "string",
"title": "Entity",
"description": "The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK."
},
"reading_level": {
"anyOf": [
{
"enum": [
5,
10,
13
],
"type": "integer"
},
{
"type": "null"
}
],
"title": "Reading Level",
"default": null,
"description": "With response_mode plain, who the explanation is written for: 5 a complete beginner, 10 a general reader, 13 an informed investor (unset reads as 13, with precise figures)."
},
"response_mode": {
"enum": [
"standard",
"plain"
],
"type": "string",
"title": "Response Mode",
"default": "standard",
"description": "\"standard\" (default): the full read with the investment case; \"plain\": a short beginner-friendly explanation at the reading_level grade."
}
}
}One metric's recent quarters read against the investment case: the claim it tests, whether it supports or challenges it, and what it cannot prove. item=earnings covers revenue, profit and EPS. Use when the user asks: what do X's earnings mean for the thesis. response_mode=plain for beginners. Not for: the full read → answer. Args: entity; item.
| Argument | Type | Description |
|---|---|---|
| item | string | The figure to read against the case: "earnings" (revenue, net income and diluted EPS together) or one metric: revenue, net_income, eps_diluted, gross_margin, operating_margin, net_margin, free_cash_flow, operating_cash_flow, ebitda, total_debt, cash, shares_outstanding. |
| entity* | string | The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK. |
| reading_level | any | With response_mode plain, who the explanation is written for: 5 a complete beginner, 10 a general reader, 13 an informed investor (unset reads as 13, with precise figures). |
| response_mode | string | "standard" (default): the full read with the investment case; "plain": a short beginner-friendly explanation at the reading_level grade. |
{
"type": "object",
"title": "get_thesis_impactArguments",
"required": [
"entity"
],
"properties": {
"item": {
"type": "string",
"title": "Item",
"default": "revenue",
"description": "The figure to read against the case: \"earnings\" (revenue, net income and diluted EPS together) or one metric: revenue, net_income, eps_diluted, gross_margin, operating_margin, net_margin, free_cash_flow, operating_cash_flow, ebitda, total_debt, cash, shares_outstanding."
},
"entity": {
"type": "string",
"title": "Entity",
"description": "The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK."
},
"reading_level": {
"anyOf": [
{
"enum": [
5,
10,
13
],
"type": "integer"
},
{
"type": "null"
}
],
"title": "Reading Level",
"default": null,
"description": "With response_mode plain, who the explanation is written for: 5 a complete beginner, 10 a general reader, 13 an informed investor (unset reads as 13, with precise figures)."
},
"response_mode": {
"enum": [
"standard",
"plain"
],
"type": "string",
"title": "Response Mode",
"default": "standard",
"description": "\"standard\" (default): the full read with the investment case; \"plain\": a short beginner-friendly explanation at the reading_level grade."
}
}
}OptimistFi's dated track record on a company: each time a filing crossed or held its thesis's break condition. A crossing whose thesis predates the filing is a genuine call, dated before the event. Use when the user asks: has OptimistFi been right on X; did X's thesis break. response_mode=plain for beginners. Args: entity.
| Argument | Type | Description |
|---|---|---|
| entity* | string | The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK. |
| reading_level | any | With response_mode plain, who the explanation is written for: 5 a complete beginner, 10 a general reader, 13 an informed investor (unset reads as 13, with precise figures). |
| response_mode | string | "standard" (default): the full read with the investment case; "plain": a short beginner-friendly explanation at the reading_level grade. |
{
"type": "object",
"title": "get_track_recordArguments",
"required": [
"entity"
],
"properties": {
"entity": {
"type": "string",
"title": "Entity",
"description": "The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK."
},
"reading_level": {
"anyOf": [
{
"enum": [
5,
10,
13
],
"type": "integer"
},
{
"type": "null"
}
],
"title": "Reading Level",
"default": null,
"description": "With response_mode plain, who the explanation is written for: 5 a complete beginner, 10 a general reader, 13 an informed investor (unset reads as 13, with precise figures)."
},
"response_mode": {
"enum": [
"standard",
"plain"
],
"type": "string",
"title": "Response Mode",
"default": "standard",
"description": "\"standard\" (default): the full read with the investment case; \"plain\": a short beginner-friendly explanation at the reading_level grade."
}
}
}Resolve a ticker, company name or CIK to the canonical company (name, ticker, CIK, FIGI), confirming which company a name means before other tools run. Use when the user asks: which company is X; what's the ticker for X; is X listed. Args: query.
| Argument | Type | Description |
|---|---|---|
| query* | string | A company name, ticker or SEC CIK to identify; returns its name, ticker, CIK and FIGI. |
{
"type": "object",
"title": "resolve_entityArguments",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"title": "Query",
"description": "A company name, ticker or SEC CIK to identify; returns its name, ticker, CIK and FIGI."
}
}
}What has happened for a company since a date, read against its case: the latest quarter's earnings, filings and 8-K events, insider trades, capital returns, price move. Use when the user asks: what changed with X; catch me up on X. response_mode=plain for beginners. Not for: the standing case → get_thesis. Args: entity; since.
| Argument | Type | Description |
|---|---|---|
| since | any | Window start as an ISO date (YYYY-MM-DD); unset reads the last 30 days. |
| entity* | string | The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK. |
| reading_level | any | With response_mode plain, who the explanation is written for: 5 a complete beginner, 10 a general reader, 13 an informed investor (unset reads as 13, with precise figures). |
| response_mode | string | "standard" (default): the full read with the investment case; "plain": a short beginner-friendly explanation at the reading_level grade. |
{
"type": "object",
"title": "what_changedArguments",
"required": [
"entity"
],
"properties": {
"since": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Since",
"default": null,
"description": "Window start as an ISO date (YYYY-MM-DD); unset reads the last 30 days."
},
"entity": {
"type": "string",
"title": "Entity",
"description": "The company: a ticker (AAPL, BRK.B), a company name (Apple) or an SEC CIK."
},
"reading_level": {
"anyOf": [
{
"enum": [
5,
10,
13
],
"type": "integer"
},
{
"type": "null"
}
],
"title": "Reading Level",
"default": null,
"description": "With response_mode plain, who the explanation is written for: 5 a complete beginner, 10 a general reader, 13 an informed investor (unset reads as 13, with precise figures)."
},
"response_mode": {
"enum": [
"standard",
"plain"
],
"type": "string",
"title": "Response Mode",
"default": "standard",
"description": "\"standard\" (default): the full read with the investment case; \"plain\": a short beginner-friendly explanation at the reading_level grade."
}
}
}{
"type": "object",
"title": "get_perps_deskArguments",
"properties": {
"dex": {
"type": "string",
"title": "Dex",
"default": "",
"description": "account view only: Hyperliquid builder dex name, e.g. xyz; empty reads the main dex."
},
"view": {
"enum": [
"news",
"traders",
"wallets",
"account"
],
"type": "string",
"title": "View",
"default": "news",
"description": "news: the desk's published perps stories, newest first. traders: the perps traders directory, with the desk's checked calls on each. wallets: the Hyperliquid wallets the desk has covered, with their stories. account: a fresh public Hyperliquid wallet state on one dex, with positions and margin; wallet is required."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 10,
"description": "Rows, up to 25."
},
"market": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"default": null,
"description": "news and traders: one market (BTC, NVDA, gold)."
},
"trader": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Trader",
"default": null,
"description": "traders: one trader by name or X handle."
},
"wallet": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Wallet",
"default": null,
"description": "wallets: one 0x address; adds what it holds now."
},
"max_age_s": {
"type": "number",
"title": "Max Age S",
"default": 3,
"maximum": 30,
"minimum": 0.5,
"description": "account only: maximum source age in seconds, default 3. A stale or undated account is unavailable."
}
}
}| limit | integer | Rows per list, up to 25. |
| venue | any | One venue id (hyperliquid, dydx, aster, lighter, gmx, …) for whales, new_listings, exchanges, open_interest (that venue's markets, with longs and shorts on a pool venue), large_orders, orderbook_heatmap, liquidation_feed and footprint (that venue's price buckets). |
| margin | any | funding_matrix only: stablecoin-margined markets (settled in a dollar stablecoin or US dollars), coin-margined (settled in the market's own coin), or either (each position takes a coin or a stablecoin); unset reads every market. |
| market | any | One market (BTC, NVDA, gold) for whales, funding_gaps, funding_matrix, premium, new_listings, movers, market_overview, oi_caps, funding_heatmap, rsi, hl_cohorts, position_changes, twaps, liquidation_feed, cvd and liquidation_max_pain; the market sessions and footprint read; for basis and options, the coin they read (BTC, ETH, SOL); one spot token or pair (HYPE, HYPE/USDC) for the hyperliquid view's spot section. For etf and cot the asset (BTC by default), for etf also a fund ticker ("fund BTC" for a ticker that is also an asset's) or grayscale. orderbook, large_orders and orderbook_heatmap read one market. Unset reads every market. |
| offset | integer | Rows to skip in each list: with limit, pages through a list's full length (count gives it where a view reports one; funding_matrix pages every row, the other views reach 2,000). |
| period | any | week_in_numbers: a week, 2026-W42 (Monday 00:00 to Monday 00:00 UTC); venue_scorecard: a month, 2026-10. Unset: the latest closed one; the current one is served marked preview. |
| proven | boolean | whales only: true keeps the trades of proven whales, accounts whose large positions kept winning after they were picked. |
| window | string | Look-back for liquidations, whales, new_listings, liquidation_feed, footprint (1h, 4h or 24h), cvd (24h hourly, 7d in four-hour steps), trending (positions building over 1h, 4h or 24h), position_changes (15m, 1h, 4h or 24h; 7d reads 24h), returns (24h or 7d) and market_series (24h, 7d, 30d, 90d or 1y; only it reads 30d to 1y); rsi's 1h, 4h or 24h picks the closes ranked. movers covers 5m, 15m, 1h, 4h or 24h; funding, funding_gaps, funding_matrix, premium and open_interest, market_overview, exchanges and sectors read the latest reading. orderbook (one market): its history, 1h and 4h from the five-minute reads, 24h hourly, 7d 4-hourly; large_orders: how far back ended levels are listed; orderbook_heatmap: the span drawn. |
| min_usd | any | whales and liquidation_feed: smallest trade or liquidation in USD; funding_gaps and premium: smallest open interest per listing (default $100K), an open-interest floor; open interest is not order-book depth; large_orders: smallest resting level (default $100K). |
| section | any | hyperliquid view only: one section in full; unset gives every section's headline. stats: users, volume, open interest. validators: stake, commission, uptime, the active set, total staked over time. spot: every pair's price, 24h volume and supply (market: one pair's hourly history). auctions: the three deploy auctions now and every token's deploy gas. hip3: each builder dex's markets, open interest, volume and net deposits. hip4: outcome markets listed and settled, and contracts traded each day. bridge: daily USDC deposits and withdrawals. users: Hyperliquid's user count and traders seen each day. leaderboard: top 100 by all-time and 30-day P&L. fees: the fee schedule and the Assistance Fund. |
| interval | any | indicators view: the bar length for a market's indicator or a list (default 1h). |
| leverage | any | leverage view only: the leverage, one of 5, 10, 20, 50, 100, 200 or 500. |
| workflow | any | Optional workflow inside this existing tool. trade: fresh supported books. carry: explicit economics; analysis=compare ranks equal-delta spot/perp/dated scenarios. funding: stored settlements or analysis=calendar. risk: supplied shocks/collateral, public wallet scenarios, analysis=hedge_size, or analysis=events for sourced-schedule exposure (future events remain estimated). study: closed trades; analysis=hedge (stored candles), execution (fills/benchmarks), events/conditional (confirmed event evidence with supplied or stored closed prices), or copy_delay (supplied historical visible depth). screen: source=markets, analysis=divergence/crowding research scans, or analysis=monitor_metrics with exact venue/symbol for hourly funding percentile and fixed-instrument OI quantity change. contracts: stored registry; liveRules=true with one venue adds public size/price/margin rules. replay: stored readings; knownAt selects a prospective immutable platform edition, not original vendor known-at history. Funding confidenceBlockObservations controls descriptive block-bootstrap bands. No account writes or notification sends. |
| indicator | any | indicators view: which one (td, atr, rsi, ma, ema, macd and boll read one market, named by market; the _list ones every market; coinbase_premium is Coinbase's BTC-USD against OKX's BTC-USDT; bitfinex_margin and borrow_rate take a coin as market; catalog lists every indicator with its status). macro view: m2, correlations or calendar; unset reads all three. |
| parameters | any | Validated workflow inputs. trade analysis=cost: market BTC/ETH, sizesUsd (1-6 sizes), side long/short, holdingHours, maxAgeSeconds default 3; live Hyperliquid/Lighter books, optional feeOverridesBps, or up to four normalized supplied quotes. Entry, hold and same-book exit dollar scenarios; missing costs stay null. trade analysis=execution_choices: supplied bids/asks, quantityBase, feeBps and optional explicit passive/sliced fill fractions. screen analysis=liquidity_resilience: eventAt, horizonsSeconds, frozen bandPriceRangeUsd, samples/cadence or prospective venue/market capture. study analyses: markouts (fills and timed benchmarks), price_discovery (synchronized observations and predeclared lags/clocks), relative_value (return_beta with frozen training), capacity (fixed cohort and entry/exit books), options_context (bounded expiry IV summaries). risk analyses: reference_divergence (native-timed mark/oracle/sized exit), leg_risk (separate standard linear margin pools), crowded_exit (one shared book and explicit cohort). carry analysis=capture reconciles supplied settled funding with oracle notionals and an explicit entitlement boundary. Legacy carry/funding/hedge/events/replay inputs remain supported. No MCP writes; private prospective cost studies are saved through the authenticated website. Source clocks, assumptions and economic receipts accompany results. |
| asset_class | any | Only this kind of market; unset reads every class. |
{
"type": "object",
"title": "get_perps_marketArguments",
"properties": {
"side": {
"anyOf": [
{
"enum": [
"buy",
"sell"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Side",
"default": null,
"description": "whales and liquidation_feed: buys or sells (a short liquidated counts as a buy, a long as a sell)."
},
"view": {
"enum": [
"trending",
"movers",
"funding",
"funding_gaps",
"funding_matrix",
"premium",
"open_interest",
"liquidations",
"whales",
"new_listings",
"weekend",
"lean",
"hl_cohorts",
"position_changes",
"twaps",
"leverage",
"builds",
"venues",
"hlp",
"oi_caps",
"basis",
"options",
"market_series",
"funding_heatmap",
"returns",
"rsi",
"sessions",
"liquidation_feed",
"cvd",
"footprint",
"liquidation_max_pain",
"hyperliquid",
"market_overview",
"exchanges",
"sectors",
"indicators",
"btc_cycle",
"fear_greed",
"macro",
"etf",
"cot",
"treasuries",
"orderbook",
"large_orders",
"orderbook_heatmap",
"week_in_numbers",
"venue_scorecard"
],
"type": "string",
"title": "View",
"default": "trending",
"description": "trending: where open interest is building over window (1h, 4h or 24h; dollars added, which move with price as well as positions), and the most active markets. movers: the largest price moves up and down over window (5m, 15m, 1h, 4h or 24h). funding: the highest and lowest funding now, annualized (the hour's rate times 8,760, a snapshot) and weighted by open interest, with the venues' settled, running and continuous rates counted. funding_gaps: the same market long on one venue and short on another, what each leg pays or earns after funding and borrow at the latest hourly reading (a snapshot funding spread), each leg's interval and whether its rate is settled or a running estimate, and the two legs' mark-price difference (not executable prices). funding_matrix: every market on every venue, largest open interest first: its funding now (hourly, per 8 hours and annualized), the venue's predicted rate where it publishes one, the funding interval, stablecoin- or coin-margined, and open interest. premium: listings trading furthest above or below the index they settle on (for a stock perp, the stock's price). open_interest: the largest markets by open interest (one side of the market: how much is open, not which way traders lean), with the change over one, four and 24 hours as the site counts it (a listing in whole) and over the markets read at both ends, in USD and in quantity; with venue, that venue's own markets, largest first, and on a pool venue (GMX, gTrade, Jupiter, Ostium, Variational, Vest, Veranta) each market's longs and shorts in USD. liquidations: per market, the dollars of longs and shorts liquidated over window from complete stored hours (stored_comparable_window), most first, with the venues counted and those left out. whales: single trades of $100K or more and single liquidations of $10K or more over window, largest first, plus the newest trades, each market's net whale buying or selling, totals over time, and big accounts' long and short positioning. new_listings: markets venues listed within window. weekend: while US stocks are shut, every stock perp's move since the close (one stock: get_perps). lean: where Hyperliquid's accounts worth $1M or more lean on each market, long against short, with each side's leverage and open profit. hl_cohorts: every Hyperliquid account's positioning across its markets, or one market's with `market`: accounts and dollars long and short, the share of open interest held, and cohorts by account equity and by all-time P&L, each with its accounts in profit and in loss. position_changes: the largest changes in Hyperliquid accounts' positions over window (15m, 1h, 4h or 24h), what each did (opened, added, reduced, closed, flipped) and the account's size cohort, never the account. twaps: Hyperliquid TWAP orders running now, their remaining size and the buying and selling they schedule over the next hour and day. leverage: every perp offered at `leverage` or more, the venues and their caps, and the move that liquidates at each. builds: markets where open interest kept building for two to seven days while the price lagged, ranked. venues: every venue on OptimistFi's perps pages, with its network, settlement, funding interval and markets. hlp: HLP, Hyperliquid's liquidation backstop vault: its account value and cumulative P&L now, its return month by month and year by year, annualized, and its max drawdowns. oi_caps: on Hyperliquid and each of its builder dexes, the markets at their open-interest cap and since when, and each market's cap against its open interest now, nearest the cap first. basis: for one coin (market), each dated future's premium to its index on Deribit, OKX, Kraken and Gate, annualized, and the 90-day constant-maturity basis over 30 days. options: for one coin (market), Deribit's options by expiry: ATM implied volatility (the term structure), 25-delta call and put IVs and skew, call and put open interest and their ratio, volume, max pain (the strike where the expiry's options pay their holders least), open interest by strike, and the 30-day ATM IV and skew over 30 days. market_series: open interest and 24-hour volume in total and per venue over window (24h hourly, 7d every 4 hours, 30d, 90d or 1y daily), the share of BTC, ETH and the rest, each point with the venues it covers, the venues first read inside the window, the like-for-like total over the venues read across all of it (sameVenues), and each venue's liquidations over the hours it recorded. funding_heatmap: funding weighted by open interest, annualized, every 4 hours over the last week, for each market holding $10M or more. returns: how many markets moved how far over window (24h or 7d) in 5% buckets, and the largest gainers and losers with their open-interest change. rsi: RSI(14) on completed hourly, 4-hour and daily closes, each with its last close; window picks the one ranked (1h, 4h, or 24h for daily), or market reads one. sessions: for one market over 30 days, the average return by UTC hour and weekday and the cumulative return of the Asia, Europe and US sessions. liquidation_feed: every single liquidation record the venues publish one by one (event_feed: a record, not a trader), newest first, with the dollars liquidated per coin and per exchange over trailing windows of 1, 4, 12 and 24 hours and each venue's readThrough; it covers other venues and hours than the stored-window liquidations, so the totals differ. cvd: one market's cumulative volume delta per venue and across venues, and its netflow (taker buying less selling) over 1h, 4h, 12h, 24h, 3d and 7d; with no market, the markets with the most net buying and selling. footprint: one market's taker buying and selling at each price, hour by hour. liquidation_max_pain: the price band within 2, 5, 10 or 25% of a market's price where the most perp positions are liquidated, from Hyperliquid's mapped positions (not options max pain); with no market, every mapped market ranked. hyperliquid: Hyperliquid beside its markets, by section: its user count and totals, validators and staking, spot markets, deploy auctions, builder dexes (HIP-3), outcome markets (HIP-4), USDC through its Arbitrum bridge, traders seen, the leaderboard's top 100 by P&L (ranked, never named) and fees. market_overview: per market, open interest and its split by venue, open interest per dollar of volume, market cap, 30-day volume with its change, sector tags and the price change over 5 minutes to a day, ranked by open interest and by 30-day volume. exchanges: per venue, open interest and its share of reported OI, 24-hour volume, liquidations, markets and taker and maker fee, each column ranked on its own. sectors: each sector's open interest, volume and 1-, 7- and 30-day return weighted by open interest. indicators: the technical indicator or index named by `indicator` (one market's TD Sequential, ATR, RSI, MA, EMA, MACD or Bollinger Bands at `interval`; RSI, ATR and MACD lists across markets; Bitfinex margin longs and shorts, borrow rates, futures to spot volume, the altcoin season index; or the catalog of every indicator and its status). btc_cycle: Bitcoin's long-history measures (AHR999, Pi Cycle Top, Golden Ratio Multiplier, 2-Year MA Multiplier, 200-week average, Rainbow, Stock-to-Flow, Puell Multiple, profitable days) and peak signals. fear_greed: our fear and greed index with each of its six inputs. macro: Bitcoin against money supply (M2), its correlations with stocks, gold, the dollar and ether, and the US economic release calendar. etf: every spot ETF on market (BTC, ETH or SOL; a fund ticker such as IBIT for that fund's days, \"fund BTC\" or \"fund ETH\" for Grayscale's mini trusts; grayscale for every Grayscale trust), each fund's NAV, shares, net assets, coins held, premium and daily net flow from the issuer's own figures. cot: CFTC Commitments of Traders for market's futures (CME and others), weekly positions by trader group. treasuries: companies holding bitcoin, each count dated and quoted from the SEC filing that states it. orderbook: bids against asks resting within 0.5, 1, 2, 5, 10 and 20% of the mid, per venue and summed across venues, each band's change over 1 hour, 24 hours and 7 days, and the bands over window (for one market), or every market ranked by bid-heavy, ask-heavy, deepest and depth added or pulled in 24 hours. large_orders: every price level resting $100K or more within 10% of the mid, as far as each venue's published book reaches (coverage states the span read), resting now (price, size, side, venue, distance from the mid, size against the market's open interest) and those that ended within window, filled, pulled or unseen, with full counts and totals. orderbook_heatmap: one market's resting dollars by price bucket over window, from its book read every five minutes. week_in_numbers: one week's market-wide figures, frozen once built (period 2026-W42). venue_scorecard: one month's figures per venue (period 2026-10)."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 10,
"description": "Rows per list, up to 25."
},
"venue": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Venue",
"default": null,
"description": "One venue id (hyperliquid, dydx, aster, lighter, gmx, …) for whales, new_listings, exchanges, open_interest (that venue's markets, with longs and shorts on a pool venue), large_orders, orderbook_heatmap, liquidation_feed and footprint (that venue's price buckets)."
},
"margin": {
"anyOf": [
{
"enum": [
"stablecoin",
"coin",
"either"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Margin",
"default": null,
"description": "funding_matrix only: stablecoin-margined markets (settled in a dollar stablecoin or US dollars), coin-margined (settled in the market's own coin), or either (each position takes a coin or a stablecoin); unset reads every market."
},
"market": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Market",
"default": null,
"description": "One market (BTC, NVDA, gold) for whales, funding_gaps, funding_matrix, premium, new_listings, movers, market_overview, oi_caps, funding_heatmap, rsi, hl_cohorts, position_changes, twaps, liquidation_feed, cvd and liquidation_max_pain; the market sessions and footprint read; for basis and options, the coin they read (BTC, ETH, SOL); one spot token or pair (HYPE, HYPE/USDC) for the hyperliquid view's spot section. For etf and cot the asset (BTC by default), for etf also a fund ticker (\"fund BTC\" for a ticker that is also an asset's) or grayscale. orderbook, large_orders and orderbook_heatmap read one market. Unset reads every market."
},
"offset": {
"type": "integer",
"title": "Offset",
"default": 0,
"minimum": 0,
"description": "Rows to skip in each list: with limit, pages through a list's full length (count gives it where a view reports one; funding_matrix pages every row, the other views reach 2,000)."
},
"period": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Period",
"default": null,
"description": "week_in_numbers: a week, 2026-W42 (Monday 00:00 to Monday 00:00 UTC); venue_scorecard: a month, 2026-10. Unset: the latest closed one; the current one is served marked preview."
},
"proven": {
"type": "boolean",
"title": "Proven",
"default": false,
"description": "whales only: true keeps the trades of proven whales, accounts whose large positions kept winning after they were picked."
},
"window": {
"enum": [
"5m",
"15m",
"1h",
"4h",
"24h",
"7d",
"30d",
"90d",
"1y"
],
"type": "string",
"title": "Window",
"default": "24h",
"description": "Look-back for liquidations, whales, new_listings, liquidation_feed, footprint (1h, 4h or 24h), cvd (24h hourly, 7d in four-hour steps), trending (positions building over 1h, 4h or 24h), position_changes (15m, 1h, 4h or 24h; 7d reads 24h), returns (24h or 7d) and market_series (24h, 7d, 30d, 90d or 1y; only it reads 30d to 1y); rsi's 1h, 4h or 24h picks the closes ranked. movers covers 5m, 15m, 1h, 4h or 24h; funding, funding_gaps, funding_matrix, premium and open_interest, market_overview, exchanges and sectors read the latest reading. orderbook (one market): its history, 1h and 4h from the five-minute reads, 24h hourly, 7d 4-hourly; large_orders: how far back ended levels are listed; orderbook_heatmap: the span drawn."
},
"min_usd": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Min Usd",
"default": null,
"description": "whales and liquidation_feed: smallest trade or liquidation in USD; funding_gaps and premium: smallest open interest per listing (default $100K), an open-interest floor; open interest is not order-book depth; large_orders: smallest resting level (default $100K)."
},
"section": {
"anyOf": [
{
"enum": [
"stats",
"validators",
"spot",
"auctions",
"hip3",
"hip4",
"bridge",
"users",
"leaderboard",
"fees"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Section",
"default": null,
"description": "hyperliquid view only: one section in full; unset gives every section's headline. stats: users, volume, open interest. validators: stake, commission, uptime, the active set, total staked over time. spot: every pair's price, 24h volume and supply (market: one pair's hourly history). auctions: the three deploy auctions now and every token's deploy gas. hip3: each builder dex's markets, open interest, volume and net deposits. hip4: outcome markets listed and settled, and contracts traded each day. bridge: daily USDC deposits and withdrawals. users: Hyperliquid's user count and traders seen each day. leaderboard: top 100 by all-time and 30-day P&L. fees: the fee schedule and the Assistance Fund."
},
"interval": {
"anyOf": [
{
"enum": [
"15m",
"1h",
"4h",
"12h",
"1d",
"1w"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Interval",
"default": null,
"description": "indicators view: the bar length for a market's indicator or a list (default 1h)."
},
"leverage": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Leverage",
"default": null,
"description": "leverage view only: the leverage, one of 5, 10, 20, 50, 100, 200 or 500."
},
"workflow": {
"anyOf": [
{
"enum": [
"trade",
"carry",
"funding",
"risk",
"changes",
"screen",
"study",
"alerts",
"contracts",
"export",
"replay"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Workflow",
"default": null,
"description": "Optional workflow inside this existing tool. trade: fresh supported books. carry: explicit economics; analysis=compare ranks equal-delta spot/perp/dated scenarios. funding: stored settlements or analysis=calendar. risk: supplied shocks/collateral, public wallet scenarios, analysis=hedge_size, or analysis=events for sourced-schedule exposure (future events remain estimated). study: closed trades; analysis=hedge (stored candles), execution (fills/benchmarks), events/conditional (confirmed event evidence with supplied or stored closed prices), or copy_delay (supplied historical visible depth). screen: source=markets, analysis=divergence/crowding research scans, or analysis=monitor_metrics with exact venue/symbol for hourly funding percentile and fixed-instrument OI quantity change. contracts: stored registry; liveRules=true with one venue adds public size/price/margin rules. replay: stored readings; knownAt selects a prospective immutable platform edition, not original vendor known-at history. Funding confidenceBlockObservations controls descriptive block-bootstrap bands. No account writes or notification sends."
},
"indicator": {
"anyOf": [
{
"enum": [
"td",
"atr",
"rsi",
"ma",
"ema",
"macd",
"boll",
"rsi_list",
"atr_list",
"macd_list",
"coinbase_premium",
"bitfinex_margin",
"borrow_rate",
"futures_spot_volume",
"altcoin_season",
"catalog",
"m2",
"correlations",
"calendar"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Indicator",
"default": null,
"description": "indicators view: which one (td, atr, rsi, ma, ema, macd and boll read one market, named by market; the _list ones every market; coinbase_premium is Coinbase's BTC-USD against OKX's BTC-USDT; bitfinex_margin and borrow_rate take a coin as market; catalog lists every indicator with its status). macro view: m2, correlations or calendar; unset reads all three."
},
"parameters": {
"anyOf": [
{
"type": "null"
},
{
"not": {
"required": [
"analysis"
],
"properties": {
"analysis": {
"enum": [
"cost",
"execution_choices",
"liquidity_resilience",
"markouts",
"price_discovery",
"relative_value",
"capacity",
"capture",
"reference_divergence",
"leg_risk",
"options_context",
"crowded_exit"
]
}
}
},
"type": "object"
},
{
"type": "object",
"required": [
"analysis"
],
"properties": {
"side": {
"enum": [
"long",
"short"
],
"type": "string"
},
"market": {
"type": "string"
},
"quotes": {
"type": "array",
"maxItems": 4
},
"venues": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 4
},
"wallet": {
"type": "string"
},
"analysis": {
"type": "string",
"const": "cost"
},
"sizesUsd": {
"type": "array",
"items": {
"type": "number",
"maximum": 100000000,
"exclusiveMinimum": 0
},
"maxItems": 6,
"minItems": 1
},
"quoteToUsd": {
"type": "number"
},
"notionalUsd": {
"type": "number"
},
"holdingHours": {
"type": "number"
},
"maxAgeSeconds": {
"type": "number"
},
"frontendFeeBps": {
"type": "number"
},
"feeOverridesBps": {
"type": "object"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"analysis",
"bids",
"asks",
"quantityBase",
"feeBps"
],
"properties": {
"asks": {
"type": "array",
"maxItems": 2000
},
"bids": {
"type": "array",
"maxItems": 2000
},
"side": {
"type": "string"
},
"feeBps": {
"type": "number"
},
"analysis": {
"type": "string",
"const": "execution_choices"
},
"quantityBase": {
"type": "number"
},
"passivePriceUsd": {
"type": "number"
},
"slicedFillFraction": {
"type": "number"
},
"passiveFillFraction": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"analysis",
"eventAt",
"horizonsSeconds",
"bandPriceRangeUsd"
],
"properties": {
"venue": {
"type": "string"
},
"market": {
"type": "string"
},
"eventAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"knownAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"samples": {
"type": "array",
"maxItems": 2000
},
"analysis": {
"type": "string",
"const": "liquidity_resilience"
},
"quoteToUsd": {
"type": "number"
},
"maxGapSeconds": {
"type": "number"
},
"horizonsSeconds": {
"type": "array",
"maxItems": 2000
},
"bandPriceRangeUsd": {
"type": "array",
"maxItems": 2000
},
"sampleIntervalSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"analysis",
"venue",
"symbol",
"fills",
"benchmarks",
"horizonsSeconds",
"maxBenchmarkSkewSeconds"
],
"properties": {
"fills": {
"type": "array",
"maxItems": 2000
},
"venue": {
"type": "string"
},
"symbol": {
"type": "string"
},
"analysis": {
"type": "string",
"const": "markouts"
},
"benchmarks": {
"type": "array",
"maxItems": 2000
},
"fundingPaidUsd": {
"type": "number"
},
"horizonsSeconds": {
"type": "array",
"maxItems": 2000
},
"coverageComplete": {
"type": "boolean"
},
"realizedGrossPnlUsd": {
"type": "number"
},
"maxBenchmarkSkewSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"analysis",
"observations",
"lagsMs",
"clockUncertaintyMs",
"sampleIntervalMs"
],
"properties": {
"lagsMs": {
"type": "array",
"maxItems": 2000
},
"analysis": {
"type": "string",
"const": "price_discovery"
},
"observations": {
"type": "array",
"maxItems": 2000
},
"sampleIntervalMs": {
"type": "number"
},
"clockUncertaintyMs": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"analysis",
"observations",
"method",
"trainFraction",
"notionalUsd"
],
"properties": {
"method": {
"type": "string",
"const": "return_beta"
},
"analysis": {
"type": "string",
"const": "relative_value"
},
"notionalUsd": {
"type": "number"
},
"observations": {
"type": "array",
"maxItems": 2000
},
"trainFraction": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"analysis",
"signals",
"sizesUsd"
],
"properties": {
"signals": {
"type": "array",
"maxItems": 2000
},
"analysis": {
"type": "string",
"const": "capacity"
},
"sizesUsd": {
"type": "array",
"maxItems": 2000
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"analysis",
"entryAt",
"exitAt",
"signedQuantityBase",
"settlements",
"boundaryRule"
],
"properties": {
"exitAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"entryAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"analysis": {
"type": "string",
"const": "capture"
},
"settlements": {
"type": "array",
"maxItems": 2000
},
"boundaryRule": {
"type": "string"
},
"borrowCostUsd": {
"type": "number"
},
"coverageComplete": {
"type": "boolean"
},
"roundTripCostUsd": {
"type": "number"
},
"signedQuantityBase": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"analysis",
"mark",
"oracle",
"exit",
"maxAgeSeconds",
"maxSkewSeconds"
],
"properties": {
"exit": {
"type": "object"
},
"mark": {
"type": "object"
},
"oracle": {
"type": "object"
},
"analysis": {
"type": "string",
"const": "reference_divergence"
},
"maxAgeSeconds": {
"type": "number"
},
"maxSkewSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"analysis",
"accountMode",
"pools",
"legs",
"horizonSeconds"
],
"properties": {
"legs": {
"type": "array",
"maxItems": 2000
},
"pools": {
"type": "array",
"maxItems": 2000
},
"analysis": {
"type": "string",
"const": "leg_risk"
},
"accountMode": {
"type": "string"
},
"horizonSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"analysis",
"expiries",
"targetDays"
],
"properties": {
"limit": {
"type": "number"
},
"analysis": {
"type": "string",
"const": "options_context"
},
"expiries": {
"type": "array",
"maxItems": 2000
},
"targetDays": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"analysis",
"bids",
"participants",
"depthFraction",
"coverageFraction"
],
"properties": {
"bids": {
"type": "array",
"maxItems": 2000
},
"analysis": {
"type": "string",
"const": "crowded_exit"
},
"participants": {
"type": "array",
"maxItems": 2000
},
"depthFraction": {
"type": "number"
},
"coverageFraction": {
"type": "number"
}
},
"additionalProperties": false
}
],
"title": "Parameters",
"default": null,
"description": "Validated workflow inputs. trade analysis=cost: market BTC/ETH, sizesUsd (1-6 sizes), side long/short, holdingHours, maxAgeSeconds default 3; live Hyperliquid/Lighter books, optional feeOverridesBps, or up to four normalized supplied quotes. Entry, hold and same-book exit dollar scenarios; missing costs stay null. trade analysis=execution_choices: supplied bids/asks, quantityBase, feeBps and optional explicit passive/sliced fill fractions. screen analysis=liquidity_resilience: eventAt, horizonsSeconds, frozen bandPriceRangeUsd, samples/cadence or prospective venue/market capture. study analyses: markouts (fills and timed benchmarks), price_discovery (synchronized observations and predeclared lags/clocks), relative_value (return_beta with frozen training), capacity (fixed cohort and entry/exit books), options_context (bounded expiry IV summaries). risk analyses: reference_divergence (native-timed mark/oracle/sized exit), leg_risk (separate standard linear margin pools), crowded_exit (one shared book and explicit cohort). carry analysis=capture reconciles supplied settled funding with oracle notionals and an explicit entitlement boundary. Legacy carry/funding/hedge/events/replay inputs remain supported. No MCP writes; private prospective cost studies are saved through the authenticated website. Source clocks, assumptions and economic receipts accompany results."
},
"asset_class": {
"anyOf": [
{
"enum": [
"crypto",
"equity",
"index",
"commodity",
"fx"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Asset Class",
"default": null,
"description": "Only this kind of market; unset reads every class."
}
}
}| any |
| Only firms whose cheapest published evaluation costs this much or less, in dollars (100). |
{
"type": "object",
"title": "get_prop_firmsArguments",
"properties": {
"firm": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Firm",
"default": null,
"description": "One firm by name (Breakout, HyroTrader, Propr): its full record, every challenge and its dated rule changes. Unset: a short record per firm."
},
"rule": {
"anyOf": [
{
"enum": [
"static-drawdown",
"under-50",
"instant-funding",
"no-daily-loss-limit",
"stock-perps",
"hyperliquid",
"200k-accounts",
"us-traders",
"no-minimum-days"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Rule",
"default": null,
"description": "Only firms on one of OptimistFi's rule lists, by its slug."
},
"asset": {
"anyOf": [
{
"enum": [
"Crypto",
"Stocks",
"ETFs",
"Indices",
"Commodities",
"Forex"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Asset",
"default": null,
"description": "Only firms that offer this asset class."
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Country",
"default": null,
"description": "Only firms based in this country: where the firm says it operates, else where its contracting company is registered (United Arab Emirates or UAE, United States or US, Cayman Islands)."
},
"on_chain": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "On Chain",
"default": null,
"description": "true: only firms whose trades execute on an on-chain venue."
},
"account_usd": {
"anyOf": [
{
"type": "integer",
"minimum": 1
},
{
"type": "null"
}
],
"title": "Account Usd",
"default": null,
"description": "Only challenges of this account size in dollars (50000): each firm's challenges at that size, cheapest to get funded first (the price after any live code plus any fee due on passing), and the firm's offers that cover it."
},
"max_price_usd": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Max Price Usd",
"default": null,
"description": "Only firms whose cheapest published evaluation costs this much or less, in dollars (100)."
}
}
}