# Your evaluation history

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

API: Nexus.

Your evaluations by calendar quarter in New York time (started, passed, blown, daily locks, challenges that ended, pass rate), how many are running, and the 20 most recent events. Read only.

`passRatePct` is `null` for a quarter in which no evaluation ended. A quarter counts what happened in it: an evaluation started in March and blown in April is started in Q1 and blown in Q2.

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

## Authentication

Send your Skylit API key as a bearer token: `Authorization: Bearer <key>`. No other header is accepted.

## Example request

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

## Responses

### 200

The read.

One evaluation running, none ended yet (a local run of the route).:

```json
{
  "data": {
    "quarters": [
      {
        "quarter": "2026-Q4",
        "started": 1,
        "passed": 0,
        "blown": 0,
        "dailyLocks": 0,
        "challengeEnded": 0,
        "passRatePct": null
      }
    ],
    "totals": {
      "quarter": "all",
      "started": 1,
      "passed": 0,
      "blown": 0,
      "dailyLocks": 0,
      "challengeEnded": 0,
      "passRatePct": null
    },
    "active": 1,
    "recent": []
  }
}
```

### 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

`user_not_found`: this Skylit account hasn't used Nexus yet.

A key whose account never used Nexus.:

```json
{
  "error": {
    "code": "user_not_found",
    "message": "This Skylit account hasn't used Nexus yet, so it has no futures journal."
  }
}
```

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