Prediction Markets

Trade binary outcome markets on Polymarket through the Suwappu API. Browse events, check live prices, and place orders.

How It Works

Prediction markets let you buy shares in outcomes. Each outcome trades between $0 and $1:

  • $0.42 means the market gives a 42% probability
  • If the outcome resolves Yes, shares pay out $1
  • If the outcome resolves No, shares pay out $0

Step 1: Browse Markets

Search for active markets by keyword or category:

-kw">curl -str">"https://api.suwappu.bot/v1/agent/predict/markets?category=crypto&limit=5" \

  -H -str">"Authorization: Bearer suwappu_sk_YOUR_KEY"

Or browse prediction events:

-kw">curl -str">"https://api.suwappu.bot/v1/agent/predict/events?query=bitcoin" \

  -H -str">"Authorization: Bearer suwappu_sk_YOUR_KEY"

Step 2: Check Prices

Get the current midpoint price for a specific market:

-kw">curl https://api.suwappu.bot/v1/agent/predict/market/0x1234abcd/price \

  -H -str">"Authorization: Bearer suwappu_sk_YOUR_KEY"

View the full order book:

-kw">curl https://api.suwappu.bot/v1/agent/predict/market/0x1234abcd/book \

  -H -str">"Authorization: Bearer suwappu_sk_YOUR_KEY"

Step 3: Place an Order

Buy shares in an outcome at a specific price:

-kw">curl -X POST https://api.suwappu.bot/v1/agent/predict/order \

  -H -str">"Authorization: Bearer suwappu_sk_YOUR_KEY" \


  -H -str">"Content-Type: application/json" \


  -d -str">'{


    -str">"tokenId": -str">"71321044878958750425...",


    -str">"price": 0.42,


    -str">"size": 100,


    -str">"side": -str">"BUY"


  }'

The tokenId identifies which outcome token you're trading. Get it from the market detail endpoint.

Step 4: Manage Positions

Check your open positions:

-kw">curl https://api.suwappu.bot/v1/agent/predict/positions \

  -H -str">"Authorization: Bearer suwappu_sk_YOUR_KEY"

List your orders:

-kw">curl https://api.suwappu.bot/v1/agent/predict/orders \

  -H -str">"Authorization: Bearer suwappu_sk_YOUR_KEY"

Cancel an open order:

-kw">curl -X DELETE https://api.suwappu.bot/v1/agent/predict/order/ord_abc123 \

  -H -str">"Authorization: Bearer suwappu_sk_YOUR_KEY"

MCP Tool

If you're using Claude or another MCP client, two tools are available:

  • predict_markets — search and browse markets
  • predict_market_detail — get detailed info with live CLOB prices

Telegram Bot

Use the Telegram bot's prediction market interface for interactive market browsing, price checking, and order placement.