# One futures trade in full

`GET https://app.skylit.ai/api/nexus/v1/journal/futures/trips/{id}`

API: Nexus.

One of your futures trades: its fills, the path price took while it was open, and how far that went for and against you, in points per contract from the average entry. Read only.

`closedAt`, `avgExitPrice`, `exitPoints` and `givebackPoints` are `null` while it is open. Someone else's trade answers 404 `trip_not_found`, the same as one that doesn't exist.

```bash
curl -s "https://app.skylit.ai/api/nexus/v1/journal/futures/trips/cb6f0fe2-33a5-431a-a4de-3daefb8464b6" \
  -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 |
| --- | --- | --- | --- | --- |
| `id` | path | string (uuid) | yes | The trade's `tripId` (from `GET /api/nexus/v1/journal/futures/trades`). |

## Example request

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

## Responses

### 200

The read.

A 5.5 point loser on an evaluation (a local run of the route).:

```json
{
  "data": {
    "id": "cb6f0fe2-33a5-431a-a4de-3daefb8464b6",
    "accountId": "f838643a-3df7-4d5d-9f81-c64c728f55d3",
    "accountName": "50K Evaluation",
    "symbol": "NQZ26",
    "root": "NQ",
    "side": "long",
    "openedAt": "2026-11-18T15:38:00Z",
    "closedAt": "2026-11-18T15:39:30Z",
    "maxQty": 1,
    "contracts": 1,
    "avgEntryPrice": 25332.75,
    "avgExitPrice": 25327.25,
    "highPrice": 25332.75,
    "highAt": "2026-11-18T15:38:00Z",
    "lowPrice": 25327.25,
    "lowAt": "2026-11-18T15:39:30Z",
    "bestPoints": 0,
    "worstPoints": -5.5,
    "exitPoints": -5.5,
    "givebackPoints": 5.5,
    "pointValueCents": 2000,
    "tickSize": 0.25,
    "grossCents": -11000,
    "feesCents": 428,
    "netCents": -11428,
    "fills": [
      {
        "at": "2026-11-18T15:38:00Z",
        "side": "buy",
        "qty": 1,
        "opening": true,
        "price": 25332.75,
        "role": "entry",
        "orderType": "market",
        "commissionCents": 214,
        "stopPrice": null
      },
      {
        "at": "2026-11-18T15:39:30Z",
        "side": "sell",
        "qty": 1,
        "opening": false,
        "price": 25327.25,
        "role": "entry",
        "orderType": "market",
        "commissionCents": 214,
        "stopPrice": null
      }
    ],
    "path": [
      {
        "at": "2026-11-18T15:38:00Z",
        "price": 25332.75
      },
      {
        "at": "2026-11-18T15:39:30Z",
        "price": 25327.25
      }
    ],
    "note": ""
  }
}
```

### 400

`bad_request`: the id isn't a UUID.

Not a UUID.:

```json
{
  "error": {
    "code": "bad_request",
    "message": "The trade id must be a UUID (tripId in GET /api/nexus/v1/journal/futures/trades)."
  }
}
```

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

`trip_not_found`: not one of your trades. `user_not_found`: this Skylit account hasn't used Nexus yet.

Not one of your trades.:

```json
{
  "error": {
    "code": "trip_not_found",
    "message": "No futures trade with that id on your account."
  }
}
```

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