Skip to main content

Order Enhancements

Additional order management capabilities.
EndpointMethodDescriptionStatus
/v1/order/{id}/modifyPOSTModify orderPlanned
/v1/order/close-positionPOSTClose positionPlanned
/v1/order/previewPOSTPreview orderPlanned

Modify Existing Orders

Current Workaround: Cancel the order and place a new one. Phase 2: Modify price or quantity without losing queue position.
POST /v1/order/{order_id}/modify
Content-Type: application/json

{
  "price": 0.58,
  "quantity": 150
}

Close Position

Current Workaround: Calculate position size and place opposing order. Phase 2: One-click position close at market price.
POST /v1/order/close-position
Content-Type: application/json

{
  "instrument_id": "inst_abc123",
  "execution_type": "market"  // or "limit"
}

Order Preview

Current Workaround: Calculate manually based on order book. Phase 2: Estimate fill price and fees before placing order.
POST /v1/order/preview
Content-Type: application/json

{
  "instrument_id": "inst_abc123",
  "side": "buy",
  "type": "market",
  "quantity": 100
}

Analytics & History

P&L calculations and historical data.
EndpointMethodDescriptionStatus
/v1/user-pnlGETP&L calculationPlanned
/v1/user-pnl/position-cost-basisGETCost basisPlanned
/v1/portfolio/activitiesGETActivity historyPlanned
/v1/price-historyGETHistorical OHLCPlanned

P&L Calculations

Current Workaround: Track fills client-side and calculate manually. Phase 2: Automatic realized and unrealized P&L.
GET /v1/user-pnl?timeframe=24h
Response:
{
  "realized_pnl": 45.50,
  "unrealized_pnl": 12.30,
  "total_pnl": 57.80,
  "win_rate": 0.65,
  "total_trades": 150
}

Position Cost Basis

Current Workaround: Track entry prices and quantities manually. Phase 2: Detailed cost basis per position with FIFO/LIFO support.
GET /v1/user-pnl/position-cost-basis/{instrument_id}

Activity History

Current Workaround: Track order fills via WebSocket and store locally. Phase 2: Complete activity feed with all account actions.
GET /v1/portfolio/activities?start_date=2026-01-01&end_date=2026-01-31

Historical Prices

Current Workaround: Use external data sources or store WebSocket data. Phase 2: OHLC candlestick data for technical analysis.
GET /v1/price-history/{instrument_id}?interval=1h&start=2026-01-01

Discovery Enhancements

Improved market discovery and navigation.
EndpointMethodDescriptionStatus
/v1/eventsGETList eventsPlanned
/v1/events/{id}GETGet eventPlanned
/v1/searchGETSearchPlanned
/v1/seriesGETList seriesPlanned
/v1/tagsGETList tagsPlanned
/v1/sportsGETSports listPlanned
/v1/sports/teamsGETTeams listPlanned

Events

Current Workaround: Browse instruments and group by metadata. Phase 2: Get all instruments for a specific event.
GET /v1/events?category=sports&status=active
Current Workaround: List all instruments and filter client-side. Phase 2: Full-text search across instruments.
GET /v1/search?q=bitcoin+price+prediction

Series & Tags

Current Workaround: Filter instruments by category. Phase 2: Browse by series (NFL, NBA, Presidential Elections, etc.) and tags.
GET /v1/series/nfl
GET /v1/tags/cryptocurrency

WebSocket Enhancements

Increased limits and additional subscriptions.

Increased Limits

LimitMVPPhase 2 Target
Connections per API key15
Subscriptions per connection10100

Order Execution Updates

Current Workaround: Poll /v1/orders/open endpoint. Phase 2: Real-time order status updates via WebSocket.
{
  "type": "order_update",
  "order_id": "ord_xyz789",
  "status": "filled",
  "filled_quantity": 100,
  "average_price": 0.625
}

Portfolio Change Notifications

Current Workaround: Poll /v1/portfolio/positions endpoint. Phase 2: Real-time position and balance updates.
{
  "type": "position_update",
  "instrument_id": "inst_abc123",
  "quantity": 150,
  "unrealized_pnl": 10.50
}

Prioritization

Features will be prioritized based on:
  1. User demand - Most requested features ship first
  2. Trading volume - Features that enable higher volume
  3. Technical complexity - Simpler features may ship sooner
  4. Resource availability - Engineering capacity