# Your futures trading behaviour

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

API: Nexus.

Where your expectancy comes from, how the previous trade changes the next one, whether size and adding to a loser work, a daily stop what-if, and how far trades went for and against you per instrument (medians, trades with a recorded path only). The Journal's futures behaviour panel, by key. Read only.

Every bucket carries its trade count, empty ones included. 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/behaviour?range=7d&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 |
| --- | --- | --- | --- | --- |
| `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/behaviour" \
  -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,
    "expectancy": {
      "trades": 3,
      "winRatePct": 33.33333333333333,
      "avgWinCents": 18572,
      "avgLossCents": 11428,
      "winShareCents": 6190,
      "lossShareCents": 7618,
      "feesPerTradeCents": 428,
      "grossPerTradeCents": -1000,
      "netPerTradeCents": -1428,
      "breakevenWinRatePct": 38.093333333333334
    },
    "afterPrevious": [
      {
        "key": "first of the day",
        "trades": 2,
        "wins": 1,
        "losses": 1,
        "netCents": 7144,
        "winRatePct": 50,
        "avgCents": 3572,
        "pointsPerContract": null
      },
      {
        "key": "after a win or scratch",
        "trades": 1,
        "wins": 0,
        "losses": 1,
        "netCents": -11428,
        "winRatePct": 0,
        "avgCents": -11428,
        "pointsPerContract": null
      },
      {
        "key": "after a loss",
        "trades": 0,
        "wins": 0,
        "losses": 0,
        "netCents": 0,
        "winRatePct": null,
        "avgCents": null,
        "pointsPerContract": null
      },
      {
        "key": "within 5m of a loss",
        "trades": 0,
        "wins": 0,
        "losses": 0,
        "netCents": 0,
        "winRatePct": null,
        "avgCents": null,
        "pointsPerContract": null
      }
    ],
    "sizing": [
      {
        "key": "NQ 1",
        "trades": 3,
        "wins": 1,
        "losses": 2,
        "netCents": -4284,
        "winRatePct": 33.33333333333333,
        "avgCents": -1428,
        "pointsPerContract": -0.5
      }
    ],
    "averaging": [
      {
        "key": "one entry",
        "trades": 3,
        "wins": 1,
        "losses": 2,
        "netCents": -4284,
        "winRatePct": 33.33333333333333,
        "avgCents": -1428,
        "pointsPerContract": null
      },
      {
        "key": "added while winning",
        "trades": 0,
        "wins": 0,
        "losses": 0,
        "netCents": 0,
        "winRatePct": null,
        "avgCents": null,
        "pointsPerContract": null
      },
      {
        "key": "added to a loser",
        "trades": 0,
        "wins": 0,
        "losses": 0,
        "netCents": 0,
        "winRatePct": null,
        "avgCents": null,
        "pointsPerContract": null
      }
    ],
    "dailyStop": {
      "sessions": 2,
      "actualNetCents": -4284,
      "worstDrawdownCents": 11428,
      "rows": [
        {
          "stopCents": 10000,
          "netCents": -4284,
          "deltaCents": 0,
          "daysStopped": 0,
          "tradesSkipped": 0
        },
        {
          "stopCents": 20000,
          "netCents": -4284,
          "deltaCents": 0,
          "daysStopped": 0,
          "tradesSkipped": 0
        }
      ]
    },
    "excursions": [
      {
        "root": "NQ",
        "trades": 3,
        "medianBestPoints": 0,
        "medianWorstPoints": -5.5,
        "medianExitPoints": -5.5,
        "medianGivebackPoints": 5.5,
        "wentGreenClosedRed": 0,
        "winners": 1,
        "winnersMedianWorstPoints": 0,
        "losers": 2,
        "losersMedianBestPoints": 0
      }
    ]
  },
  "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."
  }
}
```
