Paper Trading (Live Proxy)

Paper Trading allows you to forward-test your strategies against Live Polymarket data and Fivesight's simulated matching engine without using real funds.

How it Works

• Live Market Data: The client receives real-time market data from the live Fivesight API.
• Simulated Execution: Orders are intercepted by the Fivesight backend and matched against a simulated internal ledger. They are NOT sent to the Polymarket Exchange.
• Separate Portfolio: Your "Paper" wallet is distinct from your live wallet and persists across sessions.

Usage

Set simulation_mode=True when initializing the client, or use the create_simulation_session method.

1. Initialize Session

from fivesight_clob_client.client import ClobClient

# Initialize with simulation endpoint (or let it default based on env)
client = ClobClient(
    key="YOUR_API_KEY", 
    chain_id=137, 
    simulation_mode=True
)

# Create/Resume a PAPER session with a starting balance
client.create_simulation_session(mode="PAPER", initial_balance=10000)

2. Trade as Usual

All standard order methods work identically in Paper Trading mode.

# Fetches LIVE data from Polymarket
book = client.get_order_book(token_id="THE_TOKEN_ID")

# Places a SIMULATED order
order = client.create_and_post_order(
    OrderArgs(
        price=0.5,
        size=10.0,
        side=OrderSide.BUY,
        token_id="THE_TOKEN_ID"
    )
)
print(f"Paper Order Placed: {order.id}")

3. Resetting

You can reset your paper wallet at any time by creating a new session with your desired initial balance.