# Read one trading day

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

API: Nexus.

One trading day on one of your own accounts: the day's figures, the cash curve through the day and every trade that closed that day. Read only, and only yours.

- `date` is the trading day in New York time (`YYYY-MM-DD`). Left out, it is today there. A date that isn't a day, or a day after today, answers `400 bad_request`.
- A trade belongs to the day it closed (an expired one to the day it expired).
- A day with nothing closed is a `200` with `stats: null` and empty `trades`. It is never a row of zeros. A day with no cash move at all also has `netChange: null` and empty `cashPoints`.
- `startingBalance` is the account's cash before the day began. `cashPoints` are the day's cash moves in time order, each with the balance after it. `netChange` is the last balance less `startingBalance`, so open and close cash moves both count: a day with only an open has `stats: null` and a `netChange`.
- `stats` is the day's closed trades with the journal's own rules: counts, `winRate`, `netPnl`, `avgWin`, `avgLoss`, `profitFactor`, `bestTrade` and `worstTrade`. A figure that wasn't measured is `null`, never `0`.
- Closed spreads on your Main account count here as one closed position each, and show as one row with `direction: "spread"`, `strike: 0` and no percent fields. The Bot and your ports never hold a spread.
- `meta` says which account and port were read. Beta: the shape may still grow new fields.

```bash
curl -s "https://app.skylit.ai/api/nexus/v1/journal/daily?date=2026-11-16&account=agent" \
  -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 |
| --- | --- | --- | --- | --- |
| `account` | query | string | no | `main` (your own simulated wallet, the default) or `agent` (your bot's). (one of `main`, `agent`) |
| `port` | query | string (uuid) | no | One of your ports (see Ports in the Nexus Trades guide), by id. `account`, if you send it too, must agree: `agent` (or left out) for Bot and an extra port, left out for Main. Left out, `account` alone decides. |
| `date` | query | string (date) | no | The trading day, `YYYY-MM-DD`, New York time. Left out, today. |

## Example request

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

## Responses

### 200

The day.

A day with nothing closed.:

```json
{
  "data": {
    "date": "2026-11-13",
    "timezone": "America/New_York",
    "stats": null,
    "startingBalance": 100017,
    "netChange": null,
    "cashPoints": [],
    "trades": []
  },
  "meta": {
    "account": "agent",
    "port": null
  }
}
```

### 400

Code: `bad_request`. `account`, `range`, `by` or `month` isn't one of the allowed values, `account` doesn't agree with `port`, or Main was sent to `agent/edge`. The message says which.

A range that isn't allowed.:

```json
{
  "error": {
    "code": "bad_request",
    "message": "range must be one of 7d, 30d, 90d, ytd, all."
  }
}
```

### 401

No key, or a key that isn't valid. Codes: `missing_api_key`, `invalid_api_key`.

No key sent.:

```json
{
  "error": {
    "code": "missing_api_key",
    "message": "Send your Skylit API key in the Authorization header: Authorization: Bearer YOUR_SKYLIT_API_KEY."
  }
}
```

### 403

The key works but this can't be done. Codes: `feature_disabled` (ports are switched off on the server: leave `port` out), `account_suspended`, `nexus_access_denied`.

Ports are switched off on the server.:

```json
{
  "error": {
    "code": "feature_disabled",
    "message": "Ports aren't open to members yet."
  }
}
```

### 404

Codes: `port_not_found` (no live port with that id on your account), `user_not_found` (this Skylit account hasn't used Nexus yet, so it has no journal).

Not one of your ports.:

```json
{
  "error": {
    "code": "port_not_found",
    "message": "No port with that id on your account."
  }
}
```

### 429

Over a rate limit. Wait `Retry-After` seconds, then retry. Codes: `rate_limited`, and `stream_limit_reached` (too many live streams open: 3 per key, 6 per account).

Headers: `Retry-After`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`.

Too many writes from this key.:

```json
{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests (limit 30). Slow down and retry in 12 seconds."
  }
}
```

### 500

Something went wrong on our side. If you sent a `clientOrderId`, retry with the same one. Code: `internal_error`.

Retry with the same clientOrderId.:

```json
{
  "error": {
    "code": "internal_error",
    "message": "Something went wrong on our side. If you sent a clientOrderId, retry with the same one (it can't fill twice). Otherwise check your account before retrying."
  }
}
```
