Documentation

Velorea Docs

Everything you need to set up automations for your Polymarket positions. No code required. Takes about 3 minutes.

What is Velorea?

Velorea is an automation layer built on top of Polymarket. It watches your prediction market positions and executes sell orders when conditions you define are met.

Think of it as a set of IF/THEN rules for your portfolio. You set a condition — like "if probability drops below 30%" — and an action — like "sell everything." Velorea monitors the market around the clock and acts the moment your condition triggers.

The goal is simple: protect your capital and lock your profits without staring at screens all day.

Getting Started

Setup takes about 3 minutes. Here's the process:

1

Connect your wallet

Click "Connect Wallet" on the homepage. We use Privy for authentication — you can connect with MetaMask, Coinbase Wallet, WalletConnect, or email.

2

Complete Polymarket onboarding

On first login, you'll see an onboarding flow that links your Polymarket trading account. This generates the API credentials Velorea needs to place orders on your behalf. Your private keys never leave your wallet.

3

Import positions

Once connected, your open Polymarket positions sync automatically. You'll see them in the Positions tab.

4

Create your first automation

Go to Automations → New. Pick a template (Stop Loss, Take Profit, or Event Exit), select a position, set your threshold, and activate. Done.

Note

You only need to complete onboarding once. After that, connecting your wallet logs you straight into the dashboard.

Automation Types

Velorea ships with three core automation templates. Each one is designed for a specific situation.

Stop Loss

Velorea Protect

When

Probability drops below X%

Then

Sell 100% of position

Example

You hold YES on "Will BTC hit $80K by July?" at 55¢. You set a stop loss at 30%. If the market drops to 30¢, Velorea sells your entire position to limit further losses.

Take Profit

Velorea Exit

When

Probability rises above X%

Then

Sell 25% / 50% / 75% / 100% of position

Example

You bought YES at 40¢. You set a take profit at 75%. When the market hits 75¢, Velorea locks in your profit by selling. You can also sell partial amounts — e.g. sell 50% at 70¢ and let the rest ride.

Event Exit

Velorea Guard

When

Less than X minutes before market resolution

Then

Sell 100% of position

Example

A market resolves at 8pm tonight. You set an event exit for 60 minutes before. At 7pm, Velorea sells your position regardless of price — useful for avoiding resolution risk.

Creating Automations

The automation builder walks you through 5 steps. Here's what each one does:

1

Choose template

Pick Stop Loss, Take Profit, or Event Exit. This sets the condition type and default values.

2

Select position

Choose which of your open positions the automation applies to. Or skip this to apply it to a market directly.

3

Set condition

Use the slider or type a number. For Stop Loss: the probability threshold below which you want to exit. For Take Profit: the probability above which you want to sell. For Event Exit: how many minutes before the event to trigger.

4

Set action

Choose what percentage of your position to sell. For Stop Loss and Event Exit, it's always 100%. For Take Profit, you can sell any amount from 1% to 100%.

5

Review & activate

Give your automation a name, review the IF/THEN summary, and click Activate. It starts monitoring immediately.

Tip

You can create multiple automations on the same position. For example: a stop loss at 25% AND a take profit at 80%. Whichever triggers first executes.

How Execution Works

Once active, your automation is monitored by background workers running every 60 seconds. Here's the flow:

  1. 1.Check conditions— The worker reads the current market probability from Polymarket's CLOB and compares it to your threshold.
  2. 2.Trigger— If the condition is met, the automation status changes to "triggered" and execution begins.
  3. 3.Submit order — Velorea submits a sell order to the Polymarket orderbook using your API credentials. The order is placed at the current best price.
  4. 4.Confirm & notify — Once submitted, your automation is marked as completed (or stays active for partial sells). You get an in-app notification and email.

Technical Details

  • Market data polled every 60 seconds via Trigger.dev background jobs
  • Orders submitted to Polymarket CLOB as market orders at best available price
  • Builder attribution automatically attached to every order
  • Idempotent execution — same automation never executes twice
  • Failed orders are retried once, then marked as failed with notification

Monitoring & Activity

You can track everything from the dashboard:

Dashboard

Live metrics: portfolio value, active automations, executions today, and capital under protection.

Automations tab

View all automations with their current status (active, paused, triggered, completed, failed). Pause or delete any time.

Activity feed

Full log of every event — condition checks, triggers, successful executions, and failures.

Positions

All your synced Polymarket positions with real-time prices and PnL calculations.

Note

Automations can be paused or deleted at any time from the Automations tab. Paused automations stop monitoring immediately. Deleting is permanent.

Security & Custody

Velorea is non-custodial. Here's what that means in practice:

Your private keys stay in your wallet

We never ask for or store your wallet private key. Authentication happens through Privy, which acts as a secure middleware.

API credentials are scoped to trading only

The CLOB credentials generated during onboarding can only place orders on Polymarket. They cannot withdraw funds, transfer tokens, or access your wallet.

You control everything

Pause or delete any automation instantly. Revoke access by disconnecting your wallet from Settings.

Orders are transparent

Every order includes builder attribution and is visible on-chain. You can verify any execution in your Polymarket trade history.

Warning

Velorea places sell orders at market price. In thin markets, you may experience slippage. Always factor in liquidity when setting thresholds on low-volume markets.

FAQ

What happens if the market moves past my threshold between checks?

Since we check every 60 seconds, it's possible the price moves beyond your threshold before we catch it. In that case, the automation still triggers and sells at the current market price, which may be slightly worse than your target.

Can I set a stop loss AND a take profit on the same position?

Yes. Create two separate automations on the same position. Whichever condition triggers first will execute. The other automation stays active unless the position is fully sold.

What if my automation fails?

You'll get a notification immediately (in-app and email). Common reasons: low liquidity, stale credentials, or the position was already closed. Failed automations can be retried from the Automations tab.

Is there a limit on how many automations I can run?

No hard limit during the current phase. Run as many as you need.

Can I edit an automation after creating it?

Not currently. Delete the existing one and create a new one with updated values. This takes about 30 seconds.

What's the minimum position size?

Any position that can be sold on Polymarket's orderbook. In practice, positions under $1 in value may not execute cleanly due to minimum order sizes.

Do I pay fees?

Velorea is free to use during the current phase. Standard Polymarket trading fees apply to executed orders as usual.

How do I disconnect?

Go to Settings in the app and click Disconnect Wallet. This deactivates all your automations and removes your API credentials from our system.

Ready to automate?

Launch App