# List your ports

`GET https://app.skylit.ai/api/nexus/v1/trading/ports`

API: Nexus.

Your live ports, Main and Bot first, and the limits that apply to them.

- Money here is in dollars, not cents: `cashBalance: 24100` is $24,100.00.
- `account` is what to send beside the port on an order or a read: `agent` for Bot and every extra port, `null` for Main (send it with `account` left out).
- Read `limits` instead of hard-coding them.

If ports are ever switched off on the server, this answers `403 feature_disabled`. It counts as a read.

## 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/trading/ports" \
  -H "Authorization: Bearer $SKYLIT_API_KEY"
```

## Responses

### 200

Your ports and the limits.

Main, Bot and one extra port.:

```json
{
  "data": {
    "ports": [
      {
        "id": "0b6f3c1e-2a4d-4e8f-9b1a-7c5d3e2f1a01",
        "name": "Main",
        "kind": "main",
        "startingCash": 100000,
        "isDefault": false,
        "isHandDefault": true,
        "ranked": true,
        "rankedSince": "2026-11-04T15:00:00Z",
        "cooldownUntil": null,
        "resetCount": 0,
        "lastResetAt": null,
        "createdAt": "2026-11-04T15:00:00Z",
        "cashBalance": 101240.5,
        "realizedPnl": 1240.5,
        "openCount": 2,
        "restingOrders": 0,
        "account": null
      },
      {
        "id": "4d2a9e7b-1c3f-4a5e-8d6b-2f1e0a9c8b02",
        "name": "Bot",
        "kind": "bot",
        "startingCash": 100000,
        "isDefault": true,
        "isHandDefault": false,
        "ranked": false,
        "rankedSince": null,
        "cooldownUntil": null,
        "resetCount": 0,
        "lastResetAt": null,
        "createdAt": "2026-11-04T15:00:00Z",
        "cashBalance": 99271,
        "realizedPnl": 124,
        "openCount": 2,
        "restingOrders": 1,
        "account": "agent"
      },
      {
        "id": "9e8d7c6b-5a4f-4e3d-a2c1-0b9a8f7e6d03",
        "name": "Swing",
        "kind": "extra",
        "startingCash": 25000,
        "isDefault": false,
        "isHandDefault": false,
        "ranked": false,
        "rankedSince": null,
        "cooldownUntil": null,
        "resetCount": 0,
        "lastResetAt": null,
        "createdAt": "2026-11-12T14:31:00Z",
        "cashBalance": 24100,
        "realizedPnl": 0,
        "openCount": 1,
        "restingOrders": 0,
        "account": "agent"
      }
    ],
    "limits": {
      "maxPorts": 5,
      "startingCashChoices": [
        10000,
        25000,
        50000,
        100000,
        250000
      ],
      "rankedCooldownDays": 7,
      "rankedStartingCash": 100000,
      "maxNameLength": 32
    }
  }
}
```

### 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 this can't be done. Codes: `feature_disabled` (ports are switched off on the server: leave `port` out), `account_suspended`, `nexus_access_denied`.

Ports are switched off on the server.:

```json
{
  "error": {
    "code": "feature_disabled",
    "message": "Ports aren't open to members yet."
  }
}
```

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