---
title: "Get Signal History"
method: GET
path: "/api/signals/trades-history"
tags: ["Trade Signals"]
---

# Get Signal History

`GET /api/signals/trades-history`

## Request

- Base URL: `https://api.zerogex.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.zerogex.io/api/signals/trades-history`
- Auth: HTTP bearer

Closed-trade log with aggregate win/loss statistics.

**Params:** `limit` (1–5000, default 500).

**Returns:**
```json
{
  "portfolio_size": 1000000,
  "trades": [
    {
      "id": 421, "underlying": "SPY",
      "signal_timestamp": "...", "opened_at": "...", "closed_at": "...", "updated_at": "...",
      "status": "closed", "direction": "bullish",
      "score_at_entry": 72.1, "score_latest": 64.8,
      "option_symbol": "SPY 250425C00680000", "option_type": "call",
      "expiration": "2025-04-25", "strike": 680.0,
      "entry_price": 1.22, "current_price": 1.55,
      "quantity_initial": 10, "quantity_open": 0,
      "realized_pnl": 330.0, "unrealized_pnl": 0.0, "total_pnl": 330.0,
      "pnl_percent": 27.05,
      "pricing_mode": "debit",
      "outcome": "win"
    }
  ],
  "summary": {
    "total_trades": 120, "wins": 72, "losses": 44,
    "win_rate": 0.6, "total_pnl": 12450.32
  }
}
```

- `portfolio_size` — from `SIGNALS_PORTFOLIO_SIZE` env var.
- `outcome` — `"win"` (pnl > 0), `"loss"` (pnl < 0), or `"flat"`.
- `pricing_mode` — `"debit"` (held long: entry = premium paid, exit = sale
  proceeds) or `"credit"` (held short: entry = premium received, exit =
  buyback cost). Drives PnL sign and frontend labelling.
- `win_rate` — 4-decimal fraction; `null` when no trades exist.
- `score_at_entry` / `score_latest` — MSI composite values (0–100).

**Page design.** Stats header strip (win rate, total P&L, counts);
sortable/filterable trades table; equity-curve sparkline from cumulative `total_pnl`.

## Query parameters

- `limit` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zerogex/apis/zerogex-api.md) · [All operations](https://skmtc.dev/zerogex/apis/zerogex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zerogex/apis/zerogex-api/revisions/753b26bf0592?raw)