API Reference

Portfolio & Users

All endpoints require authentication.

Get Your Profile

GET /v1/users/me

{
  "data": {
    "id": "87299673-...",
    "wallet_address": "Dc5tRex7r3EYi7HVNNjr3FkfhytDksWFtT1CLjgVYCSU",
    "display_name": null,
    "usdc_balance": "89.500000",
    "created_at": "2026-03-17T08:00:00Z",
    "last_active_at": "2026-03-18T09:15:00Z"
  }
}

Get Your Balance

GET /v1/users/me/balance

{
  "data": {
    "usdc_balance": "89.500000",
    "locked_in_positions": "10.500000",
    "total": "100.000000"
  }
}

Get Your Positions

GET /v1/users/me/positions

Returns all open positions across active markets.

{
  "data": [
    {
      "market_id": "8166597e-...",
      "symbol": "LYNUSDT",
      "exchange": "binance",
      "side": "yes",
      "shares": "13.698630",
      "avg_price": "0.730000",
      "current_price": "0.742000",
      "unrealized_pnl": "0.164384",
      "settlement_ts": "2026-03-18T01:00:00Z"
    }
  ]
}

Get Your Trade History

GET /v1/users/me/history?limit=20&page=1

{
  "data": [
    {
      "trade_id": "a1b2c3d4-...",
      "market_id": "8166597e-...",
      "side": "yes",
      "shares": "13.698630",
      "price_usdc": "0.730000",
      "fee_usdc": "0.100000",
      "created_at": "2026-03-18T09:15:32Z"
    }
  ]
}

Full Portfolio Overview

GET /v1/portfolio

Returns positions, P&L summary, and win rate.

{
  "data": {
    "total_pnl": "27.50",
    "win_rate": "0.72",
    "total_trades": 18,
    "open_positions": 3,
    "positions": [ ... ]
  }
}