Add new Polymarket documentation (2026-02-17)
- Added 31 new documentation pages from llms.txt index - Updated changelog and 4 existing pages - New categories: polymarket-learn (FAQ, deposits, get-started, markets, trading) - New API: get-positions-for-a-market - New guide: builders examples
This commit is contained in:
AI Agent
@@ -0,0 +1,35 @@
|
||||
> ## Documentation Index
|
||||
> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt
|
||||
> Use this file to discover all available pages before exploring further.
|
||||
|
||||
# How Are Markets Disputed?
|
||||
|
||||
**Anyone can dispute a proposed market resolution if they feel it was proposed in error.**
|
||||
|
||||
Once a market is proposed for resolution it goes into a challenge period of 2 hours.
|
||||
|
||||
If no one challenges the proposal the resolution is deemed valid and the proposer receives their bond back plus the reward.
|
||||
|
||||
During the 2-hour challenge period, anyone may dispute the proposal on the [UMA dapp](https://oracle.uma.xyz/) by posting a challenge bond of the same amount as the proposer bond (usually \$750).
|
||||
|
||||
This begins the debate period of 24-48 hours (votes happen every other day and there will always be at least 24 hours for discussion). Anyone wishing to contribute evidence to the discussion can do so in the Uma Discord server in the #evidence-rationale and #voting-discussion channels.
|
||||
|
||||
After the debate period, Uma token holders vote (this process takes approximately 48 hours) and one of four outcomes happens:
|
||||
|
||||
## Outcomes
|
||||
|
||||
### Proposer wins
|
||||
|
||||
Proposer receives their bond back plus half the disputer’s bond as a bounty. Disputer loses their bond.
|
||||
|
||||
### Disputer wins
|
||||
|
||||
Disputer receives their bond back plus half the proposer’s bond as a bounty. Proposer loses their bond.
|
||||
|
||||
### Too Early
|
||||
|
||||
This outcome is for proposals for which the underlying event has not yet happened. Eg the result of a sports match that is still ongoing. Disputer receives their bond back plus half the proposer’s bond as a bounty. Proposer loses their bond.
|
||||
|
||||
### Unknown/50-50
|
||||
|
||||
This (rarely used) outcome is for events where none of the other options are appropriate. In this case the market price resolves to 50 yes and 50 no. Disputer receives their bond back plus half the proposer’s bond as a bounty. Proposer loses their bond.
|
||||
@@ -0,0 +1,33 @@
|
||||
> ## Documentation Index
|
||||
> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt
|
||||
> Use this file to discover all available pages before exploring further.
|
||||
|
||||
# How Are Markets Clarified?
|
||||
|
||||
> How are markets on Polymarket clarified?
|
||||
|
||||
## Overview
|
||||
|
||||
* Markets are resolved according to the rules set forth on the market page.
|
||||
|
||||
* The rules specify the resolution source, the market end date, and they outline how the market should resolve in various edge-cases.
|
||||
|
||||
* The market title describes the market, but the rules define how it should be resolved.
|
||||
|
||||
<Important>It is important to read the rules before trading in a market. </Important>
|
||||
|
||||
<Frame>
|
||||
<img src="https://mintcdn.com/polymarket-292d1b1b/YUHnSq4JdekVofRY/polymarket-learn/markets/market-rules.png?fit=max&auto=format&n=YUHnSq4JdekVofRY&q=85&s=22ee2dab424287bd8ffe4ee8017dff4e" data-og-width="1684" width="1684" data-og-height="1278" height="1278" data-path="polymarket-learn/markets/market-rules.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/polymarket-292d1b1b/YUHnSq4JdekVofRY/polymarket-learn/markets/market-rules.png?w=280&fit=max&auto=format&n=YUHnSq4JdekVofRY&q=85&s=a18e693ed0ef40b937a20c2f016b9285 280w, https://mintcdn.com/polymarket-292d1b1b/YUHnSq4JdekVofRY/polymarket-learn/markets/market-rules.png?w=560&fit=max&auto=format&n=YUHnSq4JdekVofRY&q=85&s=55f60bb6f0fc6e73dbc79f4ddb89a48b 560w, https://mintcdn.com/polymarket-292d1b1b/YUHnSq4JdekVofRY/polymarket-learn/markets/market-rules.png?w=840&fit=max&auto=format&n=YUHnSq4JdekVofRY&q=85&s=fd54012529a854f0eaff03c2b8622923 840w, https://mintcdn.com/polymarket-292d1b1b/YUHnSq4JdekVofRY/polymarket-learn/markets/market-rules.png?w=1100&fit=max&auto=format&n=YUHnSq4JdekVofRY&q=85&s=cee1310e052ddc361c2c5f05cb5af08d 1100w, https://mintcdn.com/polymarket-292d1b1b/YUHnSq4JdekVofRY/polymarket-learn/markets/market-rules.png?w=1650&fit=max&auto=format&n=YUHnSq4JdekVofRY&q=85&s=ddcac99c3515d39e8803420fe47c6263 1650w, https://mintcdn.com/polymarket-292d1b1b/YUHnSq4JdekVofRY/polymarket-learn/markets/market-rules.png?w=2500&fit=max&auto=format&n=YUHnSq4JdekVofRY&q=85&s=d78bcb523db705fe43cf95a9db20b1e0 2500w" />
|
||||
</Frame>
|
||||
|
||||
***
|
||||
|
||||
## Clarifications
|
||||
|
||||
In rare cases, circumstances occur that were not foreseen at a market’s creation and it becomes necessary to clarify rules after trading has begun. In these cases Polymarket may issue an “Additional context” update to the rules.
|
||||
|
||||
<Tip>If you believe a clarification is necessary for a market, the best place to request a clarification is in the [Polymarket Discord](https://discord.com/invite/polymarket) **#market-review** channel.</Tip>
|
||||
|
||||
<Frame caption="An example clarification in the market on what Trump would say during Hannity Town Hall. ">
|
||||
<img src="https://mintcdn.com/polymarket-292d1b1b/YUHnSq4JdekVofRY/polymarket-learn/markets/additional-context.png?fit=max&auto=format&n=YUHnSq4JdekVofRY&q=85&s=c541cfe17203de08a547da32d0995804" data-og-width="940" width="940" data-og-height="482" height="482" data-path="polymarket-learn/markets/additional-context.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/polymarket-292d1b1b/YUHnSq4JdekVofRY/polymarket-learn/markets/additional-context.png?w=280&fit=max&auto=format&n=YUHnSq4JdekVofRY&q=85&s=189aff574aa25f6cc33a2aada719e7ee 280w, https://mintcdn.com/polymarket-292d1b1b/YUHnSq4JdekVofRY/polymarket-learn/markets/additional-context.png?w=560&fit=max&auto=format&n=YUHnSq4JdekVofRY&q=85&s=cc34b7c65289a0481c23d4f082410684 560w, https://mintcdn.com/polymarket-292d1b1b/YUHnSq4JdekVofRY/polymarket-learn/markets/additional-context.png?w=840&fit=max&auto=format&n=YUHnSq4JdekVofRY&q=85&s=251fd8aff678b616583d1997ce2bcfcf 840w, https://mintcdn.com/polymarket-292d1b1b/YUHnSq4JdekVofRY/polymarket-learn/markets/additional-context.png?w=1100&fit=max&auto=format&n=YUHnSq4JdekVofRY&q=85&s=1b11238c8c08383cae76cee0b2747f73 1100w, https://mintcdn.com/polymarket-292d1b1b/YUHnSq4JdekVofRY/polymarket-learn/markets/additional-context.png?w=1650&fit=max&auto=format&n=YUHnSq4JdekVofRY&q=85&s=358861be6c10816b76e5dd56e3c446d1 1650w, https://mintcdn.com/polymarket-292d1b1b/YUHnSq4JdekVofRY/polymarket-learn/markets/additional-context.png?w=2500&fit=max&auto=format&n=YUHnSq4JdekVofRY&q=85&s=1b556681e45977ceefadecd562a61360 2500w" />
|
||||
</Frame>
|
||||
@@ -0,0 +1,48 @@
|
||||
> ## Documentation Index
|
||||
> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt
|
||||
> Use this file to discover all available pages before exploring further.
|
||||
|
||||
# How Are Markets Created?
|
||||
|
||||
> Markets are created by the markets team with input from users and the community.
|
||||
|
||||
## Can I create my own market?
|
||||
|
||||
While users cannot directly create their own markets, they are encouraged to suggest ideas for new markets.
|
||||
|
||||
<Steps>
|
||||
<Steps.Step>
|
||||
Is there enough demand for trading in the market to produce an accurate probability? Polymarket targets \$X in trading volume as a minimum.
|
||||
</Steps.Step>
|
||||
|
||||
<Steps.Step>
|
||||
Is there social good or news value in understanding the probability generated by the market?
|
||||
</Steps.Step>
|
||||
|
||||
<Steps.Step>
|
||||
Can the market be resolved clearly?
|
||||
</Steps.Step>
|
||||
|
||||
<Steps.Step>
|
||||
Is there a credible information source for market resolution?
|
||||
|
||||
*For example, a country’s elections commission can be specified as the official resolution source for an election.*
|
||||
</Steps.Step>
|
||||
|
||||
<Steps.Step>
|
||||
Can the market be resolved in a definitive time frame?
|
||||
</Steps.Step>
|
||||
</Steps>
|
||||
|
||||
### Submit your market proposal
|
||||
|
||||
To give your proposal the best chance of being listed, include as much information as possible, such as:
|
||||
|
||||
* What is the market title?
|
||||
* What is the [resolution source](../markets/how-are-markets-resolved)?
|
||||
* Evidence of demand for trading that market
|
||||
|
||||
The best ways to propose a new market are:
|
||||
|
||||
* On [Discord](https://discord.com/invite/polymarket) in the **#market-suggestion** channel
|
||||
* On Twitter / X by tagging [@polymarket](https://twitter.com/intent/tweet?text=I+have+an+idea+for+a+new+market+@polymarket)
|
||||
@@ -0,0 +1,53 @@
|
||||
> ## Documentation Index
|
||||
> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt
|
||||
> Use this file to discover all available pages before exploring further.
|
||||
|
||||
# How Are Prediction Markets Resolved?
|
||||
|
||||
> Markets are resolved by the UMA Optimistic Oracle, a smart-contract based optimistic oracle.
|
||||
|
||||
## Overview
|
||||
|
||||
* When the result of a market becomes clear, the market can be “resolved,” or permanently finalized.
|
||||
|
||||
* Markets are resolved according to the market's pre-defined rules, which can be found under market's the order book.
|
||||
|
||||
* When a market is resolved, holders of winning shares receive \$1 per share, losing shares become worthless, and trading of shares is no longer possible.
|
||||
|
||||
* To resolve a market, an outcome must first be “proposed,” which involves putting up a bond in USDC.e which will be forfeited if the proposal is unsuccessful.
|
||||
|
||||
* If the proposal is validated as accurate, the proposer will receive a reward for your proposal.
|
||||
|
||||
<Warning>
|
||||
If you propose a market too early, or are unsuccessful in your proposal, you will lose all of your \$750 bond. Do not propose a resolution unless you understand the process and are confident in your view.
|
||||
</Warning>
|
||||
|
||||
### To propose a market resolution
|
||||
|
||||
<Steps>
|
||||
<Steps.Step>
|
||||
Navigate to the market you want to propose and click Resolution > Propose Resolution.
|
||||
|
||||
<Note>You will be taken to the corresponding UMA oracle page for the market, which shows the bond required and reward for successful proposal.</Note>
|
||||
</Steps.Step>
|
||||
|
||||
<Steps.Step>
|
||||
Ensure that you have enough USDC.e in your wallet on Polygon to supply the bond (usually \$750)
|
||||
</Steps.Step>
|
||||
|
||||
<Steps.Step>
|
||||
Select the outcome you would like to propose from the drop-down menu.
|
||||
</Steps.Step>
|
||||
|
||||
<Steps.Step>
|
||||
Connect your wallet and submit the transaction. It will now enter the UMA Oracle’s verification queue.
|
||||
</Steps.Step>
|
||||
</Steps>
|
||||
|
||||
Once in the verification process, UMA will review the transaction to ensure it was proposed correctly. If approved, you will receive your bond amount back in your wallet plus the reward. If not approved, it will enter Uma’s dispute resolution process, which is described in detail here.
|
||||
|
||||
### To dispute a proposed resolution
|
||||
|
||||
Once a market is proposed for resolution it goes into a challenge period of 2 hours.
|
||||
|
||||
If you do not agree with a proposed resolution, you can [dispute the outcome](../markets/dispute).
|
||||
Reference in New Issue
Block a user