# Your season recap

`GET https://app.skylit.ai/api/nexus/v1/journal/recap`

API: Nexus.

One season (an Arc: a calendar quarter in New York time) on one of your accounts: trades, contracts, wins and losses, win rate, net P&L, profit factor, days traded, green and red days, your best and worst day, best trade, the ticker that paid most, the session that paid best on average, your longest green streak and the running net by day traded. Read only.

Left out, `arc` and `year` are the Arc in progress; one of them alone means that one with the current other. `complete` says whether the Arc has finished, so a season in progress reads as "so far".

A figure that hasn't been measured is `null`, never `0`: `winRate` with no winning or losing trade, `netPnl` when no trade has a realized P&L (`measuredTrades` is 0), `profitFactor` with no losing trade. `bestDay`, `worstDay`, `bestTrade`, `bestTicker`, `bestSession` (needs 5 trades in it) and `greenStreak` (needs 2 green days) are `null` when there is none; `curve` is `null` under two days.

`account` is `main` (your simulated wallet) or `agent` (your bot's account); `port` is one of your ports. `meta` says which account and port were read.

```bash
curl -s "https://app.skylit.ai/api/nexus/v1/journal/recap?arc=3&year=2026&account=main" \
  -H "Authorization: Bearer $SKYLIT_API_KEY"
```

## Authentication

Send your Skylit API key as a bearer token: `Authorization: Bearer <key>`. No other header is accepted.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `arc` | query | integer | no | 1 (January to March), 2 (April to June), 3 (July to September) or 4 (October to December). (min 1; max 4) |
| `year` | query | integer | no |  |
| `account` | query | string | no | Which of your accounts. Left out, your default account. (one of `main`, `agent`) |
| `port` | query | string | no | One of your port ids (GET /v1/trading/ports). An account sent beside it must agree with it. |

## Example request

```bash
curl "https://app.skylit.ai/api/nexus/v1/journal/recap" \
  -H "Authorization: Bearer $SKYLIT_API_KEY"
```

## Responses

### 200

The season on that account.

A win and a loss on two days:

```json
{
  "data": {
    "arc": 3,
    "year": 2026,
    "name": "Arc 3: Convergence",
    "theme": "Convergence",
    "startDate": "2026-07-01",
    "endDate": "2026-09-30",
    "complete": true,
    "trades": 2,
    "contracts": 2,
    "measuredTrades": 2,
    "wins": 1,
    "losses": 1,
    "breakeven": 0,
    "activeDays": 2,
    "greenDays": 1,
    "redDays": 1,
    "winRate": 50,
    "netPnl": 80,
    "profitFactor": 3,
    "bestDay": {
      "date": "2026-07-07",
      "realizedPnl": 120,
      "tradeCount": 1,
      "measuredCount": 1,
      "wins": 1,
      "losses": 0,
      "breakeven": 0
    },
    "worstDay": {
      "date": "2026-07-08",
      "realizedPnl": -40,
      "tradeCount": 1,
      "measuredCount": 1,
      "wins": 0,
      "losses": 1,
      "breakeven": 0
    },
    "bestTrade": {
      "id": "f5c3ca89-c8ba-42e9-8d9f-4f53d238d4f0",
      "ticker": "SPY",
      "date": "2026-07-07",
      "realizedPnl": 120,
      "pnlPercent": 49.3827
    },
    "bestTicker": {
      "ticker": "SPY",
      "trades": 2,
      "netPnl": 80
    },
    "bestSession": null,
    "greenStreak": null,
    "curve": [
      120,
      80
    ]
  },
  "meta": {
    "account": "main",
    "port": null
  }
}
```

No trade closed in the Arc:

```json
{
  "data": {
    "arc": 3,
    "year": 2026,
    "name": "Arc 3: Convergence",
    "theme": "Convergence",
    "startDate": "2026-07-01",
    "endDate": "2026-09-30",
    "complete": true,
    "trades": 0,
    "contracts": 0,
    "measuredTrades": 0,
    "wins": 0,
    "losses": 0,
    "breakeven": 0,
    "activeDays": 0,
    "greenDays": 0,
    "redDays": 0,
    "winRate": null,
    "netPnl": null,
    "profitFactor": null,
    "bestDay": null,
    "worstDay": null,
    "bestTrade": null,
    "bestTicker": null,
    "bestSession": null,
    "greenStreak": null,
    "curve": null
  },
  "meta": {
    "account": "agent",
    "port": "7d1c0e7e-0000-4000-8000-000000000000"
  }
}
```

### 400

`bad_request`: arc is not 1 to 4, account is not main or agent, or it does not agree with the port.

### 401

Missing or invalid key.

### 404

`port_not_found`: that port is not one of yours. `user_not_found`: this account has not used Nexus yet.
