# List the trades you passed on

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

API: Nexus.

The trades you saw and chose not to take, with your reasons, as in your Journal. Oldest first.

- Send `month`, or `from` and `to` (`YYYY-MM-DD`, at most 400 days apart), not both. Left out, this month in New York.
- A range you passed on nothing in is `entries: []`. A field you didn't fill in is `null`.
- `reasonChips` at the top lists every quick reason there is; each entry's `reasonChips` are the ones you picked.
- Passed trades are yours as a member: `account=agent` or any `port` answers `400 bad_request`.
- Read only. `503 unavailable` when passed trades aren't on this server right now.

```bash
curl -s "https://app.skylit.ai/api/nexus/v1/journal/passed?month=2025-06" \
  -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 | Leave it out, or send `main`. This is yours as a member, not an account's: `agent` answers `400 bad_request`, and so does `port`. (one of `main`) |
| `month` | query | string | no | `YYYY-MM`. Send this, or `from` and `to`, not both. Left out with no `from` and `to`, this month in New York. |
| `from` | query | string (date) | no | First day, `YYYY-MM-DD`. Send with `to`. |
| `to` | query | string (date) | no | Last day, `YYYY-MM-DD`, at most 400 days after `from`. |

## Example request

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

## Responses

### 200

The passed trades.

A real answer: one stock pass in June 2025, no price or outcome noted.:

```json
{
  "data": {
    "enabled": true,
    "entries": [
      {
        "id": "1077f9e1-04bd-4283-8a9c-30dca968451d",
        "day": "2025-06-10",
        "occurredAt": "2025-06-10T13:30:00Z",
        "time": "09:30",
        "assetClass": "stock",
        "ticker": "SPY",
        "direction": "long",
        "strike": null,
        "expiration": null,
        "contract": null,
        "price": null,
        "reasonChips": [
          "late"
        ],
        "reason": "Chased it.",
        "outcome": null,
        "wouldHaveWorked": null,
        "createdAt": "2026-11-19T03:37:46Z",
        "updatedAt": "2026-11-19T03:37:46Z"
      }
    ],
    "from": "2025-06-01",
    "reasonChips": [
      "plan",
      "late",
      "risk",
      "hesitated",
      "news",
      "daily_limit",
      "other"
    ],
    "to": "2025-06-30"
  },
  "meta": {
    "account": "main",
    "port": null
  }
}
```

### 400

Code: `bad_request`. `account=agent` or a `port` was sent (notes and passed trades are yours as a member, not an account's), `account` is something else, or `month`, `day`, `from` or `to` isn't a valid date. The message says which.

account=agent or a port.:

```json
{
  "error": {
    "code": "bad_request",
    "message": "Notes and passed trades are kept per member, not per account or port. Leave account and port out (or send \"account\": \"main\")."
  }
}
```

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

The key works but the account can't do this. Codes: `account_suspended`, `nexus_access_denied`, `futures_access_denied`.

The account doesn't include Nexus.:

```json
{
  "error": {
    "code": "nexus_access_denied",
    "message": "This Skylit account doesn't include Nexus, so it can't place Nexus trades."
  }
}
```

### 404

Code: `user_not_found`. This Skylit account hasn't used Nexus yet, so there's nothing to read.

No Nexus account yet.:

```json
{
  "error": {
    "code": "user_not_found",
    "message": "This Skylit account hasn't used Nexus yet, so it has no 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

Try again in a moment (honour `Retry-After` when it's sent). Codes: `stale_quote` (the quote, or a stock's last trade, is more than 15 seconds old, so nothing filled), `no_live_price`, `rules_pending`, `unavailable`, `auth_unavailable`, `access_check_unavailable`, `api_keys_unavailable`, `trades_api_disabled`, `stream_unavailable` (the live stream isn't on, or the server is restarting: try again shortly, or poll the reads).

Headers: `Retry-After`.

No live price right now.:

```json
{
  "error": {
    "code": "no_live_price",
    "message": "There's no live price for this contract right now, so nothing was filled. Try again in a moment."
  }
}
```
