> For the complete documentation index, see [llms.txt](https://docs.pages.koto.trade/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pages.koto.trade/product/competition.md).

# Competition

Competition turns trading into time-based campaigns. Users can join published events, understand the rules, track progress where scoring is active, and follow rewards after the campaign ends.

## Business Purpose

Koto competitions give traders a reason to participate beyond a single trade. Campaigns can reward eligible activity, create leaderboards, highlight community participation, and make trading goals visible through prizes, milestones, and rules.

## Description

A competition is a campaign with its own title, schedule, rules, eligibility, scoring model, and reward structure. Some campaigns are built around ranked trading volume. Others can be preview, registration, or participation-style events where the focus is joining rather than live scoring.

Each competition page should make the important user questions clear: what is this campaign, when does it run, who can join, what activity counts, how rewards work, and when results become final.

## How It Works

1. The user opens the competition list and chooses an available campaign.
2. The user reviews the campaign phase: upcoming, live, ended, or settled.
3. The user reads the schedule, rules, prize pool, eligibility, and reward details.
4. The user joins when the campaign allows it. Some campaigns may ask the user to select the account whose activity should count.
5. During a scored campaign, Koto tracks eligible activity according to that campaign's rules.
6. If the campaign has a leaderboard, the user can follow rank, volume, qualification status, and recent update timing where available.
7. After the campaign ends, Koto reviews eligibility and confirms final standings before rewards are settled.

## Campaign Formats

Competition rules can differ by campaign. The page for each campaign should explain its own format in plain language.

* Registration or preview campaigns: users can join or view the campaign, but there may be no live volume scoring.
* Account-scoped campaigns: activity may count only from the account the user selected when joining.
* Koto-routed volume campaigns: eligible activity may count only when trades are placed through the Koto experience.
* Tiered reward campaigns: the total campaign activity can unlock larger prize pools or reward columns.

## Campaign Phases

* Upcoming: the campaign is visible before it starts. Users can read the rules and may be able to join depending on the campaign.
* Live: the campaign is running. Eligible activity can count toward progress when the campaign is scored.
* Ended: the trading window is over. New activity no longer counts, and results may still be under review.
* Settled: final standings and rewards have been confirmed.

## Scoring

Scored competitions usually rank users by eligible trading activity during the campaign window. The most common scoring unit is trading volume: the notional value of eligible fills during the campaign. A campaign page should state what counts before users join.

Scoring can depend on different scopes:

* Account-scoped scoring: only activity from the selected account counts.
* Koto-routed scoring: only activity placed through Koto counts.
* Participation-only scoring: the campaign may show participants without ranking users by trading volume.

Leaderboard position can depend on final eligible activity, minimum qualification requirements, and any review or anti-abuse checks defined by the campaign rules.

## Reward Tiers

Some campaigns use rank-based rewards. In this model, users compete for leaderboard positions, and each rank or rank band has an assigned reward amount. For example, the top rank can receive a larger reward than lower ranks, while rank bands such as 11th-20th can receive the same amount per eligible user.

Some campaigns use milestone-based prize pools. In this model, the campaign starts with a base prize pool, and total eligible campaign activity can unlock larger prize pool tiers. If the campaign ends between two milestones, the highest completed milestone is used.

Example tier structure:

| Campaign Milestone        |  Prize Pool |
| ------------------------- | ----------: |
| Base                      | 10,000 USDT |
| 700M USD+ eligible volume | 20,000 USDT |
| 1.2B USD+ eligible volume | 30,000 USDT |
| 1.5B USD+ eligible volume | 40,000 USDT |
| 2B USD+ eligible volume   | 60,000 USDT |

Reward tables can then show what each rank receives at each unlocked prize pool. Users should read the active campaign page for the exact amounts, thresholds, and rank bands.

## Qualification

A campaign can require a minimum amount of eligible activity before a user qualifies for rewards. A user may appear on a leaderboard but still be below the reward qualification floor. Campaign pages should make this clear before and during participation.

Qualification can also depend on rule compliance. Activity can be excluded if it is abusive, artificial, outside the campaign window, outside the eligible account scope, or otherwise against the campaign rules.

## What It Supports

* Live, upcoming, ended, and settled campaign states.
* Campaign pages with title, subtitle, schedule, rules, FAQs, prize display, and participation state.
* Joining a campaign when the campaign is open and the user is eligible.
* Account selection where a campaign requires account-scoped participation.
* Leaderboards or participant lists where supported by the campaign format.
* User progress, rank, volume, and qualification status where scoring is active.
* Minimum activity floors for reward eligibility where defined by campaign rules.
* Tiered rewards, milestone-based prize pools, and rank-based reward tables where the campaign uses them.
* Final review and reward settlement after the campaign ends.

Manual trading can count when the campaign rules allow it. Bot-generated activity can also count only when the campaign rules explicitly allow it. Koto may exclude activity that violates the campaign rules, including abusive, artificial, or ineligible trading behavior.

## Settlement

After a campaign ends, results are reviewed before rewards are final. Final settlement can include confirming eligible activity, applying qualification floors, removing ineligible activity, finalizing rank, and preparing reward distribution. Users should treat live leaderboard data as provisional until the campaign is settled.


---

# 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.pages.koto.trade/product/competition.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.
