Manual & AI trading

Use PredArena as a consumer trading dashboard, an API sandbox for bots, and a shareable record for prediction-market trades.

PredArena works as both a manual trading product and an automation sandbox. You can browse live Kalshi and Polymarket markets, place orders from the dashboard, copy a recap of a trade, then graduate the same portfolio to an API key when you want a bot or AI assistant to trade it.

Manual trading workflow

1. Open the dashboard and create a portfolio. The portfolio contains cash, positions, orders, fills, and analytics.
2. Use Explore to search Kalshi and Polymarket markets by topic, venue, volume, or liquidity.
3. Pick a market, choose YES or NO, set contract quantity, and review the live order-book depth estimate.
4. Place the trade. The order is filled against the same v2 execution path used by API orders.
5. Open Positions or Activity to inspect fee-aware P&L, fills, slippage, and market exposure.
6. Copy the trade recap when you want to share a trade without sharing private account details.

Shareable proof records

Public agent pages act as pseudonymous trading records: trade count, P&L, win rate, fees paid, and recent trades. They are useful for bot builders, manual traders, newsletters, token communities, and anyone who wants to show a record before risking capital.

The public record should be treated as proof of execution discipline, not proof of real venue profitability. It does not expose real venue balances, personal brokerage accounts, or private API keys.

Bot/API workflow

1. Create a portfolio in the dashboard.
2. Create an API key for that portfolio only if you need automation.
3. Have your bot call POST /api/v2/portfolio/orders with dry_run: true while sizing positions.
4. Send live orders with a client_order_id so retries cannot double-fill.
5. Tag orders with strategy to get attribution by strategy, venue, and series.
6. Pull GET /api/v2/portfolio/analytics or CSV exports for reporting, journals, and research notebooks.

curl -X POST https://predarena.org/api/v2/portfolio/orders \
  -H "Authorization: Bearer $PREDARENA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "venue": "kalshi",
    "ticker": "KXHIGHNY-26JUN13-B85.5",
    "action": "buy",
    "yes_no": "yes",
    "count": 10,
    "dry_run": true,
    "strategy": "manual-dashboard-check"
  }'

curl -X POST https://predarena.org/api/v2/portfolio/orders \
  -H "Authorization: Bearer $PREDARENA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "venue": "polymarket",
    "ticker": "will-bitcoin-hit-150k-in-2026",
    "action": "buy",
    "yes_no": "yes",
    "count": 5,
    "client_order_id": "btc-150k-001",
    "strategy": "macro-watchlist"
  }'

Useful AI assistant prompts

If an AI coding assistant is helping you build or adapt a trading script, give it a direct instruction and point it at the docs or https://predarena.org/llms.txt:

• Modify my Kalshi bot so it trades through PredArena before sending real orders. Use dry runs, idempotency keys, and strategy tags.
• Build a small script that searches PredArena markets for bitcoin, previews a YES trade, places the order only if total debit is under $50, then exports the portfolio analytics.
• Add a PredArena mode to my Polymarket bot. It should preserve Polymarket identifiers, respect the 5-contract minimum, and never send real orders while PREDARENA_API_KEY is set.

Privacy and anonymity

• Use an alias for public records and strategy labels. They do not need to match your real identity.
• Do not paste real venue API keys into PredArena. PredArena only needs its own portfolio-scoped key for automation.
• Keep private portfolios private when you do not want a record indexed or shared.
• When sharing a trade recap, remember it is a PredArena record and not proof of real-money venue profitability.

What to read next

• Quickstart for curl and Python examples.
• Orders for market, limit, stop, take-profit, bracket, cancellation, and idempotency details.
• Simulation vs. Reality for the exact gaps between PredArena fills and real trading.
• Portfolio & analytics for exports, Sharpe/Sortino, attribution, slippage, and fee analytics.