> For the complete documentation index, see [llms.txt](https://docs.common.xyz/commonwealth/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.common.xyz/commonwealth/community-overview-1/farcaster-contests/farcaster-contestbot.md).

# Farcaster ContestBot

## Common Farcaster ContestBot User Documentation

### Introduction

The **ContestBot** on Farcaster allows users to create and manage contests effortlessly by simply prompting **@contestbot**. The bot manages all contest logistics, from prize distribution to voting, making it easy to engage and reward community participation.

### How to Start a Contest

1. **Prompt the Bot**
   * Mention **@contestbot** in a cast with the title of the contest and the token address you want to use for funding.
   * Example:

     ```
     Hey @contestbot, launch a Best Memes Only contest! Fund it with 0x429ae85883f82203D736e8fc203A455990745ca1 on Base.
     ```
2. **ContestBot will reply** with a contest frame, officially launching the contest.
3. **Users can enter** by replying to the original cast with their contest submission.

### Prize Distribution

All contests follow a **pre-set prize structure**:

* **First, a 10% fee** is deducted for Common's platform maintenance.
* **From the remaining amount, 10% is allocated to voters.**
* **The final prize pool (remaining 90%) is divided as follows:**
  * 🥇 **1st Place:** 50%
  * 🥈 **2nd Place:** 30%
  * 🥉 **3rd Place:** 20%

#### **Example Breakdown:**

If a contest is funded with **100 USDC**:

* **10 USDC** goes to platform fees.
* **10% of remaining 90 USDC** (9 USDC) is distributed among voters.
* **Final prize pool of 81 USDC** is split:
  * 1st place: 40.5 USDC
  * 2nd place: 24.3 USDC
  * 3rd place: 16.2 USDC

### Funding a Contest

* **You must join the** [**ContestBot Community**](https://common.xyz/cw-contest-bot/discussions?tab=all) **on Common** for the **fund** button to appear.
* **You need to approve two transaction requests via your wallet** to fund the contest.
* **Any user with a connected wallet** can contribute to the prize pool once the contest is live.

### Contest Management

* All contests are **owned and managed** by **@contestbot** within a dedicated **Common community**.
* **@contestbot acts as the admin**, ensuring automation, fairness, and seamless execution.

### Entering and Voting

* **Entries:** Any reply to the contest cast containing the contest frame is considered a contest submission.
* **Voting:**
  * Users can vote by adding the **“Upvote Content”** action on Warpcast.
  * **One Token = One Vote:** Only users who hold the contest’s funding token can vote.
  * **10% of the prize pool is allocated to voters** to encourage community participation.

### Summary

* Start a contest by prompting **@contestbot** with a title and token address.
* Pre-set **prize distribution** ensures fairness.
* **You must join the** [**ContestBot Community**](https://common.xyz/cw-contest-bot/discussions?tab=all) **on Common to fund contests.**
* **Any user can fund** a contest but must **approve two transactions** in their wallet.
* **All contests are bot-managed** within a Common community.
* **Prize breakdown ensures fairness, with 10% going to voters and a structured prize split.**

The **ContestBot** makes running contests seamless, transparent, and fun—so you can focus on engaging your community and rewarding creativity!

👉 **Join the bot on Warpcast:** [@contestbot](https://warpcast.com/contestbot)


---

# 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://docs.common.xyz/commonwealth/community-overview-1/farcaster-contests/farcaster-contestbot.md?ask=<question>&goal=<endgoal>
```

`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.