Connecting Broker Accounts

Link your broker account via OAuth for secure order routing

Overview

SnipeRoute connects to your broker account using OAuth 2.0 for secure, non-custodial order routing. You authorize SnipeRoute to place orders on your behalf without sharing passwords or giving withdrawal permissions.

Supported Brokers

OAuth Connection Flow

Connecting Alpaca

Prerequisites

• Alpaca account (sign up here (opens in a new tab))
• Funded account (or paper trading account for testing)

Step-by-Step

1. Go to SnipeRoute Dashboard

   https://app.sniperoute.io/settings/brokers

2. Click "Connect Alpaca"

   • You'll be redirected to Alpaca's OAuth page

3. Log in to Alpaca

   • Enter your Alpaca credentials

4. Authorize Trading Permissions

   • Review the permissions:
     • Place orders
     • View account information
     • View positions
     • Withdraw funds
     • Modify account settings
   • Click Authorize

5. Copy Broker ID

   broker_id: "alpaca_abc123"

Test Connection

import asyncio
from sniperoute import SnipeRouteClient
from sniperoute.models import TradeIntentRequest, OrderSide, OrderType
from decimal import Decimal
 
async def test_alpaca():
    client = SnipeRouteClient()
 
    intent = TradeIntentRequest(
        intent_id="alpaca_test_001",
        symbol="AAPL",
        side=OrderSide.BUY,
        quantity=Decimal("1"),
        order_type=OrderType.MARKET,
        broker_id="alpaca_abc123"  # Your Alpaca connection ID
    )
 
    response = await client.create_intent(intent)
    print(f"Connected to Alpaca! Order status: {response.status}")
 
asyncio.run(test_alpaca())

Connecting Interactive Brokers (IBKR)

Prerequisites

• IBKR account with API access enabled
• Funded account

Step-by-Step

1. Enable API Access in IBKR

   • Log in to IBKR Account Management
   • Go to Settings → API → Settings
   • Enable API Access
   • Note your username and account ID

2. Go to SnipeRoute Dashboard

   https://app.sniperoute.io/settings/brokers

3. Click "Connect IBKR"

   • You'll be redirected to IBKR's OAuth page

4. Authorize SnipeRoute

   • Log in with your IBKR credentials
   • Authorize trading permissions
   • Click Approve

5. Copy Broker ID

   broker_id: "ibkr_xyz789"

Connecting Charles Schwab

Prerequisites

• Schwab account with API access
• Funded account

Step-by-Step

1. Go to SnipeRoute Dashboard

   https://app.sniperoute.io/settings/brokers

2. Click "Connect Schwab"

   • You'll be redirected to Schwab's OAuth page

3. Log in to Schwab

   • Enter your Schwab credentials

4. Authorize Trading Permissions

   • Review permissions and click Approve

5. Copy Broker ID

   broker_id: "schwab_def456"

Using Mock Broker (Testing)

For development and testing, use the built-in Mock Broker:

intent = TradeIntentRequest(
    intent_id="test_001",
    symbol="AAPL",
    side=OrderSide.BUY,
    quantity=Decimal("10"),
    order_type=OrderType.MARKET,
    broker_id="mock"  # No OAuth required
)

Mock Broker Features:

• Instant fills at simulated prices
• No real money involved
• No broker connection required
• Perfect for testing and development

Managing Broker Connections

View Connected Brokers

Go to Settings → Brokers to see all connected accounts:

Disconnect a Broker

Reconnect a Broker

If your OAuth token expires or is revoked:

1. Go to Settings → Brokers
2. Click Reconnect next to the broker
3. Authorize again via OAuth

Security Best Practices

Troubleshooting

Broker-Specific Limitations

Alpaca

• Market Hours: 9:30 AM - 4:00 PM ET (extended hours supported)
• Order Types: Market, Limit, Stop, Stop-Limit
• Minimum Order: $1 notional value

Interactive Brokers

• Market Hours: Varies by exchange
• Order Types: Market, Limit, Stop, Stop-Limit, Trailing Stop
• Minimum Order: No minimum

Charles Schwab

• Market Hours: 9:30 AM - 4:00 PM ET (extended hours limited)
• Order Types: Market, Limit, Stop, Stop-Limit
• Minimum Order: No minimum

Next Steps