Automatic redemption

AGARA automatically redeems positions in supported resolved markets. You do not submit a transaction, sign a message, spend gas, or call a redemption endpoint.

Current support covers standalone binary AGARA markets. Neg-risk events are composed of binary member markets, but those member markets are not yet included in this flow.

What happens after resolution

When a supported market resolves:

1. Resting orders are cancelled with the MARKET_RESOLVED reason.
2. AGARA waits for earlier fills and position operations to finish settling.
3. A positive payout produces a REDEEM portfolio activity with the winning token, shares, collateral amount, settlement transaction, and creation time. A position holding only losing shares can clear with no activity row.
4. Winning shares convert to collateral at one unit per share. Losing shares pay zero, and both outcome balances clear.
5. The private account stream sends a tokens_redeemed event for that account change.

Processing starts after resolution is confirmed, but it has no fixed completion time. Outstanding settlement or an in-flight account batch can delay it. For a positive payout, the portfolio activity is the durable redemption record. tokens_redeemed reports the later account change on the live stream.

Reconcile your market-making state

Treat resolution as an asynchronous account change:

1. Watch market_resolved on the market_status stream.
2. Process order_cancelled events carrying MARKET_RESOLVED on the account stream.
3. On tokens_redeemed for the resolved condition_id, refetch POST /trade/v1/portfolio/positions/list and GET /trade/v1/portfolio/summary.
4. For a positive payout, read GET /trade/v1/portfolio/activities until the REDEEM row appears. A zero-payout clearance has no required activity row.
5. Use the cleared position state and updated cash_balance_micro before sizing new orders.

The account stream is live-only. If you reconnect, receive sequence_reset, or do not receive the redemption event, poll until the position rows clear. For a positive payout, also wait for the REDEEM activity.

A redemption activity has this shape:

{
  "type": "REDEEM",
  "exchange": "AGARA",
  "id": "redeem:<uuid>",
  "condition_id": "0x...",
  "token_id": "<winning-token-id>",
  "shares_micro": "1000000",
  "amount_micro": "1000000",
  "tx_hash": "0x...",
  "created_at": "2026-07-20T12:00:00.000Z"
}

Frozen accounts and missing payouts

If your account is frozen when on-chain redemption completes, AGARA holds the collateral credit until the account is unfrozen. The balance updates and tokens_redeemed is sent after the freeze is removed.

For a supported standalone binary market, contact support if its position remains after resolution and your earlier fills and account batches have finished. Include the condition_id and your deposit-wallet address.

See Positions for split and merge operations, and Inventory for quoting with binary outcome tokens.