> For the complete documentation index, see [llms.txt](https://limelight-1.gitbook.io/limelight-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://limelight-1.gitbook.io/limelight-docs/knowledge-base/discord-bot.md). # Discord Bot Trade prediction markets without leaving Discord. The Limelight Discord bot — **@AskLimelight** (`AskLimelight#9806`) — lets you browse markets, buy and sell, claim winnings, and create your own markets, right inside Discord. It works with both **slash commands** and **plain-English chat**. > Want it in your own server? Add the bot from [limelight.markets](https://limelight.markets/) ("Add to Discord"). The bot trades in **USDCx** on Movement, and it never holds your keys — every trade waits for your confirmation. ### Adding Limelight to Your Server Limelight lives in your server as a bot that a **server admin adds once**. After that, your members can use it from any channel the bot can see — with slash commands or by @mentioning it. (You need the **Manage Server** permission to add any bot.) **Add the bot:** 1. Open the invite link — [**Add Limelight to Discord**](https://discord.com/oauth2/authorize?client_id=1519204883922948256\&permissions=2147568640\&integration_type=0\&scope=bot+applications.commands) — also available as **"Add to Discord"** on [limelight.markets](https://limelight.markets/). 2. Choose the server, click **Continue**, then **Authorize**. 3. Done — `@AskLimelight` joins your server and its slash commands (`/markets`, `/buy`, …) become available. **It asks for only the minimum permissions** needed to read commands and post replies: | Permission | Why it's needed | | -------------------- | ----------------------------------------- | | View Channels | See the channels it's used in | | Send Messages | Post replies and market cards | | Embed Links | Render the rich market / trade cards | | Read Message History | Follow a conversation thread | | Use Slash Commands | Register `/markets`, `/buy`, and the rest | It requests **no administrative permissions** — no Manage Server, Manage Roles, Kick/Ban, or Mention Everyone. The bot only responds to **slash commands, @mentions, and DMs**; it doesn't monitor your server's general chat. **After adding:** * Make sure the bot can **View Channel** and **Send Messages** in whatever channel you want it used — a dedicated channel like `#prediction-markets` works well. * Members start with `/markets` or *"what's trending?"*, and each member **links their own Limelight account** (next section) before they can trade. > Adding the bot doesn't link anyone automatically — **each member links their own account**. Info commands work for everyone; trading and account commands require each member to link. ### Two Ways to Talk to It * **Slash commands** — type `/` and pick a command (`/markets`, `/buy`, …). Fields autocomplete. * **Natural language** — just say what you want, in a **DM** to the bot or by **@mentioning `@AskLimelight`** in a server. *"what's trending?"*, *"buy 10 yes on bitcoin"*, and *"my portfolio"* all work. ### What Works Without Linking Anyone can ask the bot for **information** — no account needed: * `trending`, `new markets`, `ending soon`, `highest volume` * `odds on `, `status of `, `rules for ` * `help` ### What Needs a Linked Account To **trade or see your own account**, you first link your Discord account to your Limelight account (see below). These require a link: * **Actions** — `buy`, `sell`, `claim` (redeem winnings), `create market` * **Your account** — `profile`, `my portfolio`, `my position on `, `my trades`, `my markets` If you try one of these before linking, the bot replies: > 🔗 Your account isn't linked yet. Run `/connect` first. ### Connecting Your Discord Account Linking ties your Discord identity to your Limelight account so the bot can act for you. You do it once, on the website. (We assume you're already signed in to Limelight.) 1. Go to [limelight.markets](https://limelight.markets/) and sign in — Limelight uses **Privy** for sign-in. 2. Open the **More** menu → **Profile Settings**. 3. Switch to the **Account Access** tab. 4. Find **Discord** and click **Link Account**. 5. **Authorize** in the browser window that opens. When it finishes, Discord shows as linked on your profile — you're ready to trade from Discord. You can also start linking from inside Discord by running **`/connect`** — it opens the same browser flow. > **Linking always happens in your web browser.** Even if you use the **Discord desktop app**, clicking **Link Account** (or running `/connect`) opens your default browser — Chrome, Edge, or Firefox — for the secure authorization, then returns you linked. This is just how Privy's sign-in works on desktop: the authorization handshake has to complete in a browser before the credentials come back to the app. Complete the **Authorize** step in the browser and you're done. Linking your Discord account also lets you **log in to Limelight with Discord** and receive **notifications** from the bot. You can unlink anytime from the same **Account Access** screen. ### Slash Commands | Command | What it does | | -------------- | ---------------------------------------------------------------------- | | `/markets` | Browse markets — sort by Trending, New, Ending soon, or Highest volume | | `/market` | Full detail card for one market (odds, volume, time left, status) | | `/buy` | Buy shares in an outcome (preview → confirm) | | `/sell` | Sell shares you hold (preview → confirm) | | `/claim` | Claim winnings from a resolved market you won | | `/portfolio` | Your wallet balance and open positions | | `/create` | Create a new market | | `/leaderboard` | Top Predictors, ranked by P\&L | | `/stats` | Your own rank, P\&L, volume, points, and market count | | `/connect` | Link your Discord account to your Limelight account | ### Ask the Bot (Plain English) | Say | You get | | ---------------------------------------------------------------- | ------------------------------------------------------------------------------ | | `trending` / `what's trending?` | Top active markets | | `new markets` | Freshly listed markets | | `ending soon` | Markets closing this week | | `highest volume` / `most traded` | The biggest markets by volume | | `odds on ` / `status of ` / `rules for ` | A market's detail card | | `profile` | Your account snapshot (balance, lifetime P\&L, markets created / traded / won) | | `my portfolio` | All your open positions | | `my position on ` | Your holdings in one market | | `my trades` | Your recent trades | | `my markets` | Markets you created | > Use the **plural** forms ("my markets", "my trades") — the bot may not recognize the singular. ### Buying & Selling Every trade is **two steps: preview → Confirm**. You name the market, outcome, and amount; the bot shows a preview (outcome, spend, estimated shares); you click **Confirm** and it sends the on-chain transaction. * Trades settle in **USDCx**, with the **same minimums as the website** ($0.10 to buy; no minimum to sell). * The trade is **re-priced at confirm** with a **10% slippage cap**, and the preview expires after a few minutes if you don't confirm. * `/sell` only lists markets and outcomes **you actually hold**; omit the amount to **sell your whole position**. * You get a **Movement Explorer** transaction link when the trade lands. ``` You: /buy market: Will Brazil win the 2026 World Cup? outcome: Yes amount: 10 Bot: 🟢 Confirm buy 📌 Will Brazil win the 2026 World Cup? · Yes 10 USDCx → ~12.5 shares · re-priced at confirm (10% slippage cap) [ Confirm ] [ Cancel ] You: [Confirm] Bot: ✅ bought! 12.5 shares · entry $0.80 · potential payout $12.50 🔗 tx → explorer.movementnetwork.xyz/txn/0x... ``` > A trade preview started by **chat** in a server is visible to others, but **only you can confirm it** — if someone else clicks Confirm, the bot tells them it isn't their trade. Slash-command previews are private to you. ### Claiming Winnings When a market you hold resolves in your favor, run **`/claim`** (or say *`redeem `*). The bot lists only the markets you **won** and claims your payout on-chain. There's nothing to claim if your shares didn't win or you already claimed. ### Creating a Market in Discord Run **`/create`** (or say *`create market about `*). You provide four things; the bot's AI drafts the rest (title, outcomes, resolution rules, sources) for you to review: | You provide | Notes | | --------------- | ------------------------------------------------------- | | **Topic** | What the market is about | | **Funding** | Seed liquidity, **minimum $100** in USDCx | | **Creator fee** | **0–2%** | | **Cover image** | Paste an image link **or upload a PNG / JPEG** (≤ 5 MB) | Optionally add a close date — otherwise the bot picks one. The bot shows a **draft card with your image rendered**; click **Submit for review**. Your market deploys on-chain and enters **review (\~24h)** — once approved, it goes live, and the bot **@mentions you** when it does. > **Creation access** follows the website: open to everyone for about the first month, then gated to [Limelight Catalyst](https://file+.vscode-resource.vscode-cdn.net/c%3A/Users/Yunero/Downloads/limelight-gitbook/for-creators/limelight-catalyst.md) holders. The funding minimum and fee range match [Creating a Market](https://file+.vscode-resource.vscode-cdn.net/c%3A/Users/Yunero/Downloads/limelight-gitbook/for-creators/creating-a-market.md). ``` You: /create topic: Who wins the Golden Boot at the 2026 World Cup? funding: 150 fee: 1 image_file: [upload] Bot: 🛠️ Drafting your market with AI — this usually takes up to a minute… Bot: 📋 Market draft — review & submit 📌 Who wins the Golden Boot at the 2026 World Cup? 🎯 Outcomes: Mbappé · Yamal · Kane · … ⏰ Closes 2026-07-20 · 🏷️ Sports · 💰 $150 · 💸 fee 1% [ Submit for review ] [ Cancel ] You: [Submit for review] Bot: 🎉 Submitted — your market is deploying on-chain and now in review. 📈 https://limelight.markets/markets/0x... ``` If a market needs a change before it can go live, the bot shows the **proposed update inline** (with the changed fields highlighted) and gives you, the creator, **Accept** or **Reject** buttons. Rejecting cancels the market and refunds your seed. ### Leaderboard & Stats * **`/leaderboard`** — public **Top Predictors**, all-time, **ranked by P\&L** (shows P\&L, volume, and points). Top 10 by default. * **`/stats`** — your own line: rank, P\&L, volume, points, and markets traded. ### Notifications With a linked account, the bot keeps you posted (as channel messages that **@mention you**): * 🎉 **Your market is live** — after it clears review. * ❌ **Your market was rejected** — with the reviewer's reason, so you can fix it and re-submit. * 🏆 **A market resolved** — winners get pinged with a **Claim** button. ### Funding & Safety * **Deposits and withdrawals stay on the website.** Fund your Limelight balance at [limelight.markets](https://limelight.markets/) (see [Wallets & Networks](/limelight-docs/knowledge-base/wallets-and-networks.md)); the bot is the Discord-native way to **trade**. * **You stay in control.** Sign-in and linking run through **Privy** — the bot never holds your keys, and every trade needs an explicit **Confirm**. * **Real funds, non-reversible.** Trades settle on-chain. The bot will **never** ask for a seed phrase or private key — don't share them with anyone. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://limelight-1.gitbook.io/limelight-docs/knowledge-base/discord-bot.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.