API Reference

Trading API

GET /api/trading/execute

Retrieves the current trading state.

Response:

{
  "cash": 2000.0,
  "holdings": {},
  "trades": [],
  "totalTrades": 0,
  "winningTrades": 0,
  "portfolioValue": 2000.0
}

POST /api/trading/execute

Executes a trade or syncs state.

Request Body:

{
  "action": "execute_trade",
  "market": {
    "id": "token-address",
    "symbol": "TOKEN",
    "name": "Token Name",
    "price": 0.001,
    "type": "trenches"
  },
  "trade": {
    "timestamp": "12:34:56",
    "action": "BUY",
    "symbol": "TOKEN",
    "name": "Token Name",
    "amount": 1000,
    "price": 0.001,
    "tradeValue": 1.0
  }
}

Response:

{
  "cash": 1999.0,
  "holdings": {
    "token-address": {
      "amount": 1000,
      "avgPrice": 0.001,
      "entryTime": 1234567890,
      "positionType": "long"
    }
  },
  "trades": [...],
  "totalTrades": 1,
  "winningTrades": 0,
  "portfolioValue": 2000.0
}

DELETE /api/trading/execute

Clears the trading state and resets to default.

Response:

{
  "success": true,
  "message": "Trading state cleared. State will reset to default on next load.",
  "defaultState": {
    "cash": 2000.0,
    "holdings": {},
    "trades": [],
    "totalTrades": 0,
    "winningTrades": 0,
    "portfolioValue": 2000.0
  }
}

Dashboard API

GET /api/dashboard/trenches

Fetches latest token profiles from DexScreener.

Response:

{
  "tokens": [
    {
      "tokenAddress": "0x...",
      "name": "Token Name",
      "symbol": "TOKEN",
      "priceUsd": 0.001,
      "volume24h": 100000
    }
  ]
}

GET /api/dashboard/polymarket

Fetches active Polymarket markets.

Response:

{
  "markets": [
    {
      "id": "market-id",
      "question": "Market question?",
      "volume24hr": 50000,
      "outcomePrices": ["0.6", "0.4"]
    }
  ]
}

GET /api/dashboard/hyperliquid

Fetches Hyperliquid perpetuals data.

Response:

{
  "BTC": {
    "markPrice": 45000,
    "funding": 0.0001,
    "openInterest": 1000000,
    "priceChange24h": 2.5
  }
}

Chat API

POST /api/chat

Sends a message to SeraphineOS and receives a response.

Request Body:

{
  "message": "What's the current trend in pump.fun tokens?",
  "conversationHistory": []
}

Response:

{
  "response": "Based on current market data...",
  "conversationHistory": [...]
}

Backrooms API

GET /api/backrooms/reflect

Retrieves all reflections.

Response:

[
  {
    "id": "1234567890",
    "timestamp": "2024-01-01T12:00:00Z",
    "content": "Reflection text...",
    "tradesAnalyzed": 10
  }
]

POST /api/backrooms/reflect

Generates a new reflection.

Request Body:

{
  "trades": [...]
}

Response:

{
  "reflection": {
    "id": "1234567890",
    "timestamp": "2024-01-01T12:00:00Z",
    "content": "Reflection text...",
    "tradesAnalyzed": 10
  }
}

---