> For the complete documentation index, see [llms.txt](https://polypoll.gitbook.io/polypoll-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://polypoll.gitbook.io/polypoll-docs/overview/how-it-works.md).

# How It Works

PolyPoll paper mode is a free prediction market system that settles in **POLL points** instead of money.

We are doing that on purpose.

Real-money prediction products are harder to onboard on mobile, especially across iOS and Android, and early losses make new users stop playing fast. POLL points let people learn the game first, create more often, and stay in the loop longer.

## The four steps

### 1. Join free

Every account starts with **10,000 POLL**. This is your paper bankroll.

If your balance falls below **1,000 POLL**, you can refill back to **2,500 POLL** once every 24 hours.

### 2. Create from the internet you already use

Markets can be:

* **Binary**: Yes / No
* **Multiple choice**: one winning option across many outcomes

When you create a market, you set:

* the question
* the close date
* the opening odds
* the liquidity setting
* optional resolution criteria, background, and cover image

PolyPoll’s original ethos still matters here:

* create from **X**
* create from the **Chrome extension**
* create from **Discord**

### 3. Trade live odds

Paper markets use an offchain **LS-LSMR** engine. That means:

* prices move when people buy or sell
* you can always get a quote
* larger trades have more price impact
* more liquidity means smoother price movement

### 4. Resolve and claim

When the event is known:

* the creator or an admin resolves the market
* winning shares become claimable
* each winning share pays **1 POLL point**
* any creator fee pool is paid to the creator at resolution

## Roles in paper mode

### Trader

Uses a paper bankroll to buy and sell shares.

### Creator

Publishes markets, receives a **100 POLL** market bonus, and earns **20% of the trade fee pool** when the market resolves.

### Admin

Can moderate and resolve markets when needed.

## AI helpers

The paper creator can use AI to:

* rewrite messy titles into clearer market language
* generate **Resolution criteria**
* generate **Background**
* generate multi-choice answers
* suggest topic tags
* find a relevant cover image

The AI is a helper, not the source of truth. Final resolution always follows the published market criteria.

## Product philosophy

PolyPoll is our tip of the hat to Manifold’s paper-market playbook:

* live odds
* low friction
* easier onboarding
* more room to learn before real money gets involved

The goal is not just to simulate a market. The goal is to make markets easier to create, easier to share, and easier to understand.


---

# 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://polypoll.gitbook.io/polypoll-docs/overview/how-it-works.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.
