# Your futures trades for a month

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

API: Nexus.

Every futures trade (flat to flat) closed in a month of futures trading days, newest first, with each day's result and the month's totals. The Journal's futures trade list, by key. Read only: it never makes an account.

`winRatePct`, `profitFactor`, `avgWinCents` and `avgLossCents` are `null` when there is nothing to divide by. 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. `tripId` opens one trade in full.

```bash
curl -s "https://app.skylit.ai/api/nexus/v1/journal/futures/trades?month=2026-11" \
  -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 |
| --- | --- | --- | --- | --- |
| `month` | query | string | no | `YYYY-MM`. Left out, the current month. |
| `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/trades" \
  -H "Authorization: Bearer $SKYLIT_API_KEY"
```

## Responses

### 200

The read.

Two practice trades and one evaluation trade, every account but the agent's (a local run of the route).:

```json
{
  "data": {
    "month": "2026-11",
    "days": [
      {
        "date": "2026-11-18",
        "netCents": -4284,
        "trades": 3,
        "wins": 1,
        "losses": 2
      }
    ],
    "trades": [
      {
        "accountId": "f838643a-3df7-4d5d-9f81-c64c728f55d3",
        "accountName": "50K Evaluation",
        "symbol": "NQZ26",
        "side": "long",
        "maxQty": 1,
        "contracts": 1,
        "openedAt": "2026-11-18T15:38:00Z",
        "closedAt": "2026-11-18T15:39:30Z",
        "tradingDay": "2026-11-18",
        "grossCents": -11000,
        "feesCents": 428,
        "netCents": -11428,
        "scaleIns": 0,
        "addedToLoser": false,
        "tripId": "cb6f0fe2-33a5-431a-a4de-3daefb8464b6",
        "bestPoints": 0,
        "worstPoints": -5.5
      },
      {
        "accountId": "0ae1a37d-27d1-4f0e-9c34-a2e0096b76af",
        "accountName": "Simulated",
        "symbol": "NQZ26",
        "side": "short",
        "maxQty": 1,
        "contracts": 1,
        "openedAt": "2026-11-18T15:25:00Z",
        "closedAt": "2026-11-18T15:28:00Z",
        "tradingDay": "2026-11-18",
        "grossCents": -11000,
        "feesCents": 428,
        "netCents": -11428,
        "scaleIns": 0,
        "addedToLoser": false,
        "tripId": "70aa6ea0-4095-4793-bc79-8395f8f17d47",
        "bestPoints": 0,
        "worstPoints": -5.5
      },
      {
        "accountId": "0ae1a37d-27d1-4f0e-9c34-a2e0096b76af",
        "accountName": "Simulated",
        "symbol": "NQZ26",
        "side": "long",
        "maxQty": 1,
        "contracts": 1,
        "openedAt": "2026-11-18T15:09:00Z",
        "closedAt": "2026-11-18T15:15:00Z",
        "tradingDay": "2026-11-18",
        "grossCents": 19000,
        "feesCents": 428,
        "netCents": 18572,
        "scaleIns": 0,
        "addedToLoser": false,
        "tripId": "c4289874-0921-40a5-817d-e533fabb3fef",
        "bestPoints": 9.5,
        "worstPoints": 0
      }
    ],
    "netCents": -4284,
    "tradeCount": 3,
    "wins": 1,
    "losses": 2,
    "winRatePct": 33.33333333333333,
    "grossWinCents": 18572,
    "grossLossCents": 22856,
    "profitFactor": 0.8125656282814141,
    "avgWinCents": 18572,
    "avgLossCents": 11428
  },
  "meta": {
    "account": "all",
    "accountId": null
  }
}
```

### 400

`bad_request`: `month` isn't `YYYY-MM`.

A month that doesn't exist.:

```json
{
  "error": {
    "code": "bad_request",
    "message": "Month must be YYYY-MM."
  }
}
```

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