# One futures account's history

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

API: Nexus.

Everything that happened to one account, oldest first: started, daily lock, failed, passed, funded, payout, reset. Read only.

`equityCents` is `null` when it wasn't measured (a reset with an open position that had no price).

```bash
curl -s "https://app.skylit.ai/api/nexus/v1/journal/futures/events?account=evaluation" \
  -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 | One of your futures accounts: `practice` (`main` means the same), `agent`, `evaluation`, `funded`, or one of your account ids. Left out, `practice`, or your agent's account where keys default to it. `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/events" \
  -H "Authorization: Bearer $SKYLIT_API_KEY"
```

## Responses

### 200

The read.

A new evaluation (a local run of the route).:

```json
{
  "data": {
    "events": [
      {
        "event": "started",
        "reason": null,
        "balanceCents": 5000000,
        "equityCents": 5000000,
        "at": "2026-11-18T15:09:00Z"
      }
    ]
  },
  "meta": {
    "account": "f838643a-3df7-4d5d-9f81-c64c728f55d3",
    "accountId": "f838643a-3df7-4d5d-9f81-c64c728f55d3"
  }
}
```

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