Skip to main content

​
What are Polymarket tasks?

Polymarket tasks reward prediction market activity, read from the Ethereum wallet the user signed in to Claimr with. Users don’t need to share an API key. Polymarket trades from a separate wallet that the user’s own address controls. Claimr finds it automatically: it asks Polymarket’s public profile for it, and also works out each wallet type Polymarket creates for that address. Only the user’s own wallets are ever counted. There are 5 Polymarket task types:
  • Polymarket Trading Volume: USDC the user traded on Polymarket over the window.
  • Polymarket Trades Count: How many trades the user made on Polymarket.
  • Polymarket Markets Traded: How many different markets the user has traded, over their whole history.
  • Polymarket Portfolio Value: The current value of the user’s open positions.
  • Polymarket Hold Position: The user holds a position in your market right now, worth at least the set amount at the current price. Use it for “take a side on our market” quests.
Polymarket’s data API returns at most 5,500 trades per query. For very active traders, set a time window so the count stays accurate.

​
Trading volume

  1. Go to your quest and click + Create new task.
  2. Under the Category section, select Onchain Actions.
  3. In the Groups list, choose Polymarket.
  4. Select Polymarket Trading Volume from the list of task types.
  5. Click Continue to proceed to task settings.
USDC the user traded on Polymarket over the window.
  • Completion points: Set the number of points awarded when the user completes the task.
  • Points multiplier (%): Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
  • Volume, USDC: The volume the user must reach.
  • Markets (optional): Comma separated market condition IDs. Empty counts every market.
  • Time, h, Start at and End at (optional): Count only activity in this window. With none set, all available history counts.
  • Trading link (optional): A link shown under the progress bar, for example to your market.
  • Claim Button Text, Refresh Button Text and Hide progress? (optional): Customize the task card.
  • Is progressive reward?, Is continous and Max progressive value (optional): Scale the reward with how many times the user reaches the target, up to the cap.

​
Trades count

  1. Go to your quest and click + Create new task.
  2. Under the Category section, select Onchain Actions.
  3. In the Groups list, choose Polymarket.
  4. Select Polymarket Trades Count from the list of task types.
  5. Click Continue to proceed to task settings.
How many trades the user made on Polymarket.
  • Completion points: Set the number of points awarded when the user completes the task.
  • Points multiplier (%): Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
  • Count: How many trades are needed.
  • Min trade, USDC (optional): Trades smaller than this don’t count.
  • Markets (optional): Comma separated market condition IDs.
  • Time, h, Start at and End at (optional): Count only activity in this window. With none set, all available history counts.
  • Trading link (optional): A link shown under the progress bar, for example to your market.
  • Claim Button Text, Refresh Button Text and Hide progress? (optional): Customize the task card.
  • Is progressive reward?, Is continous and Max progressive value (optional): Scale the reward with how many times the user reaches the target, up to the cap.

​
Markets traded

  1. Go to your quest and click + Create new task.
  2. Under the Category section, select Onchain Actions.
  3. In the Groups list, choose Polymarket.
  4. Select Polymarket Markets Traded from the list of task types.
  5. Click Continue to proceed to task settings.
How many different markets the user has traded, over their whole history.
  • Completion points: Set the number of points awarded when the user completes the task.
  • Points multiplier (%): Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
  • Count: How many markets are needed.
  • Trading link (optional): A link shown under the progress bar, for example to your market.
  • Claim Button Text, Refresh Button Text and Hide progress? (optional): Customize the task card.

​
Portfolio value

  1. Go to your quest and click + Create new task.
  2. Under the Category section, select Onchain Actions.
  3. In the Groups list, choose Polymarket.
  4. Select Polymarket Portfolio Value from the list of task types.
  5. Click Continue to proceed to task settings.
The current value of the user’s open positions.
  • Completion points: Set the number of points awarded when the user completes the task.
  • Points multiplier (%): Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
  • Amount, USDC: The portfolio value to reach.
  • Trading link (optional): A link shown under the progress bar, for example to your market.
  • Claim Button Text, Refresh Button Text and Hide progress? (optional): Customize the task card.

​
Hold position

  1. Go to your quest and click + Create new task.
  2. Under the Category section, select Onchain Actions.
  3. In the Groups list, choose Polymarket.
  4. Select Polymarket Hold Position from the list of task types.
  5. Click Continue to proceed to task settings.
The user holds a position in your market right now, worth at least the set amount at the current price. Use it for “take a side on our market” quests.
  • Completion points: Set the number of points awarded when the user completes the task.
  • Points multiplier (%): Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
  • Markets: Comma separated market condition IDs.
  • Outcome (optional): The outcome the position must be on, for example Yes. Empty for any outcome.
  • Amount, USDC: The position value to reach.
  • Trading link (optional): A link shown under the progress bar, for example to your market.
  • Claim Button Text, Refresh Button Text and Hide progress? (optional): Customize the task card.