# Read one futures order

`GET https://app.skylit.ai/api/nexus/v1/trading/accounts/{account}/orders/{orderId}`

API: Nexus.

One order as it stands now, with its bracket. An order is looked up in the named account only, so the right id on the wrong account answers `404 order_not_found`. A futures test order's id answers with the test order, marked `"test": true`.

## 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` | path | string | yes | `practice`, `evaluation` or `funded` (when you have exactly one running), or a futures account id from capabilities. |
| `orderId` | path | string (uuid) | yes | The order's id, from the open, the working list or the history. |

## Example request

```bash
curl "https://app.skylit.ai/api/nexus/v1/trading/accounts/practice/orders/b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e" \
  -H "Authorization: Bearer $SKYLIT_API_KEY"
```

## Responses

### 200

The order.

A filled limit entry, its stop and target now working.:

```json
{
  "data": {
    "id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
    "assetClass": "futures",
    "source": "api",
    "account": {
      "id": "8d7c6b5a-4e3f-4a2b-9c1d-0e1f2a3b4c5d",
      "kind": "evaluation",
      "name": "50K Evaluation"
    },
    "symbol": "NQZ26",
    "side": "buy",
    "quantity": 1,
    "role": "entry",
    "orderType": "limit",
    "status": "filled",
    "limitPrice": 25300,
    "fillPrice": 25300,
    "placedAt": "2026-10-09T14:36:00Z",
    "filledAt": "2026-10-09T14:41:17Z",
    "keyId": "key_3f9a1c",
    "commissionCents": 214,
    "realizedPnlCents": 0,
    "bracket": [
      {
        "id": "c3d4e5f6-a7b8-4c9d-8e0f-2a3b4c5d6e7f",
        "assetClass": "futures",
        "source": "api",
        "account": {
          "id": "8d7c6b5a-4e3f-4a2b-9c1d-0e1f2a3b4c5d",
          "kind": "evaluation",
          "name": "50K Evaluation"
        },
        "symbol": "NQZ26",
        "side": "sell",
        "quantity": 1,
        "role": "stop_loss",
        "orderType": "stop",
        "status": "working",
        "stopPrice": 25280,
        "placedAt": "2026-10-09T14:36:00Z",
        "parentId": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e"
      },
      {
        "id": "d4e5f6a7-b8c9-4d0e-9f1a-3b4c5d6e7f80",
        "assetClass": "futures",
        "source": "api",
        "account": {
          "id": "8d7c6b5a-4e3f-4a2b-9c1d-0e1f2a3b4c5d",
          "kind": "evaluation",
          "name": "50K Evaluation"
        },
        "symbol": "NQZ26",
        "side": "sell",
        "quantity": 1,
        "role": "take_profit",
        "orderType": "limit",
        "status": "working",
        "limitPrice": 25340,
        "placedAt": "2026-10-09T14:36:00Z",
        "parentId": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e"
      }
    ]
  }
}
```

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

Not on your account. Codes: `trade_not_found`, `account_not_found`, `order_not_found`.

Not your trade, or no such trade.:

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

### 429

Over a rate limit. Wait `Retry-After` seconds, then retry. Code: `rate_limited`.

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

### 503

Try again in a moment (honour `Retry-After` when it's sent). Codes: `stale_quote`, `no_live_price`, `rules_pending`, `unavailable`, `auth_unavailable`, `access_check_unavailable`, `api_keys_unavailable`, `trades_api_disabled`.

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