analyze_market
ChatGPTPRIMARY TOOL for any question about a specific tradeable asset on Liquid. Use this whenever the user asks about an asset's price, outlook, positioning, sentiment, what an asset is doing, how traders are positioned, or wants analysis on a particular market. Liquid covers equities (TSLA, AAPL, NVDA), commodities (GOLD, SILVER, OIL), indices (SP500), crypto (BTC, ETH, SOL), and more. Returns real-time Liquid price, funding, OI, and positioning data. Do NOT use search_markets when the user asks about a specific known asset — use analyze_market instead.
analyze_market
ChatGPTPRIMARY TOOL for any question about a specific tradeable asset on Liquid. Use this whenever the user asks about an asset's price, outlook, positioning, sentiment, what an asset is doing, how traders are positioned, or wants analysis on a particular market. Liquid covers equities (TSLA, AAPL, NVDA), commodities (GOLD, SILVER, OIL), indices (SP500), crypto (BTC, ETH, SOL), and more. Returns real-time Liquid price, funding, OI, and positioning data. Do NOT use search_markets when the user asks about a specific known asset — use analyze_market instead.
analyze_markets_batch
ChatGPTCompare 2–10 markets side-by-side. Use when the user asks about more than one asset at once (e.g. 'how are BTC, ETH, and SOL looking?', 'compare gold to oil', 'show me my watchlist'). Returns a short text summary plus a multi-market widget. For deep single-asset analysis still use analyze_market.
analyze_markets_batch
ChatGPTCompare 2–10 markets side-by-side. Use when the user asks about more than one asset at once (e.g. 'how are BTC, ETH, and SOL looking?', 'compare gold to oil', 'show me my watchlist'). Returns a short text summary plus a multi-market widget. For deep single-asset analysis still use analyze_market.
create_onramp_session
ChatGPTINTERNAL: Called by the deposit widget when the user confirms a fiat amount for credit card or Other Apps. Do not call directly. Returns { url }.
create_onramp_session
ChatGPTINTERNAL: Called by the deposit widget when the user confirms a fiat amount for credit card or Other Apps. Do not call directly. Returns { url }.
disable_paper_trading
ChatGPTExit paper trading mode and return to live account data. Trade widgets still link to Liquid and do not execute through this MCP. Call this when the user asks to 'stop paper trading', 'go back to live', 'trade real money', or similar. Idempotent — calling it when paper mode is already off is a no-op.
disable_paper_trading
ChatGPTExit paper trading mode and return to live account data. Trade widgets still link to Liquid and do not execute through this MCP. Call this when the user asks to 'stop paper trading', 'go back to live', 'trade real money', or similar. Idempotent — calling it when paper mode is already off is a no-op.
enable_paper_trading
ChatGPTSwitch the current account into paper trading mode. When enabled, account reads, positions, and open orders route to the paper trading simulator with no real funds at risk. Call this whenever the user asks to 'paper trade', 'try trades without real money', 'practice', 'simulate', or similar. Idempotent — calling it twice simply keeps paper mode on.
enable_paper_trading
ChatGPTSwitch the current account into paper trading mode. When enabled, account reads, positions, and open orders route to the paper trading simulator with no real funds at risk. Call this whenever the user asks to 'paper trade', 'try trades without real money', 'practice', 'simulate', or similar. Idempotent — calling it twice simply keeps paper mode on.
enable_trading
ChatGPTCheck whether the user's Liquid account is ready for trading in Liquid and render the correct setup action. Use when the user asks to enable trading or after they fund their account. For funded embedded-wallet accounts that are missing the trading key, the widget opens the Liquid re-auth/setup flow. This MCP does not execute live trades; setup only prepares the user's Liquid account.
enable_trading
ChatGPTCheck whether the user's Liquid account is ready for trading in Liquid and render the correct setup action. Use when the user asks to enable trading or after they fund their account. For funded embedded-wallet accounts that are missing the trading key, the widget opens the Liquid re-auth/setup flow. This MCP does not execute live trades; setup only prepares the user's Liquid account.
generate_deposit_address
ChatGPTINTERNAL: Called by the deposit widget when the user picks a token + chain for a crypto deposit. Do not call directly. Returns { address, chain, direct }. HyperCore resolves to the user's own wallet (direct=true, no bridging); other chains return a Relay bridge address (direct=false).
generate_deposit_address
ChatGPTINTERNAL: Called by the deposit widget when the user picks a token + chain for a crypto deposit. Do not call directly. Returns { address, chain, direct }. HyperCore resolves to the user's own wallet (direct=true, no bridging); other chains return a Relay bridge address (direct=false).
get_news
ChatGPTGet recent market news headlines with source links, plus a Liquid unusual-activity section (tradeable symbols whose last-hour volume is anomalously high vs. 24h average). Covers equities, commodities, indices, crypto, and macro. Returns text for the model to reference — no visual widget. Use to cross-reference headlines against positioning data, or when the user asks 'what's happening in the markets' or about recent news. Returns curated trading headlines mapped to Liquid's tradeable markets.
get_news
ChatGPTGet recent market news headlines with source links, plus a Liquid unusual-activity section (tradeable symbols whose last-hour volume is anomalously high vs. 24h average). Covers equities, commodities, indices, crypto, and macro. Returns text for the model to reference — no visual widget. Use to cross-reference headlines against positioning data, or when the user asks 'what's happening in the markets' or about recent news. Returns curated trading headlines mapped to Liquid's tradeable markets.
get_portfolio
ChatGPTGet the user's complete portfolio — account balance, equity, margin, and all open positions with entry price, PnL, leverage, and TP/SL levels. Use when the user asks about their account, balance, positions, portfolio, how much they have, or their P&L. Also use this when the user asks about closing, reducing, or modifying a position so you can describe the current state and direct them to Liquid for live actions. The portfolio widget is read-only for positions. Do NOT confuse with view_open_orders — this shows POSITIONS (active holdings), not ORDERS (pending/resting). Call this before suggest_trade to get current balance and position details. Collateral routing: USDC perps use available USDC (account.available_balance). USDH-denominated assets (HIP-3 vntl:/flx:/km:) use the combined USDH-denominated capacity line under Currencies, which already rolls available USDH + USDC-convertible into one number — quote that, not raw USDH or raw USDC. Never tell the user to convert USDH→USDC before trading a USDH-denominated asset; check analyze_market's Collateral field to know which currency each market uses.
get_portfolio
ChatGPTGet the user's complete portfolio — account balance, equity, margin, and all open positions with entry price, PnL, leverage, and TP/SL levels. Use when the user asks about their account, balance, positions, portfolio, how much they have, or their P&L. Also use this when the user asks about closing, reducing, or modifying a position so you can describe the current state and direct them to Liquid for live actions. The portfolio widget is read-only for positions. Do NOT confuse with view_open_orders — this shows POSITIONS (active holdings), not ORDERS (pending/resting). Call this before suggest_trade to get current balance and position details. Collateral routing: USDC perps use available USDC (account.available_balance). USDH-denominated assets (HIP-3 vntl:/flx:/km:) use the combined USDH-denominated capacity line under Currencies, which already rolls available USDH + USDC-convertible into one number — quote that, not raw USDH or raw USDC. Never tell the user to convert USDH→USDC before trading a USDH-denominated asset; check analyze_market's Collateral field to know which currency each market uses.
get_positioning_pulse
ChatGPTMarket-wide cohort-bias snapshot across Liquid markets with positioning data coverage. Returns the most one-sided assets split into long-heavy and short-heavy buckets, with notional and position count. Use in the /markets flow BEFORE market_picks to ground picks in actual positioning, or when the user asks 'what's crowded?', 'what are traders long/short?', or wants a contrarian setup. Do NOT call for single-asset queries — use analyze_market instead.
get_positioning_pulse
ChatGPTMarket-wide cohort-bias snapshot across Liquid markets with positioning data coverage. Returns the most one-sided assets split into long-heavy and short-heavy buckets, with notional and position count. Use in the /markets flow BEFORE market_picks to ground picks in actual positioning, or when the user asks 'what's crowded?', 'what are traders long/short?', or wants a contrarian setup. Do NOT call for single-asset queries — use analyze_market instead.
help
ChatGPTList Co-Invest's user-facing capabilities grouped by category. Call this when the user asks what you can do, says 'help', sends '/help', or seems unsure how to use the platform.
help
ChatGPTList Co-Invest's user-facing capabilities grouped by category. Call this when the user asks what you can do, says 'help', sends '/help', or seems unsure how to use the platform.
market_picks
ChatGPTRender 5 news-driven trade picks as interactive cards. ONLY call this as the final step of the /markets command flow, after calling get_news(), search_markets(), and get_positioning_pulse(). Do NOT call for single-asset queries — use analyze_market instead. Each pick: asset, direction, news catalyst, reasoning — weight reasoning with the positioning pulse (contrarian vs. crowded) and the unusual-activity section from get_news.
market_picks
ChatGPTRender 5 news-driven trade picks as interactive cards. ONLY call this as the final step of the /markets command flow, after calling get_news(), search_markets(), and get_positioning_pulse(). Do NOT call for single-asset queries — use analyze_market instead. Each pick: asset, direction, news catalyst, reasoning — weight reasoning with the positioning pulse (contrarian vs. crowded) and the unusual-activity section from get_news.
paper_trading_status
ChatGPTReport whether paper trading is currently enabled for this account. Use when the user asks 'am I paper trading?' or you need to disambiguate account context before analysis.
paper_trading_status
ChatGPTReport whether paper trading is currently enabled for this account. Use when the user asks 'am I paper trading?' or you need to disambiguate account context before analysis.
plan_portfolio
ChatGPTBuild a multi-trade portfolio plan in one shot. Use this when the user asks for a 'portfolio', 'plan', 'how should I deploy $X', 'suggest a few trades', or any multi-position allocation question — instead of suggesting trades one at a time. PREREQUISITE: BEFORE calling this tool, you MUST collect the user's preferences using the client's built-in interactive question widget (the one rendered for AskUserQuestion / structured Q&A). NEVER ask the questions as a numbered prose list in chat — always use the native question UI. Required answers: (1) risk tolerance (conservative | moderate | aggressive), (2) time horizon (intraday | swing_week | position_long_term), (3) assetClasses as an array of one or more selected asset class strings from crypto, equities, commodities, indices, fx. Do NOT ask about balance — this tool fetches the user's available_balance from their portfolio and assumes they want to deploy all of it. Once you have the three answers, call this tool. It fetches the account balance + news + market-wide positioning + top-trader cohort + unusual volume in parallel (plus upcoming earnings when equities are selected) and returns a research bundle plus sizing rules and synthesis instructions. AFTER this tool returns, you must (a) write a 2–3 sentence thesis, (b) call suggest_trades_batch ONCE with that thesis plus all proposed legs as a basket, then (c) write a 1–2 sentence risk wrap. Do NOT call suggest_trade per-leg — always use suggest_trades_batch for portfolio plans. Do NOT write the trade plan in prose or a markdown table.
plan_portfolio
ChatGPTBuild a multi-trade portfolio plan in one shot. Use this when the user asks for a 'portfolio', 'plan', 'how should I deploy $X', 'suggest a few trades', or any multi-position allocation question — instead of suggesting trades one at a time. PREREQUISITE: BEFORE calling this tool, you MUST collect the user's preferences using the client's built-in interactive question widget (the one rendered for AskUserQuestion / structured Q&A). NEVER ask the questions as a numbered prose list in chat — always use the native question UI. Required answers: (1) risk tolerance (conservative | moderate | aggressive), (2) time horizon (intraday | swing_week | position_long_term), (3) assetClasses as an array of one or more selected asset class strings from crypto, equities, commodities, indices, fx. Do NOT ask about balance — this tool fetches the user's available_balance from their portfolio and assumes they want to deploy all of it. Once you have the three answers, call this tool. It fetches the account balance + news + market-wide positioning + top-trader cohort + unusual volume in parallel (plus upcoming earnings when equities are selected) and returns a research bundle plus sizing rules and synthesis instructions. AFTER this tool returns, you must (a) write a 2–3 sentence thesis, (b) call suggest_trades_batch ONCE with that thesis plus all proposed legs as a basket, then (c) write a 1–2 sentence risk wrap. Do NOT call suggest_trade per-leg — always use suggest_trades_batch for portfolio plans. Do NOT write the trade plan in prose or a markdown table.
refer
ChatGPTShow the authenticated user's referral link and stats. Called when the user types /refer, or whenever they want to refer someone to Liquid, invite friends, share the app, or ask for a referral link. Returns a widget with copy/share buttons and referral performance summary.
refer
ChatGPTShow the authenticated user's referral link and stats. Called when the user types /refer, or whenever they want to refer someone to Liquid, invite friends, share the app, or ask for a referral link. Returns a widget with copy/share buttons and referral performance summary.
reset_paper_account
ChatGPTReset the current paper trading account back to its original state: wipes every open position, cancels every open order, clears fills / funding history / leverage overrides, and restores the balance to the default equity (10,000 USD). Only works while paper trading is enabled — refuses to run in live mode to prevent accidents. Use this when the user asks to 'reset my paper account', 'start over', 'give me a fresh 10k', 'wipe my paper trades', or similar. This is destructive and irreversible for the paper account; there is no confirmation step beyond the user's request.
reset_paper_account
ChatGPTReset the current paper trading account back to its original state: wipes every open position, cancels every open order, clears fills / funding history / leverage overrides, and restores the balance to the default equity (10,000 USD). Only works while paper trading is enabled — refuses to run in live mode to prevent accidents. Use this when the user asks to 'reset my paper account', 'start over', 'give me a fresh 10k', 'wipe my paper trades', or similar. This is destructive and irreversible for the paper account; there is no confirmation step beyond the user's request.
search_markets
ChatGPTSearch or browse the authoritative list of tradeable markets on Liquid. Use when the user asks what markets are available, wants to browse assets, needs to find a specific market symbol, or asks whether Liquid can trade something. Returns top markets by volume if no query, or filtered results matching a search term. Liquid covers equities, commodities, indices, crypto, and other supported markets. Do NOT use this for single-asset analysis (price, outlook, positioning) — use analyze_market instead. No visual — use show_market_overview for the full dashboard view.
search_markets
ChatGPTSearch or browse the authoritative list of tradeable markets on Liquid. Use when the user asks what markets are available, wants to browse assets, needs to find a specific market symbol, or asks whether Liquid can trade something. Returns top markets by volume if no query, or filtered results matching a search term. Liquid covers equities, commodities, indices, crypto, and other supported markets. Do NOT use this for single-asset analysis (price, outlook, positioning) — use analyze_market instead. No visual — use show_market_overview for the full dashboard view.
show_chart
ChatGPTRender a visual price chart (candlestick) widget for a specific asset. Only call when the user explicitly asks to see a chart, price history, or candlestick view (e.g. 'show me a chart of BTC', 'chart ETH'). Do NOT call for general price or analysis queries — use analyze_market instead, which returns price data as text without needing a visual chart.
show_chart
ChatGPTRender a visual price chart (candlestick) widget for a specific asset. Only call when the user explicitly asks to see a chart, price history, or candlestick view (e.g. 'show me a chart of BTC', 'chart ETH'). Do NOT call for general price or analysis queries — use analyze_market instead, which returns price data as text without needing a visual chart.
show_deposit
ChatGPTShow the deposit widget so the user can fund their Liquid account. Offers credit card via Stripe, credit card via Swapped, Other Apps (Coinbase, MetaMask, etc.), and wallet transfer. The user picks a method in the widget.
show_deposit
ChatGPTShow the deposit widget so the user can fund their Liquid account. Offers credit card via Stripe, credit card via Swapped, Other Apps (Coinbase, MetaMask, etc.), and wallet transfer. The user picks a method in the widget.
show_market_overview
ChatGPTRender a visual market overview dashboard showing Liquid's full multi-asset trading surface, including equities, commodities, indices, crypto, and other supported markets. Only call when the user explicitly asks to see all markets, wants the full dashboard view, or asks for a visual overview of market activity. Do NOT use for single-asset queries — use analyze_market instead. Do NOT use for text-only market listings — use search_markets instead.
show_market_overview
ChatGPTRender a visual market overview dashboard showing Liquid's full multi-asset trading surface, including equities, commodities, indices, crypto, and other supported markets. Only call when the user explicitly asks to see all markets, wants the full dashboard view, or asks for a visual overview of market activity. Do NOT use for single-asset queries — use analyze_market instead. Do NOT use for text-only market listings — use search_markets instead.
show_orderbook
ChatGPTRender an orderbook depth view widget for a specific asset. Only call when the user explicitly asks to see the order book, bid/ask spread, or market depth for a specific market. Do NOT call for general price or analysis queries — use analyze_market instead.
show_orderbook
ChatGPTRender an orderbook depth view widget for a specific asset. Only call when the user explicitly asks to see the order book, bid/ask spread, or market depth for a specific market. Do NOT call for general price or analysis queries — use analyze_market instead.
show_portfolio_chart
ChatGPTRender a visual pie chart of portfolio allocation by notional value. Only call when the user explicitly asks to see a portfolio chart, allocation breakdown, or visual representation of their positions. Do NOT call for general portfolio/balance queries — use get_portfolio instead, which returns text data.
show_portfolio_chart
ChatGPTRender a visual pie chart of portfolio allocation by notional value. Only call when the user explicitly asks to see a portfolio chart, allocation breakdown, or visual representation of their positions. Do NOT call for general portfolio/balance queries — use get_portfolio instead, which returns text data.
suggest_trade
ChatGPTSuggest a trade with an interactive widget that links to Liquid with the order panel pre-filled. When your analysis concludes with a specific directional trade (asset + side + size), call this tool to render the trade card instead of writing the parameters in prose or a markdown table. Only call when you have a concrete, data-backed trade recommendation — always call analyze_market first to gather data. Requires: asset, side, leverage, orderType, size, reasoning. TP/SL optional. This MCP does not execute orders; the user must review and place any trade in the Liquid app. Do NOT call on purely informational queries. 'No trade' is a valid position. PREREQUISITE: call get_portfolio first to check available_balance. available_balance is margin/collateral capacity, not notional. The trade link is also hard-capped against current available margin before it is generated.
suggest_trade
ChatGPTSuggest a trade with an interactive widget that links to Liquid with the order panel pre-filled. When your analysis concludes with a specific directional trade (asset + side + size), call this tool to render the trade card instead of writing the parameters in prose or a markdown table. Only call when you have a concrete, data-backed trade recommendation — always call analyze_market first to gather data. Requires: asset, side, leverage, orderType, size, reasoning. TP/SL optional. This MCP does not execute orders; the user must review and place any trade in the Liquid app. Do NOT call on purely informational queries. 'No trade' is a valid position. PREREQUISITE: call get_portfolio first to check available_balance. available_balance is margin/collateral capacity, not notional. The trade link is also hard-capped against current available margin before it is generated.
suggest_trades_batch
ChatGPTSuggest 2–8 related trades together as a basket with links to Liquid for review. Use ONLY when the user explicitly asks for multiple trades at once (e.g. 'long BTC and short ETH', 'open my pairs trade', 'give me a basket'). For a single trade always use suggest_trade. PREREQUISITE: call get_portfolio first and verify available_balance covers the SUM of required margin/collateral, not the SUM of notionals. The basket link is also hard-capped against current available margin before it is generated. Each trade is validated independently — invalid trades are rejected with a clear reason. This MCP does not execute orders; the user must review and place any trade in the Liquid app.
suggest_trades_batch
ChatGPTSuggest 2–8 related trades together as a basket with links to Liquid for review. Use ONLY when the user explicitly asks for multiple trades at once (e.g. 'long BTC and short ETH', 'open my pairs trade', 'give me a basket'). For a single trade always use suggest_trade. PREREQUISITE: call get_portfolio first and verify available_balance covers the SUM of required margin/collateral, not the SUM of notionals. The basket link is also hard-capped against current available margin before it is generated. Each trade is validated independently — invalid trades are rejected with a clear reason. This MCP does not execute orders; the user must review and place any trade in the Liquid app.
view_open_orders
ChatGPTList the user's currently open orders — includes resting limit orders and position-level trigger orders (TP/SL). Use when the user asks about pending orders, working orders, resting limits, or current TP/SL levels. Do NOT confuse with get_portfolio — this shows ORDERS (pending/resting), not POSITIONS (active holdings). Returns text (no widget) with order id, symbol, side, kind (limit/tp/sl/trigger), size, price or trigger, and flags. This MCP does not cancel or modify orders; direct the user to Liquid if they want to act on an open order.
view_open_orders
ChatGPTList the user's currently open orders — includes resting limit orders and position-level trigger orders (TP/SL). Use when the user asks about pending orders, working orders, resting limits, or current TP/SL levels. Do NOT confuse with get_portfolio — this shows ORDERS (pending/resting), not POSITIONS (active holdings). Returns text (no widget) with order id, symbol, side, kind (limit/tp/sl/trigger), size, price or trigger, and flags. This MCP does not cancel or modify orders; direct the user to Liquid if they want to act on an open order.
