# Your futures journal stats

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

API: Nexus.

The headline figures over a range (trades, net, fees, win rate, profit factor, expectancy, largest win and loss, points per contract, average hold, streaks), the equity curve, and the same trades split by instrument, side, hour opened, weekday, hold time and account. The Journal's futures stats, by key. Read only.

Each split carries its own trade count. A figure nothing was measured for is `null`, never `0`, next to the count it was taken over. Money is in cents and prices in index points.

```bash
curl -s "https://app.skylit.ai/api/nexus/v1/journal/futures/stats?range=7d" \
  -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 |
| --- | --- | --- | --- | --- |
| `range` | query | string | no | How far back, in futures trading days (a day runs from 6 PM ET the evening before): the last 7, 30 or 90 calendar days, the year so far, or all. Left out, `30d`. (one of `7d`, `30d`, `90d`, `ytd`, `all`; default `30d`) |
| `account` | query | string | no | Which of your futures accounts: `practice`, `agent` (your bot's), `evaluation` or `funded` (when you have exactly one running), or one of your futures account ids. `main` or `all` is every account of yours except your agent's, as the Journal shows it. Left out, that same view, or your agent's account where keys default to it; `meta.account` says which was read. `practice` or `agent` before its first order, or an id that isn't yours, answers 404 `account_not_found`. |

## Example request

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

## Responses

### 200

The read.

Three trades over a week, every account but the agent's (a local run of the route).:

```json
{
  "data": {
    "range": "7d",
    "from": "2026-11-12",
    "to": "2026-11-18",
    "trades": 3,
    "wins": 1,
    "losses": 2,
    "netCents": -4284,
    "grossCents": -3000,
    "feesCents": 1284,
    "winRatePct": 33.33333333333333,
    "profitFactor": 0.8125656282814141,
    "expectancyCents": -1428,
    "avgWinCents": 18572,
    "avgLossCents": 11428,
    "largestWinCents": 18572,
    "largestLossCents": 11428,
    "pointsPerContract": -0.5,
    "avgHoldSecs": 210,
    "maxWinStreak": 1,
    "maxLossStreak": 2,
    "currentStreak": -2,
    "equity": [
      {
        "date": "2026-11-18",
        "netCents": -4284,
        "cumCents": -4284
      }
    ],
    "bySymbol": [
      {
        "key": "NQ",
        "trades": 3,
        "wins": 1,
        "losses": 2,
        "netCents": -4284,
        "winRatePct": 33.33333333333333,
        "avgCents": -1428,
        "pointsPerContract": -0.5
      }
    ],
    "bySide": [
      {
        "key": "long",
        "trades": 2,
        "wins": 1,
        "losses": 1,
        "netCents": 7144,
        "winRatePct": 50,
        "avgCents": 3572,
        "pointsPerContract": null
      },
      {
        "key": "short",
        "trades": 1,
        "wins": 0,
        "losses": 1,
        "netCents": -11428,
        "winRatePct": 0,
        "avgCents": -11428,
        "pointsPerContract": null
      }
    ],
    "byHour": [
      {
        "key": "10",
        "trades": 3,
        "wins": 1,
        "losses": 2,
        "netCents": -4284,
        "winRatePct": 33.33333333333333,
        "avgCents": -1428,
        "pointsPerContract": null
      }
    ],
    "byWeekday": [
      {
        "key": "Wed",
        "trades": 3,
        "wins": 1,
        "losses": 2,
        "netCents": -4284,
        "winRatePct": 33.33333333333333,
        "avgCents": -1428,
        "pointsPerContract": null
      }
    ],
    "byHold": [
      {
        "key": "<1m",
        "trades": 0,
        "wins": 0,
        "losses": 0,
        "netCents": 0,
        "winRatePct": null,
        "avgCents": null,
        "pointsPerContract": null
      },
      {
        "key": "1-5m",
        "trades": 2,
        "wins": 0,
        "losses": 2,
        "netCents": -22856,
        "winRatePct": 0,
        "avgCents": -11428,
        "pointsPerContract": null
      },
      {
        "key": "5-15m",
        "trades": 1,
        "wins": 1,
        "losses": 0,
        "netCents": 18572,
        "winRatePct": 100,
        "avgCents": 18572,
        "pointsPerContract": null
      },
      {
        "key": "15-60m",
        "trades": 0,
        "wins": 0,
        "losses": 0,
        "netCents": 0,
        "winRatePct": null,
        "avgCents": null,
        "pointsPerContract": null
      },
      {
        "key": ">1h",
        "trades": 0,
        "wins": 0,
        "losses": 0,
        "netCents": 0,
        "winRatePct": null,
        "avgCents": null,
        "pointsPerContract": null
      }
    ],
    "byAccount": [
      {
        "key": "Simulated",
        "trades": 2,
        "wins": 1,
        "losses": 1,
        "netCents": 7144,
        "winRatePct": 50,
        "avgCents": 3572,
        "pointsPerContract": null
      },
      {
        "key": "50K Evaluation",
        "trades": 1,
        "wins": 0,
        "losses": 1,
        "netCents": -11428,
        "winRatePct": 0,
        "avgCents": -11428,
        "pointsPerContract": null
      }
    ]
  },
  "meta": {
    "account": "all",
    "accountId": null
  }
}
```

### 400

`bad_request`: `range` isn't one of the list.

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

`futures_access_denied`: futures aren't on for this account. Also `account_suspended`, `nexus_access_denied`.

Futures aren't on for this account.:

```json
{
  "error": {
    "code": "futures_access_denied",
    "message": "This Skylit account doesn't have simulated futures trading yet."
  }
}
```

### 404

`account_not_found`: `practice` or `agent` before its first order (a read never makes one), or an id that isn't one of your futures accounts. `user_not_found`: this Skylit account hasn't used Nexus yet.

Your bot's account before its first futures order: a read makes nothing.:

```json
{
  "error": {
    "code": "account_not_found",
    "message": "You have no agent futures account yet. The first futures order placed on it makes it."
  }
}
```

### 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."
  }
}
```

### 503

`futures_journal_unavailable`: the futures journal isn't served by key on this server.

Not on this server.:

```json
{
  "error": {
    "code": "futures_journal_unavailable",
    "message": "The futures journal isn't available through the API on this server."
  }
}
```
