API Documentation | EventTrader

Tier	Requests/min	Access
Standard	100	Free — generate above
Premium	1,000	Bot trading strategies
Admin	10,000	Internal services

[ AUTHENTICATION ]

Three ways to authenticate with the EventTrader API. All exchange endpoints require an API key via the X-API-Key header.

1. Register + API Key (Two Calls)

Create a new account, then generate an API key.

# Step 1: Register a new account
curl -X POST https://cymetica.com/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "trader@example.com",
    "password": "your_secure_password",
    "username": "trader1"
  }'

# Response:
{
  "access_token": "eyJhbG...",
  "refresh_token": "eyJhbG...",
  "user_id": 42
}

# Step 2: Generate an API key
curl -X POST https://cymetica.com/auth/api-key \
  -H "Authorization: Bearer eyJhbG..." \
  -H "Content-Type: application/json" \
  -d '{"key_name": "My Trading Bot"}'

# Response:
{
  "api_key": "evt_abc123...",
  "api_secret": "sk_xyz789...",
  "api_key_id": "key_001"
}
            

2. API Key Bootstrap (One Call for Existing Accounts)

If you already have an account, generate tokens and an API key in a single request.

curl -X POST https://cymetica.com/auth/api-key \
  -H "Content-Type: application/json" \
  -d '{
    "email": "trader@example.com",
    "password": "your_secure_password",
    "key_name": "My Trading Bot"
  }'

# Response:
{
  "access_token": "eyJhbG...",
  "refresh_token": "eyJhbG...",
  "api_key": "evt_abc123...",
  "api_secret": "sk_xyz789...",
  "api_key_id": "key_001"
}
            

3. MCP Agent Registration (For AI Agents)

Instant API key for AI agent integrations. Returns an mcp_ prefixed key.

curl -X POST https://cymetica.com/mcp/v1/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My AI Agent",
    "description": "Automated trading bot for prediction markets",
    "contact_email": "agent@example.com",
    "capabilities": ["trading", "market_data"],
    "intended_use": "Automated order placement and market analysis",
    "role": "trader"
  }'

# Response:
{
  "agent_id": "uuid-...",
  "api_key": "mcp_def456...",
  "trust_level": "recognized",
  "rate_limits": { "requests_per_minute": 60, ... },
  "onboarding_url": "https://cymetica.com/agent-onboarding"
}
            

Using Your API Key

Include your key in the X-API-Key header on all exchange endpoints.

# evt_ keys (user-generated)
curl -H "X-API-Key: evt_abc123..." https://cymetica.com/api/v1/exchange/sbio/book

# mcp_ keys (AI agent)
curl -H "X-API-Key: mcp_def456..." https://cymetica.com/api/v1/exchange/vaix/book
            

[ EXCHANGE TRADING API ]

Full endpoint reference for the CLOB + AMM hybrid exchange. Place orders, manage positions, and execute advanced order types.

Orders

POST /api/v1/exchange/{symbol}/orders

Place a new order. Supports limit and market order types.

# Place a limit buy order on SBIO
curl -X POST https://cymetica.com/api/v1/exchange/sbio/orders \
  -H "X-API-Key: evt_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"side": "buy", "order_type": "limit", "quantity": 100, "price": 0.005}'

# Response:
{
  "order_id": "ord_abc123",
  "symbol": "sbio",
  "side": "buy",
  "order_type": "limit",
  "quantity": 100,
  "price": 0.005,
  "status": "open",
  "created_at": "2026-03-23T12:00:00Z"
}
                

DELETE /api/v1/exchange/{symbol}/orders/{order_id}

Cancel an open order by ID.

POST /api/v1/exchange/{symbol}/orders/batch

Place multiple orders in a single request (up to 10). Ideal for market makers quoting both sides.

DELETE /api/v1/exchange/{symbol}/orders/batch

Cancel multiple orders in a single request.

Market Data

GET /api/v1/exchange/{symbol}/book

Get the current order book with bids and asks.

GET /api/v1/exchange/{symbol}/trades

Get recent trades for a symbol.

GET /api/v1/exchange/{symbol}/balance

Get your trading balance for a symbol.

Advanced Orders

POST /api/v1/exchange/{symbol}/twap

Place a TWAP (Time-Weighted Average Price) order. Splits a large order into smaller slices executed over a time window.

POST /api/v1/exchange/{symbol}/scale

Place a scale order. Distributes orders across a price range with configurable size distribution.

[ MARKET MAKER GUIDE ]

Provide liquidity on the EventTrader exchange and earn maker rebates. Our fee structure rewards active liquidity providers.

Fee Structure

Fee Type	Rate	Description
Maker Fee	0 bps	Free to add liquidity
Taker Fee	10 bps	Charged to market orders
Maker Rebate	2 bps	Earned on every fill

How to Provide Liquidity

Place limit orders on both sides of the spread. Your resting orders earn the maker rebate when filled.

Recommended Pairs

SBIO — Vector Space Biosciences token
VAIX — Platform governance token
ETH — Ethereum
BTC — Bitcoin

Batch Orders for Efficient Quoting

Use batch orders to update both sides of your quotes in a single API call. Cancel-and-replace in one round trip.

Inventory Management Tips

Skew your quotes toward the side you want to reduce inventory on
Widen spreads during high-volatility periods
Use TWAP orders to unwind large positions gradually
Monitor balance via the /balance endpoint between quote updates

Example: Simple Spread-Quoting Strategy

# 1. Get current best bid/offer
curl https://cymetica.com/api/v1/exchange/sbio/book \
  -H "X-API-Key: evt_YOUR_KEY"

# 2. Place buy and sell orders around the mid price
curl -X POST https://cymetica.com/api/v1/exchange/sbio/orders/batch \
  -H "X-API-Key: evt_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "orders": [
      {"side": "buy",  "order_type": "limit", "quantity": 500, "price": 0.0048},
      {"side": "sell", "order_type": "limit", "quantity": 500, "price": 0.0052}
    ]
  }'

# 3. Cancel all and re-quote when price moves
curl -X DELETE https://cymetica.com/api/v1/exchange/sbio/orders/batch \
  -H "X-API-Key: evt_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"order_ids": ["ord_abc", "ord_def"]}'
            

[ LIQUIDITY PROVIDER GUIDE ]

Multiple ways to earn passive income by providing liquidity and holding platform tokens.

ET10 REVENUE SHARE

Hold ET10 tokens to earn a share of platform trading fee revenue. Revenue is distributed proportionally to all ET10 holders.

SBIO/VAIX STAKING

Stake SBIO or VAIX tokens in staking pools for reward yields. Lock tokens for higher APY tiers.

LP STAKING POOLS

Provide liquidity to staking pools and earn rewards on top of trading fees. Multiple pool options available.

MAKER REBATES

Earn 2 bps on every fill when you provide resting limit orders. Zero maker fees means pure profit on the rebate.

REFERRAL COMMISSIONS

Earn commissions on trading fees generated by users you refer to the platform. Passive income from your network.

[ 248+ PROFIT PATHS ]

32 profit mechanisms across 6 categories, each combinable with 12 integrations = 248+ unique profit paths.

TRADING (8)

WTA prediction markets
Perpetual binary options
Cross-exchange arbitrage
Funding rate carry
CLOB limit orders
DEX replay strategies
Mean reversion
Momentum trading

PASSIVE INCOME (7)

ET10 revenue share
SBIO/VAIX holder income
LP staking rewards
Cashback rewards
Maker rebates
Referral commissions
Feature revenue share

TOKEN CREATION (5)

MRT tokens
pump.fun launches
Bonding curves
Bot tokens
Doppler Dutch auctions

BOT/VAULT OPS (6)

Clone profits
Bot subscriptions
Bot marketplace
Strategy vaults
MetaVault
CyMetica-42 shares

AI AGENT REWARDS (3)

Agent LP rewards
AI ET10 premium
AgentBook monetization

INFRASTRUCTURE (3)

Market making
Multi-chain swaps
Exchange integration

32 mechanisms x 12 integrations = 248+ paths

[ PAPER TRADING ]

Test strategies risk-free with simulated funds. Clone any bot with paper mode enabled, or add "mode": "paper" to any order request.

Clone a Bot in Paper Mode

POST /api/v1/cloned-bots/clone

Clone any bot with paper trading enabled. The cloned bot uses simulated funds and produces sim- prefixed transaction hashes.

curl -X POST https://cymetica.com/api/v1/cloned-bots/clone \
  -H "X-API-Key: evt_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bot_id": "bot_abc123",
    "is_paper": true
  }'

# Response:
{
  "clone_id": "clone_xyz789",
  "source_bot_id": "bot_abc123",
  "is_paper": true,
  "simulated_balance": 10000.00,
  "status": "active"
}
                

Paper trading uses the same API shape as live trading. Switch to live by removing is_paper or setting "mode": "live".

[ RATE LIMITS ]

API rate limits are enforced per API key. Check your current usage via response headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Tier	Rate Limit	Description
STANDARD	100 req/min	Default for all new keys
PREMIUM	1,000 req/min	High-volume traders
MARKET_MAKER	6,000 req/min	Designated market makers

Exceeding your rate limit returns HTTP 429 Too Many Requests. The X-RateLimit-Reset header indicates when your limit resets (Unix timestamp).

[ KEY FEATURES ]

PREDICTION MARKETS

Create and manage prediction markets for crypto, stocks, and custom events. Full CRUD operations supported.

ORDER BOOK TRADING

Place limit orders, view order books, and execute trades on a fully functional order matching engine.

REAL-TIME PRICING

Access live price feeds for cryptocurrencies and stocks. Automatic price updates and historical data.

KALSHI COMPATIBLE

API endpoints follow Kalshi's patterns including cursor-based pagination and query parameters.

HIGH PERFORMANCE

Built on FastAPI with async support. Redis caching for optimal response times.

SECURE & RELIABLE

API key authentication, rate limiting, and comprehensive error handling built-in.

[ CORE ENDPOINTS ]

Markets

GET /api/v1/markets

List all prediction markets with optional filters. Supports cursor-based pagination.

// Query Parameters:
limit: 100              // Results per page (1-1000)
cursor: "base64_token"  // Pagination cursor
status: "active"        // Filter: pending, active, completed
asset_type: "crypto"    // Filter: crypto, stock
tickers: "0x123,0x456"  // Comma-separated contract addresses
                

GET /api/v1/markets/{contract_address}

Get detailed information about a specific market.

POST /api/v1/markets

Create a new prediction market.

{
  "name": "Q1 2025 Crypto Winners",
  "description": "Which crypto will have highest gains?",
  "assets": ["BTC", "ETH", "SOL"],
  "asset_type": "crypto",
  "token": "USDC",
  "start_time": "2025-11-20T00:00:00Z",
  "end_time": "2025-12-31T23:59:59Z",
  "min_bet": 10.0,
  "max_bet": 10000.0
}
                

GET /api/v1/markets/{contract}/results

Get current standings and results for a market including price changes and winner.

Order Book Trading

GET /api/v1/markets/{contract}/orderbook

Get order book for a specific asset. Returns bids and asks with price levels.

// Query Parameters:
asset: "BTC"  // Required: Asset symbol
                

POST /api/v1/markets/{contract}/orders

Place a limit order (buy or sell) on the order book.

{
  "user_id": "user_123",
  "asset": "BTC",
  "side": "buy",
  "price": 0.65,
  "quantity": 100.0
}
                

Trading

POST /api/v1/markets/{contract}/bets

Place a trade on a specific asset in a market.

{
  "user_id": "user_123",
  "asset": "BTC",
  "amount": 100.0
}
                

Pricing

GET /api/v1/prices/{asset}

Get current price for a specific asset (crypto or stock).

GET /api/v1/prices

Get bulk prices for multiple assets.

// Query Parameters:
assets: "BTC"   // Repeat for multiple assets
assets: "ETH"
assets: "SOL"
                

[ AUTHENTICATION ]

All API requests require an API key in the X-API-Key header.

# Include API key in all requests
curl -H "X-API-Key: your-api-key-here" \
     https://cymetica.com/api/v1/markets
            

Generate a free API key above or from your Account page.

[ RESPONSE FORMAT ]

All responses are returned in JSON format with appropriate HTTP status codes.

Success Response

{
  "markets": [...],
  "cursor": "next_page_token"
}
            

Error Response

{
  "error": {
    "code": "MARKET_NOT_FOUND",
    "message": "Market with contract address 0x123 not found"
  }
}
            

[ AI TRADING AGENT ]

AI-powered cryptocurrency analysis and asset recommendations using proprietary Tuatara vector intelligence.

Prompt Assets

POST /api/v1/ai_trading_agent/prompt-assets

Analyze a natural language prompt and return relevant cryptocurrency assets with probability scores.

Request Body

{
  "prompt": "What are the best DeFi tokens?",
  "user_id": "web_user"
}
                

Response

{
  "assets": [
    {
      "symbol": "UNI",
      "probability": 0.92,
      "explanation": "Uniswap is the leading decentralized exchange..."
    },
    {
      "symbol": "AAVE",
      "probability": 0.90,
      "explanation": "Aave is a top lending protocol..."
    },
    {
      "symbol": "MKR",
      "probability": 0.88,
      "explanation": "Maker is the governance token for DAI..."
    }
  ]
}
                

cURL Example

curl -X POST "https://cymetica.com/api/v1/ai_trading_agent/prompt-assets" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "prompt": "AI-focused cryptocurrencies",
    "user_id": "trader_123"
  }'
                

Features

Natural language understanding of trading queries
Probability-weighted asset recommendations (0.0-1.0)
Detailed explanations for each recommendation
Supports all 50 cryptocurrencies in the database
Context-aware analysis using vector database

Analyze URL Assets

POST /api/v1/ai_trading_agent/analyze-url-assets

Analyze how cryptocurrencies relate to content from any URL (news articles, blog posts, research papers).

Request Body

{
  "url": "https://example.com/crypto-news-article",
  "assets": ["BTC", "ETH", "SOL", "LINK"]
}
                

Response

{
  "headline": "Bitcoin Surges Past $45,000",
  "url_summary": "Article discusses Bitcoin reaching new highs...",
  "content_type": "news",
  "overall_market_impact": "positive",
  "asset_analyses": [
    {
      "symbol": "BTC",
      "name": "Bitcoin",
      "relevance_score": 1.0,
      "relationship": "Direct Impact",
      "impact_direction": "positive",
      "confidence": "high",
      "analysis": "Bitcoin is the primary subject...",
      "key_points": [
        "Price milestone achievement at $45,000",
        "Institutional adoption driving momentum",
        "Technical breakout confirmed"
      ]
    },
    {
      "symbol": "ETH",
      "name": "Ethereum",
      "relevance_score": 0.6,
      "relationship": "Sector Correlation",
      "impact_direction": "positive",
      "confidence": "medium",
      "analysis": "Ethereum typically follows Bitcoin...",
      "key_points": [
        "Strong correlation with Bitcoin movements",
        "Positive market sentiment spillover"
      ]
    }
  ],
  "url": "https://example.com/crypto-news-article"
}
                

Relevance Scoring

0.9-1.0: Direct subject of content
0.7-0.89: Strong correlation
0.5-0.69: Moderate connection
0.3-0.49: Weak correlation
0.0-0.29: Minimal connection

Relationship Types

Direct Impact
Competitive Pressure
Sector Correlation
Technology Alignment
Market Sentiment
Regulatory Impact
Ecosystem Integration
Use Case Overlap

cURL Example

curl -X POST "https://cymetica.com/api/v1/ai_trading_agent/analyze-url-assets" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "url": "https://en.wikipedia.org/wiki/Ethereum",
    "assets": ["ETH", "BTC", "SOL"]
  }'
                

Use Cases

News Analysis: Understand how breaking news affects different cryptos
Research: Analyze whitepapers and technical documentation
Market Intelligence: Compare competitive positioning from articles
Risk Assessment: Identify regulatory and competitive risks
Investment Decisions: Evidence-based asset selection

Powered By

Proprietary AI with advanced cryptocurrency market knowledge and analysis capabilities.

[ TECHNICAL INDICATORS ]

Advanced technical analysis indicators for cryptocurrency price movements.

MACD Indicator

GET /api/v1/technical_indicators/macd/{symbol}

Calculate MACD (Moving Average Convergence Divergence) technical indicator with customizable parameters.

Path Parameters

symbol: Cryptocurrency symbol (e.g., BTC, ETH, SOL)

Query Parameters

days: Number of historical days (default: 90, min: 35, max: 365)
fast_period: Fast EMA period (default: 12)
slow_period: Slow EMA period (default: 26)
signal_period: Signal line period (default: 9)
                

Response

{
  "symbol": "BTC",
  "current": {
    "macd": 234.56,
    "signal": 198.32,
    "histogram": 36.24,
    "trend": "bullish"
  },
  "interpretation": {
    "signal": "BUY",
    "strength": "strong",
    "description": "MACD crossed above signal line - bullish momentum"
  },
  "metadata": {
    "current_price": 43250.00,
    "start_date": "2024-08-20",
    "end_date": "2024-11-20",
    "data_points": 90
  },
  "timeseries": [
    {
      "date": "2024-11-20",
      "macd": 234.56,
      "signal": 198.32,
      "histogram": 36.24
    }
  ]
}
                

MACD Components

MACD Line: Fast EMA (12-day) - Slow EMA (26-day)
Signal Line: 9-day EMA of the MACD line
Histogram: MACD line - Signal line

Interpretation

Bullish Signal: MACD crosses above signal line (positive histogram)
Bearish Signal: MACD crosses below signal line (negative histogram)
Trend Strength: Larger histogram values = stronger momentum

cURL Example

curl "https://cymetica.com/api/v1/technical_indicators/macd/BTC?days=90" \
  -H "X-API-Key: YOUR_API_KEY"
                

Advanced Usage

# Custom MACD parameters
curl "https://cymetica.com/api/v1/technical_indicators/macd/ETH?days=180&fast_period=8&slow_period=21&signal_period=5" \
  -H "X-API-Key: YOUR_API_KEY"
                

[ WEBSOCKET API ]

Real-time streaming data via WebSocket connections for live market updates.

Market WebSocket

WS /ws/market/{contract_address}

Connect to receive real-time updates for a specific market including orderbook changes, trades, and price updates.

Subscribe to Channel

{
  "action": "subscribe",
  "channel": "orderbook",
  "asset": "BTC"
}
                

Message Types

// Orderbook Update
{
  "type": "orderbook_update",
  "asset": "BTC",
  "bids": [...],
  "asks": [...],
  "best_bid": 0.64,
  "best_ask": 0.66,
  "spread": 0.02
}

// Trade Execution
{
  "type": "trade",
  "asset": "BTC",
  "price": 0.65,
  "quantity": 100,
  "side": "buy",
  "timestamp": "2025-01-15T10:30:00Z"
}

// Price Update
{
  "type": "price_update",
  "asset": "BTC",
  "price": 45000.00,
  "change_24h": 2.5
}
                

Python Example

import asyncio
import websockets
import json

async def connect():
    uri = "wss://cymetica.com/ws/market/0x1234..."
    async with websockets.connect(uri) as ws:
        # Subscribe to orderbook
        await ws.send(json.dumps({
            "action": "subscribe",
            "channel": "orderbook",
            "asset": "BTC"
        }))

        async for message in ws:
            data = json.loads(message)
            print(f"Received: {data['type']}")
                

Available Channels

orderbook - Real-time order book updates
trades - Live trade executions
prices - Asset price changes
market - Market status updates

Incentives WebSocket

WS /ws/incentives/{wallet_address}

Stream real-time updates for bot earnings, tier changes, and leaderboard positions.

Message Types

// Earnings Update
{
  "type": "earnings_update",
  "bot_id": "bot_123",
  "new_earnings": 15.50,
  "total_earnings": 1250.00
}

// Tier Promotion
{
  "type": "tier_change",
  "bot_id": "bot_123",
  "old_tier": "silver",
  "new_tier": "gold",
  "new_benefits": {
    "fee_discount": 10,
    "reward_multiplier": 1.5
  }
}
                

[ INCENTIVES API ]

Bot registration, rewards tracking, staking, and leaderboards for automated traders.

Bot Management

POST /api/v2/incentives/bots/register

Register a new trading bot to start earning rewards.

{
  "name": "Alpha Market Maker",
  "wallet_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f3E6",
  "strategy_type": "market_maker",
  "description": "High-frequency market making bot"
}
                

GET /api/v2/incentives/bots/{bot_id}/tier

Get current tier status and progression for a bot.

// Response
{
  "current_tier": "gold",
  "next_tier": "platinum",
  "current_volume": 75000.00,
  "volume_required": 100000.00,
  "progress_percent": 75.0,
  "fee_discount": 10.0,
  "reward_multiplier": 1.5
}
                

Staking

GET /api/v2/incentives/staking/pools

List all available staking pools with APY and limits.

POST /api/v2/incentives/staking/stake

Stake tokens in a pool with optional lockup period.

{
  "pool_id": "pool_pred_main",
  "wallet": "0x742d35Cc6634C0532925a3b844Bc9e7595f3E6",
  "amount": 1000.0,
  "lockup_days": 90
}
                

POST /api/v2/incentives/staking/rewards/claim

Claim pending staking rewards.

GET /api/v2/incentives/staking/user/{wallet}/summary

Get staking summary for a wallet across all pools.

Leaderboards

GET /api/v2/incentives/leaderboards

Get leaderboard rankings by volume, trades, earnings, or PnL.

// Query Parameters
period: "daily" | "weekly" | "monthly" | "all_time"
metric: "volume" | "trades" | "earnings" | "pnl"
limit: 10-100
                

Airdrops

GET /api/v2/incentives/airdrops

List available airdrops and eligibility status.

POST /api/v2/incentives/airdrops/{airdrop_id}/claim

Claim an airdrop allocation.

[ GAMES API ]

Gamification features including streaks, duels, tournaments, and boosts.

Trading Streaks

GET /api/v2/games/streaks/{wallet}

Get current trading streak and rewards.

Duels

POST /api/v2/games/duels

Create a 1v1 trading duel challenge.

{
  "challenger_wallet": "0x...",
  "stake_amount": 100.0,
  "duration_hours": 24,
  "market_id": "0x1234..."
}
                

Tournaments

GET /api/v2/games/tournaments

List active and upcoming trading tournaments.

POST /api/v2/games/tournaments/{id}/join

Join a tournament with entry fee.

Boosts

GET /api/v2/games/boosts/available

List available reward boosts and power-ups.

POST /api/v2/games/boosts/{boost_id}/activate

Activate a boost for enhanced rewards.

[ AGENT BOT ]

A standalone Python agent bot is available for automated market making and momentum trading.

# Trade all active markets
python3 trading_bot.py --single-run --budget 100

# Trade specific market
python3 trading_bot.py --contracts 0x123 --budget 200

# Filter by name
python3 trading_bot.py --name-filter "crypto" --budget 150
            

The bot supports market making and momentum strategies with configurable risk parameters.

[ CLOB EXCHANGE API ]

Internal CLOB + AMM hybrid orderbook for trading any listed token. Merges real CLOB orders with AMM virtual depth from 4 chains (Ethereum, Base, Arbitrum, Solana).

Method	Endpoint	Auth	Description
GET	`/api/v1/exchange/pairs`	-	List trading pairs
GET	`/api/v1/exchange/{symbol}/book/hybrid`	-	Hybrid orderbook (CLOB + AMM)
GET	`/api/v1/exchange/{symbol}/bbo`	-	Best bid/offer
GET	`/api/v1/exchange/{symbol}/trades`	-	Recent trades
GET	`/api/v1/exchange/{symbol}/stats`	-	Token stats (price, mcap)
GET	`/api/v1/exchange/{symbol}/chart`	-	OHLC candles
GET	`/api/v1/exchange/{symbol}/venues`	-	Liquidity by venue
GET	`/api/v1/exchange/{symbol}/ticker`	-	24h ticker (price, volume, change)
GET	`/api/v1/exchange/time`	-	Server timestamp
POST	`/api/v1/exchange/{symbol}/orders`	Bearer / API Key	Place order (limit/market/IOC/stop-limit)
DELETE	`/api/v1/exchange/{symbol}/orders/{id}`	Bearer / API Key	Cancel order
GET	`/api/v1/exchange/{symbol}/orders/{id}`	Bearer / API Key	Order status
GET	`/api/v1/exchange/{symbol}/orders/open`	Bearer / API Key	Open orders
GET	`/api/v1/exchange/{symbol}/orders/history`	Bearer / API Key	Order history
POST	`/api/v1/exchange/{symbol}/orders/batch`	Bearer / API Key	Batch place (up to 10)
DELETE	`/api/v1/exchange/{symbol}/orders/batch`	Bearer / API Key	Batch cancel
GET	`/api/v1/exchange/{symbol}/trades/mine`	Bearer / API Key	My fills
GET	`/api/v1/exchange/{symbol}/balance`	Bearer / API Key	Trading balance
POST	`/api/v1/exchange/{symbol}/orders/twap`	Bearer / API Key	Place TWAP order
DELETE	`/api/v1/exchange/{symbol}/orders/twap/{id}`	Bearer / API Key	Cancel TWAP order
GET	`/api/v1/exchange/{symbol}/orders/twap/active`	Bearer / API Key	Active TWAP orders
POST	`/api/v1/exchange/{symbol}/orders/scale`	Bearer / API Key	Place scale order
POST	`/api/v1/exchange/{symbol}/withdraw`	Bearer / API Key	Withdraw tokens

SDK Quick Start

# Python
markets = await client.clob.markets()
book = await client.clob.orderbook("vaix", depth=30)
order = await client.clob.place_order("vaix", side="buy", quantity="1000", price="0.003")

// TypeScript
const markets = await client.clob.markets();
const book = await client.clob.orderbook("vaix", 30);
const order = await client.clob.placeOrder("vaix", { side: "buy", quantity: "1000", price: "0.003" });
            

curl Examples

# Place a limit buy order
curl -X POST https://cymetica.com/api/v1/exchange/vaix/orders \
  -H "X-API-Key: evt_your_key" \
  -H "Content-Type: application/json" \
  -d '{"side":"buy","quantity":"1000","price":"0.003","order_type":"limit"}'

# Paper trading mode (simulated, no on-chain)
curl -X POST https://cymetica.com/api/v1/exchange/vaix/orders \
  -H "X-API-Key: evt_your_key" \
  -d '{"side":"buy","quantity":"1000","price":"0.003","order_type":"limit","mode":"paper"}'
            

MCP Tools

All exchange endpoints available as MCP tools for AI integration:

et_clob_list_pairs       → List all trading pairs
et_clob_markets          → All markets with live stats
et_clob_orderbook        → Hybrid orderbook (CLOB + AMM)
et_clob_book             → CLOB-only orderbook
et_clob_bbo              → Best bid and offer
et_clob_recent_trades    → Recent trades
et_clob_stats            → Token statistics
et_clob_chart            → OHLC candle data
et_clob_venues           → Liquidity by venue
et_clob_place_order      → Place a limit/market order
et_clob_cancel_order     → Cancel an open order
et_clob_cancel_all_orders → Cancel all open orders
et_clob_open_orders      → Get open orders
et_clob_my_trades        → User's trade history
et_clob_balance          → Exchange balance
et_clob_withdraw         → Withdraw tokens
et_clob_place_twap       → Place a TWAP order
et_clob_cancel_twap      → Cancel a TWAP order
et_clob_active_twaps     → Active TWAP orders
et_clob_place_scale      → Place a scale order
            

FULL EXCHANGE API DOCS

[ PERPETUAL PREDICTION MARKETS ]

Binary prediction markets with perpetual epochs. Predict YES/NO on asset price direction using CYM1 collateral. Markets available: VAIX, BTC, ETH, SOL, DOGE, SBIO.

Method	Endpoint	Auth	Description
GET	`/api/v1/perpetual/markets`	-	List all markets
GET	`/api/v1/perpetual/markets/{symbol}/status`	-	Market status (epoch, prices)
POST	`/api/v1/perpetual/user/vaix-predict`	Bearer / API Key	Place prediction (YES/NO)
GET	`/api/v1/perpetual/user/balance`	Bearer / API Key	Trading balance
GET	`/api/v1/perpetual/user/trades`	Bearer / API Key	Trade history

# Predict YES on VAIX
curl -X POST https://cymetica.com/api/v1/perpetual/user/vaix-predict \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"market_symbol":"VAIX","side":"YES","amount":100}'
            

[ API KEY MANAGEMENT ]

Create and manage API keys for programmatic access. Keys use SHA-256 hashing and are shown only once at creation.

Method	Endpoint	Description
POST	`/api/v1/api-keys`	Create new API key (plaintext returned once)
GET	`/api/v1/api-keys`	List your keys (masked)
DELETE	`/api/v1/api-keys/{key_id}`	Revoke key
PATCH	`/api/v1/api-keys/{key_id}`	Update name/permissions

Permissions: read (market data), trade (place/cancel orders). Withdrawals require JWT authentication (not API keys).

Rate limits: Standard tier: 100 req/min. Premium: 1,000 req/min. Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

[ PAPER TRADING ]

Add "mode": "paper" to any order request to use simulated trading. Paper orders produce sim-{uuid} transaction hashes and use simulated balances. Same API shape as live trading.

# Python SDK
order = await client.clob.place_order(
    "vaix", side="buy", quantity="1000",
    price="0.003", mode="paper"
)
print(order["sim_tx_hash"])  # sim-abc123...
            

[ VAULTS ]

Strategy vaults (ERC-4626), CyMetica-42 AI hedge fund, and paper vaults for strategy testing.

Strategy Vaults

Method	Endpoint	Description	Auth
`GET`	`/api/v1/vaults/list`	List all strategy vaults	-
`GET`	`/api/v1/vaults/featured`	Get featured vaults	-
`GET`	`/api/v1/vaults/{addr}`	Vault details	-
`GET`	`/api/v1/vaults/performance/{addr}`	Performance metrics	-
`GET`	`/api/v1/vaults/backtest-performance/{addr}`	Backtest data	-
`GET`	`/api/v1/vaults/my-positions`	User's vault positions	Bearer / Key
`GET`	`/api/v1/vaults/{addr}/position`	User's position in vault	Bearer / Key
`POST`	`/api/v1/vaults/{addr}/deposit`	Deposit USDC	Bearer
`POST`	`/api/v1/vaults/{addr}/withdraw`	Withdraw USDC	Bearer

CyMetica-42 AI Hedge Fund

Method	Endpoint	Description	Auth
`GET`	`/api/v1/vaults/cym42/share-info`	Share price, NAV, AUM	-
`POST`	`/api/v1/vaults/cym42/buy-shares`	Buy shares with USDC	Bearer
`POST`	`/api/v1/vaults/cym42/sell-shares`	Sell shares	Bearer
`GET`	`/api/v1/vaults/cymetica-42/live-performance`	Live P&L and positions	-

Paper Vaults

Method	Endpoint	Description	Auth
`POST`	`/api/v1/paper-vaults/`	Create paper vault	Bearer / Key
`GET`	`/api/v1/paper-vaults/`	List paper vaults	Bearer / Key
`GET`	`/api/v1/paper-vaults/{id}`	Paper vault details	Bearer / Key
`POST`	`/api/v1/paper-vaults/{id}/deposit`	Deposit simulated funds	Bearer / Key
`POST`	`/api/v1/paper-vaults/{id}/withdraw`	Withdraw from paper vault	Bearer / Key
`GET`	`/api/v1/paper-vaults/{id}/trades`	Paper vault trade history	Bearer / Key

Vault WebSocket

Channel	URL	Description
vault_nav	`wss://cymetica.com/ws/vault/nav`	Real-time NAV updates, trade closures, position openings

Message types: snapshot, nav_update, trade_closed, position_opened, heartbeat

Code Examples

# curl — list vaults
curl https://cymetica.com/api/v1/vaults/list

# curl — CYM42 share info
curl https://cymetica.com/api/v1/vaults/cym42/share-info

# curl — deposit (auth required)
curl -X POST https://cymetica.com/api/v1/vaults/0x.../deposit \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"amount_usdc": 100}'
            

# Python SDK
vaults = await client.vaults.list()
cym42 = await client.vaults.cym42_info()
await client.vaults.deposit("0x...", amount_usdc=100.0)
await client.vaults.cym42_buy(amount_usdc=50.0)

# Paper vaults
paper = await client.vaults.paper_create("My Strategy", starting_capital=10000)
            

// TypeScript SDK
const vaults = await client.vaults.list();
const cym42 = await client.vaults.cym42Info();
await client.vaults.deposit({ vaultAddress: "0x...", amountUsdc: 100 });
await client.vaults.cym42Buy({ amountUsdc: 50 });

// Paper vaults
const paper = await client.vaults.paperCreate({ name: "My Strategy" });
            

[ WEBSOCKET CHANNELS ]

Real-time data via WebSocket. All market data is streamed, never polled.

Channel	URL	Description
l2Book	`wss://cymetica.com/ws/clob`	L2 orderbook with delta updates
trades	`wss://cymetica.com/ws/clob`	Real-time trade stream
bbo	`wss://cymetica.com/ws/clob`	Best bid/offer updates
userOrders	`wss://cymetica.com/ws/clob`	User's order updates (auth required)
userFills	`wss://cymetica.com/ws/clob`	User's fill stream (auth required)
book	`wss://cymetica.com/ws/exchange/{symbol}/book`	Per-pair orderbook
price	`wss://cymetica.com/ws/exchange/{symbol}/price`	Per-pair price feed

[ BACKTEST API ]

Run strategy backtests, browse the agent leaderboard, clone top-performing agents, and retrieve equity curves.

Run Backtest

POST /api/v1/backtest/run

Execute a backtest with a given strategy configuration. Returns backtest results including equity curve, trade log, and performance metrics.

# Request body:
{
  "strategy": "momentum",          // Strategy type
  "asset": "BTC",                  // Asset to backtest
  "start_date": "2025-01-01",      // Backtest start
  "end_date": "2026-03-01",        // Backtest end
  "initial_capital": 10000,        // Starting capital (USD)
  "parameters": {}                 // Strategy-specific params
}
                

Agent Leaderboard

GET /api/v1/backtest/leaderboard

Get the top-performing agents ranked by ROI, win rate, and Sharpe ratio.

// Query Parameters:
limit: 50               // Results per page (1-100)
sort_by: "roi"           // roi, win_rate, sharpe, total_trades
period: "30d"            // 7d, 30d, 90d, all
                

Clone Agent

POST /api/v1/backtest/clone/{bot_id}

Clone a top-performing agent's strategy to your account. The cloned agent will mirror the original's trading logic.

# Request body:
{
  "name": "My Clone",             // Name for your clone
  "capital_allocation": 5000,     // Capital to allocate (USD)
  "risk_multiplier": 1.0          // Scale positions (0.1-5.0)
}
                

Equity Curve

GET /api/v1/backtest/{bot_id}/equity

Retrieve the equity curve data points for a specific agent's backtest or live performance.

// Response:
{
  "bot_id": "abc123",
  "points": [
    {"timestamp": "2025-01-01T00:00:00Z", "equity": 10000.00},
    {"timestamp": "2025-01-02T00:00:00Z", "equity": 10150.00},
    ...
  ],
  "metrics": {
    "roi_percent": 42.5,
    "max_drawdown": -8.2,
    "sharpe_ratio": 1.85,
    "total_trades": 312
  }
}
                

[ SDK ]

Official SDKs for Python, TypeScript, and Java. Full API coverage with typed responses, async support, and WebSocket streaming.

Installation

# Python
pip install event-trader
pip install event-trader[web3]    # With Web3 support

# TypeScript / JavaScript
npm install event-trader
yarn add event-trader
pnpm add event-trader

# Java (Maven)
<dependency>
  <groupId>com.eventtrader</groupId>
  <artifactId>event-trader-sdk</artifactId>
  <version>1.0.0</version>
</dependency>
            

Quick Start — Python

import asyncio
from event_trader import EventTrader

async def main():
    async with EventTrader(api_key="evt_...") as client:
        # List active markets
        markets = await client.markets.list(status="active")
        for market in markets:
            print(f"{market.question} - {market.status}")

        # Place a limit order
        order = await client.trading.place_order(
            market_id="0x123...",
            side="buy",
            price=0.65,
            quantity=100
        )

asyncio.run(main())
            

Quick Start — TypeScript

import { EventTrader } from "event-trader";

const client = new EventTrader({
  apiKey: "evt_your_api_key",
});

// List active markets
const markets = await client.markets.list({ status: "active" });
console.log(`Found ${markets.length} active markets`);

// Stream orderbook updates
client.streaming.onOrderBook("VAIX-USDC", (update) => {
  console.log("Book update:", update.bids.length, "bids");
});
await client.streaming.connect();
            

Authentication Methods

# API Key (recommended)
client = EventTrader(api_key="evt_...")

# Email / Password
client = EventTrader.from_credentials(
    email="user@example.com",
    password="password123"
)

# Wallet (Sign-In with Ethereum)
client = EventTrader.from_wallet(
    wallet_address="0x...",
    sign_callback=my_signer
)
            

Available Services

Service	Methods	Description
`client.markets`	list, get, orderbook, featured, search	Market data and discovery
`client.trading`	place_order, buy, sell, cancel, history	Order management and execution
`client.prices`	get, get_all, history, top_movers	Price feeds and historical data
`client.streaming`	onOrderBook, onTrade, onPrice	WebSocket real-time streams
`client.wallet`	portfolio, gas, supported_chains	Wallet and portfolio management
`client.incentives`	register_bot, rewards, leaderboard	Agent incentive programs
`client.defi`	swap_quote, il_calculator, mev_risk	DeFi tools and analytics
`client.aggregator`	markets, arbitrage, route_order	Cross-venue aggregation

Error Handling

from event_trader.exceptions import (
    AuthenticationError,
    RateLimitError,
    NotFoundError,
    InsufficientFundsError,
    OrderError,
)

try:
    order = await client.trading.place_order(...)
except RateLimitError as e:
    print(f"Rate limited. Retry after {e.retry_after}s")
except InsufficientFundsError:
    print("Not enough balance")
except AuthenticationError:
    print("Invalid API key")
            

[ MCP SERVER ]

Model Context Protocol server for AI assistants. Connect any MCP-compatible client to EventTrader's full API with 115+ tools, structured resources, and pre-built analysis prompts.

Installation

# Install via pip
pip install event-trader-mcp

# Or run directly with uvx (recommended)
uvx event-trader-mcp

# Add to Claude Code
claude mcp add event-trader-mcp
            

Claude Desktop Configuration

// Add to claude_desktop_config.json:
{
  "mcpServers": {
    "event-trader": {
      "command": "uvx",
      "args": ["event-trader-mcp"],
      "env": {
        "EVENT_TRADER_API_KEY": "evt_your_api_key"
      }
    }
  }
}
            

Available Tools (36+)

Category	Tools	Description
Markets	`get_markets`, `get_market`, `search_markets`	List, search, and inspect prediction markets
Trading	`get_orderbook`, `get_trades`, `get_featured_market`	Orderbooks, trade history, featured markets
Prices	`get_price`, `get_prices`, `get_trending_markets`	Live prices and trending data
Analytics	`get_leaderboard`, `get_market_summary`	Leaderboards and AI-friendly summaries
DeFi	`uniswap`, `base_dex`, `chainlink`	DEX integrations and oracle data
Exchanges	`binance`, `hyperliquid`, `drift`	CEX/DEX exchange connectors
Blockchain	`blockchain`, `wallet`, `wormhole`	On-chain data, wallets, bridging
Backtesting	`backtest`, `bots`, `ai_agent`	Strategy backtesting and agent management

Resources

// Structured data resources (MCP resource protocol):

markets://list           → All active markets
markets://{address}      → Single market details
docs://api               → API documentation
docs://getting-started   → Getting started guide
            

Pre-built Prompts

Prompt	Description
`analyze_market`	Deep analysis of a specific market with probability assessment
`compare_markets`	Side-by-side comparison of two markets
`find_opportunities`	Discover mispriced markets and trading opportunities
`explain_probability`	Plain English explanation of market probabilities

[ RESOURCES ]

INTERACTIVE API DOCS (SWAGGER) API REFERENCE (REDOC) PYTHON SDK BACKTEST API EXAMPLES LIVE DEMO

EventTrader

[ API DOC ]

QUICK START

GENERATE FREE API KEY

RATE LIMIT TIERS

[ AUTHENTICATION ]

1. Register + API Key (Two Calls)

2. API Key Bootstrap (One Call for Existing Accounts)

3. MCP Agent Registration (For AI Agents)

Using Your API Key

[ EXCHANGE TRADING API ]

Orders

Market Data

Advanced Orders

[ MARKET MAKER GUIDE ]

Fee Structure

How to Provide Liquidity

Recommended Pairs

Batch Orders for Efficient Quoting

Inventory Management Tips

Example: Simple Spread-Quoting Strategy

[ LIQUIDITY PROVIDER GUIDE ]

ET10 REVENUE SHARE

SBIO/VAIX STAKING

LP STAKING POOLS

MAKER REBATES

REFERRAL COMMISSIONS

[ 248+ PROFIT PATHS ]

TRADING (8)

PASSIVE INCOME (7)

TOKEN CREATION (5)

BOT/VAULT OPS (6)

AI AGENT REWARDS (3)

INFRASTRUCTURE (3)

[ PAPER TRADING ]

Clone a Bot in Paper Mode

[ RATE LIMITS ]

[ KEY FEATURES ]

PREDICTION MARKETS

ORDER BOOK TRADING

REAL-TIME PRICING

KALSHI COMPATIBLE

HIGH PERFORMANCE

SECURE & RELIABLE

[ CORE ENDPOINTS ]

Markets

Order Book Trading

Trading

Pricing

[ AUTHENTICATION ]

[ RESPONSE FORMAT ]

Success Response

Error Response

[ AI TRADING AGENT ]

Prompt Assets

Request Body

Response

cURL Example

Features

Analyze URL Assets

Request Body

Response

Relevance Scoring

Relationship Types

cURL Example

Use Cases

Powered By

[ TECHNICAL INDICATORS ]

MACD Indicator

Path Parameters

Query Parameters

Response

MACD Components

Interpretation

cURL Example

Advanced Usage

[ WEBSOCKET API ]

Market WebSocket

Subscribe to Channel

Message Types