Automations

Automations are what happens when a Filter matches a trade. The filter says “this trade is interesting”; the automation decides what you want done about it: be told via email, simulate the trade on paper, or execute it on-chain with real capital.

Choosing an automation type

The first three types form a natural progression. You’ll often want all three running on the same filter at different stages. Discretionary Trading (user-controlled) is a separate mode for placing trades directly.

A common pattern: email + paper trade on the same filter. The emails surface candidate trades for human review while the paper automation keeps an honest scoreboard.

Creating an Automation

1. Go to the Automations tab
2. Click the + button
3. Step 1: Choose automation type
4. Step 2: Fill in the form (see details below for each type)
5. Click Create

Every automation (except Discretionary Trading) requires:

• Automation Name: a descriptive label (e.g., “Whale Trades Alert”)
• Filter: which trades trigger this automation. Cannot be changed after creation. Create a new automation to use a different filter.
• Active on creation: whether the automation starts processing immediately or stays inactive until you enable it

Email Alert

Sends you an email when a matching trade occurs.

Fields

Throttle Limits

Once the limit is reached, additional matching trades are silently skipped until the window resets. The automation list shows your current throttle usage (e.g., “3/6 sent today”).

Paper Copy Trade

Simulates copying trades that match your filter. Tracks full PnL and position accounting without risking real capital. Use this to validate a strategy before going live with real copy trading.

Capital Settings

Example: With $10,000 starting capital and 5% position size, each new trade allocates $500. If the position grows via scale-ups, it can’t exceed 25% of total capital ($2,500).

Exit Behavior

Controls when and how positions are closed.

Scale-up

Position Limits

Controls how the system handles multiple signals and conflicting trades.

Key rule: Opposing positions from different traders are blocked unless Follow other trader hedges is ON. By default, if Trader A buys Yes and Trader B then buys No on the same market, B’s trade is skipped: contradicting signals cost spread on both sides with no edge.

Behavior Preview

The form shows a live preview based on your current scale-up + hedge settings:

Follow         : Trader A buys Yes → you open a Yes position
Scale up/Skip  : Trader A buys Yes again (depends on Scale-up enabled)
Scale up/Skip  : Trader B also buys Yes (depends on Scale-up enabled)
Follow/Skip    : Trader D buys Yes on another market in the same event (depends on Single entry per event)
Follow/Skip    : Trader A buys No (depends on Follow same trader hedges)
Follow/Skip    : Trader C buys No (depends on Follow other trader hedges)

Real Copy Trade

Executes actual on-chain trades on Polymarket using your own wallet and real capital. Same core configuration as Paper Copy Trade (capital, exits, entry rules), with a few additional settings specific to on-chain execution.

Requirements:

• A Polygon EOA wallet with its private key, funded with USDC (trading capital) and POL (gas).

For the full setup walkthrough, see Real Copy Trading Setup.

Wallet credentials

Additional settings

All trades execute as Fill-And-Kill market orders. Your order fills immediately at available prices; any unfilled portion is canceled.

Tracking

The Real Copy Trade automation detail page records transaction hashes linked to Polygonscan, on-chain confirmation status, actual fill prices (may differ from the copied trader’s entry due to slippage), and reconciliation events from the position-manager.

Discretionary Trading

Execute individual trades on Polymarket markets directly through Airavat, rather than auto-copying from a filter. Discretionary Trading is a standalone automation type: it is not attached to a filter, and only one Discretionary Trading automation can exist per user.

Requirements:

• A Polygon EOA wallet with its private key, funded with USDC (trading capital) and POL (gas).

Setup

1. Go to the Automations tab and click the + button
2. Select Discretionary Trading
3. Enter an automation name (defaults to “Discretionary Trading”)
4. Enter wallet credentials:
   • Private Key: 64 hex chars with or without 0x prefix. Encrypted at rest (AES-256-GCM). Locked after creation.
   • Funder Address: optional Polymarket proxy wallet address for MetaMask users. Locked after creation.
5. Click Create

The wallet must be the same one you use on Polymarket, and it must be dedicated exclusively to Airavat discretionary trading. Do not trade directly on Polymarket with the same wallet while a Discretionary Trading automation is active.

If the signer wallet has low POL, a gas balance warning appears during setup.

Placing trades

Once configured, navigate to any market detail page. The trading interface shows:

• Current outcome prices (YES/NO)
• Your open positions for that market (if any)
• BUY and SELL controls with amount input (in dollars or shares)

All trades execute as Fill-And-Kill market orders: your order fills immediately at available prices; any unfilled portion is canceled.

After placing a trade, the position appears in your Discretionary Trading automation’s detail page. Sells on open positions submit a FAK sell order; the position shows as Pending until on-chain settlement (typically within seconds).

Tracking

The Discretionary Trading automation detail page tracks all positions and realized PnL, similar to a Real Copy Trade automation but without filter-driven automation.

Automation Detail Page

Click any automation row to see the full detail view. The tabs differ by automation type.

Discretionary Trading Automations

The Discretionary Trading detail page shows the same structure as Copy Trade automations (Performance, Open Positions, Closed Positions, Trade Activity, Analytics, Audit Log, Settings), but without filter-related configuration since Discretionary Trading is not attached to a filter.

Email Automations

Tabs: Email Activity, Audit Log, Settings.

• Email Activity: Send history with timestamp, recipient, status (sent / throttled / failed), and current throttle usage.
• Audit Log: Configuration change history with timestamp, operation, and before / after diffs.
• Settings: Edit the automation’s configuration (the filter stays locked).

Copy Trade Automations (Paper and Real)

Seven tabs, with Performance as the default landing tab:

Performance, Open Positions, Closed Positions, Trade Activity, Analytics, Audit Log, Settings.

• Performance: Default tab. Five summary cards on top, equity curve below. See Performance tab.
• Open Positions: Live positions with the followed trader(s), market, outcome, entry price, current price, $ size, unrealized PnL, opened-at and resolves-at timestamps, and any anomaly or pending-state badge on the row. Sortable, paginated at 20 per page. Each open position row has a Close button to manually exit. A Close All button at the top of the tab closes every open position sequentially (confirmation required). For Paper, closes are immediate at current price. For Real Copy Trade and Discretionary Trading, closing submits a Fill-And-Kill sell order per position; each position shows a Pending badge until on-chain settlement (typically within seconds). See Troubleshooting: Manual position close for edge cases. Real Copy Trade positions can also show a Pending badge while a buy or scale-up order settles on-chain (see Pending positions).
• Closed Positions: Fully exited positions with the followed trader(s), market, outcome, status, size, exit price, realized PnL, and closed-at timestamp. Each row also surfaces the exit type as an inline label: Sell, Sell Auto, Manual, Resolution, or Reconciliation. Sortable, paginated.
• Trade Activity: Every event the automation has executed. See Trade Activity tab.
• Analytics: Aggregated performance metrics. See Analytics tab.
• Audit Log: Configuration change history with before / after diffs. Includes toggle events (enable / disable), config edits, and creation.
• Settings: Edit the automation’s configuration. The filter and (for Real Copy Trade) wallet credentials stay locked. For Real Copy Trade automations, this tab also surfaces the signer wallet’s POL balance with a Low Gas Balance warning when the balance is below the threshold needed for the next trade.

Performance tab

The default tab on every Paper and Real Copy Trade automation. Two sections: a row of summary cards and an equity curve below.

Summary cards (5):

Equity curve: A three-pane chart titled “Equity w/ Realized PnL, Realized Drawdown, Open positions”. The panes share an x-axis (the automation’s lifetime).

The chart is downsampled for smooth rendering on long-running automations. The downsample count is shown in the top-right of the card.

Pending positions (Real Copy Trade)

When a Real Copy Trade buy or scale-up is in flight on-chain, the position appears in the Open Positions table with:

• The row dimmed (muted background and foreground)
• A blue Pending badge in the PnL column. For scale-ups with a known size, the badge shows Pending +$NNN indicating the additional size in flight.
• The close button replaced with a disabled Pending button. Hover tooltip: “The buy is still settling on-chain. You can close it once it lands (usually within seconds).”

If the on-chain order cancels with zero fill (typically because the market price moved past your slippage limit before the order arrived), the row silently disappears (for fresh buys) or reverts to the pre-scale-up size (for scale-ups). No manual intervention is needed.

A separate Awaiting Redemption badge (amber) surfaces resolved positions that need POL gas to be redeemed on-chain. Fund the signer with POL and they redeem automatically.

Trade Activity tab

Every event the automation has produced: buys, scale-ups, partial sells, full closes, auto-sells, resolutions, reconciliations, redemption failures, and CLOB-level failed attempts. Columns: timestamp, event type, trader, side, price, shares, amount, status, and (for Real Copy Trade) transaction hash linked to Polygonscan. Failed entries include the error message inline.

Filter dropdown at the top of the tab. Options:

Won / Lost badges appear next to the event type for settled rows where the outcome is known. They are intentionally not shown on Redemption Failed rows: the trade was settled but the funds have not yet been redeemed, so showing “Won” alongside a red “Redemption Failed” badge would be misleading.

Skipped events (filter-skip and zero-fill cancellations) are not written as individual rows in the activity log. They are aggregated server-side to keep the activity feed scannable. CLOB-level failures on buy / scale-up / sell events still appear as Skipped {event} rows with the failure reason in a tooltip.

Edited rows carry an orange “Edited” badge and a left border, indicating the configuration was changed after the event ran (e.g., follow-up edits to the automation’s settings).

Redemption failures specifically mean: the market resolved, the position was eligible to redeem on-chain for its full payout, and the on-chain redemption transaction failed after the retry budget. The most common cause is insufficient POL gas on the signer wallet. Resolution: top up POL on the signer, then redeem manually from the position’s row.

Analytics tab

Available on Paper and Real Copy Trade automations with at least one closed position. Computed by a batch job that refreshes every 30 minutes; the Processed timestamp at the top of the tab shows the last computation time.

Summary metrics (12 cards):

Performance Breakdown: a table that slices the same metrics by a dimension you pick from the dropdown.

All tables include Trades count, Total PnL, Avg PnL, Win Rate, and Avg Return. Every column is sortable. Switching the dimension resets paging and sort to defaults.

Edge cases:

• If the automation has no closed positions, the tab shows an empty state.
• If the batch job has not yet computed analytics for this automation (first run pending), the tab shows “Analytics not yet computed” and retries on each visit.
• Metrics with insufficient data (e.g. Kelly on 3 trades) display as a placeholder.

Managing Automations

• Enable/Disable: toggle on each automation row
• Edit: modify configuration. Filter cannot be changed.
• Delete: confirmation required

Tips

• Start with email alerts to validate your filter catches what you expect before risking capital
• Then add paper copy trade to the same filter to track simulated performance alongside the alerts
• One filter, multiple automations: a single filter can power any number of automations
• Throttle conservatively at first: high-volume filters can generate many matches