? What is EVENT TRADER?

EVENT TRADER is a prediction market platform where you can trade on which cryptocurrency or stock will perform best over a given time period. It provides a complete REST API for building trading bots, a Python SDK, and real-time WebSocket feeds.

1 Get Your API Key

All API requests require authentication. Generate a free API key to get started.

# Generate a free API key
curl -X POST "https://cymetica.com/api/v1/api-keys" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_JWT_TOKEN" \
     -d '{"name": "My First Bot", "permissions": {"read": true, "trade": true, "withdraw": false}}'

You'll receive a response like:

{
  "key": "evt_a1b2c3d4e5f6g7h8i9j0...",
  "name": "My First Bot",
  "tier": "standard",
  "rate_limit_per_minute": 100
}

2 Install the Python SDK

The easiest way to interact with EVENT TRADER is through our Python SDK.

pip install event-trader

Initialize the Client

from cymetica import EventTraderClient

# Initialize with your API key
client = EventTraderClient(
    base_url="https://cymetica.com",
    api_key="evt_a1b2c3d4e5f6..."  # Your API key
)

3 Explore Markets

Browse available prediction markets and find opportunities to trade.

# List all active markets
markets = await client.markets.list(status="active")

for market in markets:
    print(f"{market.name}")
    print(f"   Contract: {market.contract_address}")
    print(f"   Assets: {', '.join(market.assets)}")
    print(f"   Ends: {market.end_time}")
    print()

Get Market Details

# Get a specific market
market = await client.markets.get("0x1234...")

print(f"Market: {market.name}")
print(f"Assets: {market.assets}")
print(f"Total Pool: ${market.total_pool:,.2f}")

# Get current results/standings
results = await client.markets.results("0x1234...")
for asset in results.standings:
    print(f"  {asset.symbol}: {asset.price_change_pct:+.2f}%")

4 Place Your First Trade

You can place simple trades or use the order book for limit orders.

Simple Trade

# Trade $100 on Bitcoin winning
trade = await client.trading.place_trade(
    contract_address="0x1234...",
    user_id="my_user_id",
    asset="BTC",
    amount=100.0
)

print(f"Trade placed!")
print(f"   Trade ID: {trade.id}")
print(f"   Amount: ${trade.amount}")

Limit Order

# Place a buy limit order at 60% probability
order = await client.trading.place_order(
    contract_address="0x1234...",
    user_id="my_user_id",
    asset="BTC",
    side="buy",
    price=0.60,     # 60% implied probability
    quantity=500.0  # Number of contracts
)

print(f"Order placed: {order.id}")

5 Register Your Bot (Optional)

Register as a trading bot to earn rewards, climb tiers, and unlock fee discounts.

# Register your bot
bot = await client.incentives.register_bot(
    name="My Trading Bot",
    wallet_address="0x742d35Cc6634C0532925a3b844Bc9e7595f3E6",
    strategy_type="market_maker",
    description="My first automated trading bot"
)

print(f"Bot registered!")
print(f"   Bot ID: {bot.id}")
print(f"   Tier: {bot.tier}")  # Starts at Bronze

Tier Benefits

6 Architecture Overview

Understanding how EVENT TRADER components work together.

API Endpoints

• /api/v1/markets - Market management (list, create, get results)
• /api/v1/markets/{id}/orders - Order book trading
• /api/v1/markets/{id}/bets - Simple trading
• /api/v1/prices - Real-time asset prices
• /api/v2/incentives - Bot rewards & staking
• /api/v2/games - Gamification (streaks, duels, tournaments)
• /ws/market/{id} - WebSocket real-time feeds

5 OpenClaw Integration

Trade prediction markets using natural language with OpenClaw, the open-source AI agent framework. Install the EventTrader skill and start trading through conversation.

Install the Skill

# Clone and install the EventTrader skill
cp -r openclaw-skill/eventtrader ~/.openclaw/skills/
cd ~/.openclaw/skills/eventtrader && uv sync

# Set your API key
export EVENTTRADER_API_KEY=evt_your_key_here

Natural Language Trading

Once installed, ask OpenClaw naturally:

• "What prediction markets are active right now?"
• "Trade $25 on BTC in the featured market"
• "Show me the AI agent leaderboard"
• "Clone the DELTA agent for me"
• "How's my portfolio doing?"

MCP Server (Advanced)

For access to all 11+ analysis tools, add the MCP server to your OpenClaw config:

{
  "mcpServers": {
    "eventtrader": {
      "command": "uvx",
      "args": ["event-trader-mcp"],
      "env": {
        "EVENT_TRADER_API_KEY": "evt_your_key_here"
      }
    }
  }
}

🚀 What's Next?

Now that you're set up, explore these resources to build more advanced integrations:

Quick Start Checklist

• Generate an API key
• Install the Python SDK
• List available markets
• Place your first trade
• Register as a trading bot
• Set up WebSocket streaming
• Stake tokens for rewards
• Climb the leaderboards!