HedgeDocs

Guides / Hedgie

Guides

Hedgie

Hedgie is Hedge's prediction copilot. Ask about live markets in plain English, get odds and context grounded in the desk, and when you clearly want a position, receive a trade ticket you review and open yourself.

Open hedgeapp.trade/ai or tap the Hedgie icon in the header. Hedgie is not a general chatbot and not an autotrader. He is scoped to Hedge: listed leverage markets, trending spot, how the vault works, and how to read a ticket.

#What Hedgie can do

  • Answer from the live book. Every turn refreshes a snapshot of listed leverage markets and trending spot. Yes and No are quoted in cents from that feed, not from memory.
  • Explain the desk. 1x vs vault leverage, the 35¢ to 65¢ band, max leverage per market, fees, carry, Earn, and how spot differs from synthetic margin. See Leverage markets for the full rules.
  • Compare names. Which leverage market has the best Yes in band, what the implied chance is on a headline, whether a name is on the allowlist for 2x to 4x.
  • Draft a trade ticket. When you clearly want to open a position, Hedgie can propose margin, side, and leverage on a real market id. The app turns that into a card with Review & open.

#What Hedgie cannot do

  • Place or cancel orders. The model never signs a transaction. You always land on the market page and confirm on the trade panel.
  • Invent markets or prices. If a slug, id, or quote is not in the live context for that turn, Hedgie is instructed to treat it as unavailable.
  • Offer vault leverage everywhere. 2x to 4x only applies to hand-listed markets when Yes sits inside the band. Everything else is 1x spot.
  • Discuss off-desk topics. News digests, portfolio advice outside Hedge, or unrelated prompts get a short decline and a steer back to the product.

#How a turn works

Hedgie runs on the server. Your browser posts the conversation to /api/hedgie. The model API key never ships to the client.

  1. 1

    Build live context

    The server pulls the leverage allowlist (titles, slugs, ids, Yes/No, in-band or off-band, max leverage, 24h volume) and up to twelve trending spot markets that are not already on that list.

  2. 2

    Stream the reply

    That snapshot is injected as the source of truth for the turn. The last sixteen messages of your thread are kept so follow-ups like “make that 2x” still make sense. Tokens stream back into the chat as they arrive.

  3. 3

    Parse a ticket, if any

    When Hedgie proposes a trade, he emits a structured block the app strips out of the prose and renders as a ticket card. Pure questions do not produce a ticket.

  4. 4

    Review and open

    Review & open deep-links to the market with side and leverage query params pre-filled on the trade panel. You still size, read the quote, and confirm. See Placing a trade.

#Trade tickets

A ticket card shows the market title, Yes or No, margin, leverage, and notional (margin × leverage). Defaults are conservative: if you do not name a stake, margin defaults to $5; if you do not name leverage, it defaults to 1x. Hedgie will not exceed that market’s max leverage.

FieldMeaning
marginUSDG you post. On 1x this is the buy size; on leverage it is collateral.
leverage1x is spot. 2x to 4x is vault margin on listed markets when Yes is in band.
Review & openOpens the market page with ?m= market id, ?s= side, and ?lev= when leverage is above 1x.

#Example prompts

  • Which leverage market has the best Yes price in band?
  • What is the implied chance on [event]?
  • Open $5 Yes on [market] at 2x
  • How does vault leverage work?
  • Is [market] listed for leverage right now?

#Who this helps

#New traders

Hedgie is a guided path into the vocabulary: cents as probability, spot vs vault, why a selector might be greyed out off-band. You can ask before you click.

#Active traders

A second screen that already knows which names are listed, which can take 4x at current TVL, and what the live Yes is. Faster from intent to a reviewed ticket, without giving the model your keys.

#LPs and readers

Plain-language explanations of Earn, fees, and how trader P&L flows through senior and junior tranches. For formulas, use The mathematics.

#Privacy and availability

Conversation text is sent to the server for each turn so Hedgie can answer with live context. The OpenRouter credential lives in server environment variables only. If Hedgie is not configured, the app shows that he is unavailable rather than exposing setup details in the browser.

Hedgie can be wrong or briefly out of date. Treat him as a clerk on the desk: useful, fast, and never the person who hits send.