Walkthrough Examples

Step-by-step scenarios for common workflows

Reviewing and Approving an Opportunity Manually

Scenario: You've run the pipeline and want to manually review and enter a trade.

Open Discovery — Navigate to the Discovery page. You'll see a table of pipeline-discovered hedging pairs.
Filter by tier — Click "Tier 1" to see only the highest-confidence pairs (≥95% coverage).
Review a pair — Look at the Target Bet and Backup Bet columns. Check that the LLM Conf. is high, the Return is positive, and the Cost fits your budget.
Create a trade intent — Click "Create" on the pair you like. Enter $5 as the amount per side in the dialog. This creates two trade intents (target + cover) in "pending" status.
Approve the intents — The status changes to "pending". Click "Approve" to move them to "approved". The execution engine will now pick them up.
Watch execution — Go to the Orders page. You'll see new orders appear as "open" (or "SIM" in simulation mode). Watch as fills come in and the status moves to "partial" then "filled".
Check your position — Go to Positions. The new position appears as "pending" while unwanted tokens are being sold, then "active" once the position is established.

Tip

In simulation mode, fills happen instantly. In live mode, fills depend on CLOB liquidity and may take time.

Scenario: You want to let AntFlow discover and evaluate opportunities but approve each trade manually.

Configure automation — Go to Automation. Set: Enabled = true, Auto Execute = false, Require Approval = true, Min Edge = 300 bps, Min Net Edge = 500 bps, Max Size = $5, Block Fee Markets = true. Save.
Populate opportunities — Trigger a run from the top-bar "Pipeline" dropdown (or wait for the scheduled pipeline to complete). Opportunities appear on the Discovery page once the run finishes.
Scan now — On the Automation page, click "Scan Now". The system evaluates current opportunities against your config, creates intents for qualifying ones, and ignores the rest.
Review pending intents — Go to Discovery and review the pairs that now have pending intents attached.
Approve good ones — Click "Approve" on intents you want to execute. Reject the rest.
Monitor — Watch Orders for fills, Positions for new holdings, P&L for performance.

Scenario: Following a position from creation to completion.

Entry begins — After approving an intent, the execution engine places CLOB orders. The position appears on the Positions page as "pending" with an ⏳ icon.
Unwanted tokens sell — The system splits USDC into YES+NO tokens and sells the side you don't want. This happens automatically.
Position active — Once sells complete, the status changes to "active" with a ✓ icon. You now hold the desired tokens.
Monitor P&L — Go to P&L → Positions tab to see unrealized P&L updating in real-time as prices move.
Exit triggers — If you have exit rules configured (take-profit at 500 bps, for example), the exit worker monitors your position. When the trigger fires, it creates sell intents automatically.
Position completes — After sells execute, the position moves to "complete" with a — icon. Realized P&L appears on the P&L page.

Tip

You can manually exit at any time from the position's action dropdown, even if auto-exit is enabled.

Scenario: Something looks wrong and you want to stop trading and exit a specific position.

Pause — In the OperatorBar, click "Pause". The engine stops placing new orders. The status changes to "PAUSED" (amber).
Review the situation — Check Logs → Risk Events for recent rejections. Check Orders for any stale orders. Check Positions for positions that need attention.
Cancel stale orders — On the Orders page, cancel any orders you don't want. Or go to Logs → Stale Orders for a filtered view.
Exit a position — On the Positions page, find the position and click "Exit". Confirm the action. This creates sell intents.
Resume to execute exits — Click "Resume". Since you paused manually, a simple confirmation is enough. The engine processes the exit sell intents.
Verify — Check Positions to confirm the position moved to "complete". Check P&L to see realized results.

Scenario: You approved an intent but it got risk-rejected instead of executing.

Check the opportunity — Go to Discovery and find the pair. Its status shows "risk_rejected" in red.
Check risk logs — Go to Logs → Risk Events. Find the entry for this intent. The "Check" column shows which risk check failed, and "Reason" explains why.

Common rejection reasons:

Check	Example Reason	What to Do
`market_exposure`	Would exceed $25 market limit	Reduce existing positions in this market or increase the limit in Settings
`total_exposure`	Would exceed $80 total limit	Your total portfolio exposure is at the cap — close positions or raise the limit
`min_edge`	Edge 85 bps below minimum 100 bps	The expected profit is too thin — wait for better pricing
`duplicate`	Active intent already targets same token	You already have a pending or executing intent for this position
`stale_orders`	Stale orders detected	Old unfilled orders are blocking new ones — cancel them first
`fee_enabled_market`	Fee-enabled market blocked	Market charges extra fees and your config blocks these

Fix and retry — Address the issue (reduce exposure, cancel stale orders, adjust limits) and create a new intent.