Co-Invest Docs

Overview

Co-Invest is Liquid delivered as an MCP (Model Context Protocol) server. Once connected, your AI assistant can research markets with the same data professional desks use — live prices, funding rates, open interest, whale positioning, liquidation maps, and news — and then propose real trades on your Liquid account. They are the same orders you would send from the Liquid app, just placed from chat.

Standard Co-Invest in ChatGPT, Claude, and Meta Muse keeps order submission behind an explicit confirmation from you. Grok Bot uses Co-Invest Computer, which can simulate, stage orders for review, or send live orders within the limits you enable. Neither connection can withdraw or transfer funds on its own.

Liquid does not maintain a custodial account balance for you: you authorize wallet actions directly. Collateral committed to an underlying trading venue remains subject to that venue's margin, liquidation, and withdrawal rules.

Connecting Co-Invest

The standard Co-Invest server lives at https://coinvest.liquid.trade. Most MCP clients connect there; client-specific setup differences are listed below.

ChatGPT

1. Open the Co-Invest app in ChatGPT's app directory.
2. Hit Connect and approve access to your Liquid account.
3. Start a new chat with Co-Invest selected and ask it to research a market or place a trade.

Claude

1. Open Claude's connector settings and click Add custom connector.
2. Name it Co-Invest and paste https://coinvest.liquid.trade as the server URL.
3. Hit Connect and sign in to your Liquid account when prompted.

Meta Muse

1. Start a new chat and ask Muse to connect https://coinvest.liquid.trade/mcp as a connector called Co-Invest.
2. Open the sign-in link it returns and approve access to your Liquid account.
3. Ask it to check your portfolio or scan the market. See the Muse setup guide.

Grok Bot

1. Start a new chat and ask Grok Bot to connect https://coinvest-computer.liquid.trade/mcp as a connector.
2. Open the sign-in link it returns and approve access to your Liquid account.
3. Ask it to check your portfolio or scan the market. See the Grok Bot setup guide.

Claude Desktop, Claude Code, and other stdio clients

Clients that speak stdio instead of HTTP can bridge to the server with mcp-remote. For Claude Desktop, add this to claude_desktop_config.json:

{
  "mcpServers": {
    "liquid-co-invest": {
      "command": "npx",
      "args": ["mcp-remote", "https://coinvest.liquid.trade/mcp"]
    }
  }
}

Cursor and other HTTP clients

Clients that support remote MCP servers directly just need the URL. For Cursor, add this to .cursor/mcp.json or the MCP settings UI:

{
  "liquid-co-invest": {
    "url": "https://coinvest.liquid.trade/mcp"
  }
}

Both https://coinvest.liquid.trade and https://coinvest.liquid.trade/mcp work as the standard server address — use whichever your client expects.

Chrome extension & TradingView

Co-Invest also comes as a free Chrome extension that trades from the pages you already read, with no chat involved. It adds a Long/Short trade card beside tickers on X, Reddit, CNBC, Bloomberg, MetaTrader Web, and Axiom, and a Trade button on TradingView charts. It connects to the same Liquid account as every other Co-Invest client.

Trading on Liquid from TradingView

1. Install Co-Invest for Chrome from the Chrome Web Store in desktop Chrome.
2. Open the Co-Invest side panel and sign in to your Liquid account.
3. Open a chart at tradingview.com. A Trade button appears in the top toolbar, next to Replay.
4. Press Trade to open a card for the symbol you're charting, pick Long or Short, set your size and multiplier, and press Confirm.

The order goes to your Liquid account as a market order, with an optional take-profit and stop-loss. There is no broker to connect inside TradingView, and nothing is sent until you press Confirm. If the charted symbol has no Liquid market, the button is greyed out. The guide Can you trade on Liquid with TradingView? lists which chart symbols map to which Liquid markets.

Signing in & permissions

Co-Invest uses standard OAuth. The first time you connect, your client opens a Liquid sign-in page in the browser; you sign in to your Liquid account and approve the connection. The token your client receives grants two scopes: read (market data, portfolio, and account state) and trade (placing and managing orders under the execution flow supported by that client).

The connection cannot withdraw or transfer funds or change your account settings. On standard Co-Invest, an order is not sent until you confirm it. Co-Invest Computer can instead simulate, stage, or send live orders within configured limits. Liquid does not maintain a custodial account balance for you; you authorize wallet actions directly, while collateral committed to an underlying venue remains subject to that venue's margin and withdrawal rules.

If your account is brand new, the assistant will walk you through the remaining setup on your first trade — funding the account and approving the trading agent key. You can also just ask it “am I set up to trade?”

What Co-Invest can do

You don't need to memorize commands — describe what you want in plain language and the assistant picks the right capability. This is what's under the hood.

How execution is authorized

In standard Co-Invest, a proposed trade renders a confirmation card in the chat showing the symbol, direction, size, leverage, any take-profit or stop-loss, and a short note on why. Tap Confirm to send the order to Liquid; tap Cancel to throw it away. Batches work the same way — even when the assistant suggests several trades at once, an explicit confirmation from you is required before they are sent.

Grok Bot uses Co-Invest Computer. In simulation, no live order is sent. Staged mode prepares orders for review; live mode can send orders within the limits you configured. You can pause the automation or revoke access if you want to take back manual control.

For standard Co-Invest, the same confirmation rule applies to modifying TP/SL, changing leverage, and closing positions. Proposals also get sanity-checked — for example, a stop-loss at or past your liquidation price is rejected instead of placed.

Paper trading

Want to try the workflow without risking money? Tell the assistant to switch to paper mode. Your account flips to a simulated balance of $10,000 running against live market data — real prices, fake money. Place test trades, see how confirmations feel, and switch back to live whenever you're ready.

While paper mode is on, the assistant explicitly labels everything as simulated so there's no confusion about which account you're trading. You can ask for your paper status at any time, reset the paper account back to its starting balance, or say “go back to live trading” to switch off. The setting sticks between conversations until you change it.

Markets you can trade

Liquid's perpetual markets span crypto, US stocks, commodities, the major FX pairs, indices, and pre-IPO names like OpenAI and Anthropic. Perpetuals can be traded long or short, with multipliers where supported. Co-Invest also supports Liquid prediction markets: YES/NO event contracts are not leveraged.

Proprietary positioning analytics (whale exposure, liquidation clusters, behavioral cohorts) cover Liquid's core crypto universe. For stocks, commodities, and other markets the assistant leans on price action, market structure, and news instead.

Fees & limits

Co-Invest itself is free — no subscription, no AI surcharge, no markup in the spread. You pay the standard Liquid trading fees, plus the usual funding rates if you hold perps.

Orders need at least $15 of collateral. With leverage, the minimum position size scales with the multiplier — $15 of collateral at 5x is a $75 position, at 10x a $150 position. The assistant knows these bounds and will size proposals accordingly.

Troubleshooting

The connector won't connect

Double-check the server URL against the client-specific setup above. Grok Bot should use https://coinvest-computer.liquid.trade/mcp, while clients using the standard Co-Invest server should use https://coinvest.liquid.trade. If your client cached a failed attempt, remove the connector and add it again.

The consent screen shows an unverified-app warning

Connections from clients Liquid hasn't verified show a warning on the sign-in screen. That's expected for less common MCP clients — read what the screen says you're approving before you continue, and if anything looks off, stop and connect from Claude or ChatGPT instead.

“Trading not enabled” on your first trade

Two usual causes: the account isn't funded yet, or the trading agent key hasn't been approved. The assistant detects which one it is and walks you through fixing it — typically a deposit or a quick re-authorization in the browser.

Something else

For account or trading help, start a live chat from the support page. For community discussion, use Discord or Telegram. For platform-wide documentation beyond Co-Invest, head to docs.liquid.trade.