# Read one trade

`GET https://app.skylit.ai/api/nexus/v1/trades/{id}`

API: Nexus.

One of your options or stock trades, or one of your test orders (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 |
| --- | --- | --- | --- | --- |
| `id` | path | string (uuid) | yes | The trade's id, from the open or the list. |

## Example request

```bash
curl "https://app.skylit.ai/api/nexus/v1/trades/6f1c2a4e-8b1d-4c39-9a51-2d7e0b3c9f10" \
  -H "Authorization: Bearer $SKYLIT_API_KEY"
```

## Responses

### 200

The trade.

A closed trade.:

```json
{
  "data": {
    "id": "6f1c2a4e-8b1d-4c39-9a51-2d7e0b3c9f10",
    "ticker": "SPY",
    "strike": 600,
    "expiration": "2026-10-16",
    "direction": "call",
    "assetClass": "options",
    "averageEntryPrice": 1.84,
    "totalQuantity": 2,
    "remainingQuantity": 0,
    "status": "closed",
    "entryDate": "2026-10-09T14:32:05Z",
    "exitDate": "2026-10-09T15:20:02Z",
    "exits": [
      {
        "id": "f6a7b8c9-d0e1-4f2a-9b3c-5d6e7f809102",
        "price": 2.1,
        "quantity": 1,
        "date": "2026-10-09T15:05:41Z",
        "type": "partial",
        "orderType": "market"
      },
      {
        "id": "07b8c9d0-e1f2-4a3b-8c4d-6e7f80910213",
        "price": 2.25,
        "quantity": 1,
        "date": "2026-10-09T15:20:02Z",
        "type": "full",
        "orderType": "market"
      }
    ],
    "source": "api"
  }
}
```

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

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