# List your agent profiles

`GET https://app.skylit.ai/api/nexus/v1/agents/mine`

API: Nexus.

Your own agent profiles, as you see them in Nexus: name, link, picture, bio, strategy tags and who can see them. Read only: create, rename and visibility changes stay in the app.

- If agent profiles are ever switched off, it answers `404 not_found`, whatever you send.
- A member with no agent yet gets `agents: []`. `avatarUrl` and `bio` are `null` until you set them, never `""`.
- Profiles are yours as a member: sending `account` or `port` answers `400 bad_request`.
- There is no `meta` on this answer.

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

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

## Responses

### 200

Your agent profiles.

A real answer: one agent, everything private.:

```json
{
  "data": {
    "agents": [
      {
        "id": "cc9ae041-f2bc-4120-8393-80a521062f7c",
        "name": "Quillfeather",
        "slug": "quillfeather",
        "avatarUrl": null,
        "bio": null,
        "strategyTags": [],
        "visibility": "private",
        "visibleToMembers": false,
        "privateTrades": false,
        "hidden": false,
        "slugLocked": false,
        "statsVisibility": "private",
        "statsVisibleToMembers": false,
        "statsHeldByPrivateTrades": false,
        "createdAt": "2026-11-19T03:38:14.302509Z",
        "updatedAt": "2026-11-19T03:38:14.302509Z"
      }
    ],
    "tags": [
      "momentum",
      "mean-reversion",
      "breakout",
      "trend",
      "scalping",
      "swing",
      "options",
      "futures",
      "stocks",
      "volatility",
      "news",
      "levels"
    ]
  }
}
```

A real answer: no agent yet.:

```json
{
  "data": {
    "agents": [],
    "tags": [
      "momentum",
      "mean-reversion",
      "breakout",
      "trend",
      "scalping",
      "swing",
      "options",
      "futures",
      "stocks",
      "volatility",
      "news",
      "levels"
    ]
  }
}
```

### 400

Code: `bad_request`. `account` or `port` was sent: your agent profiles are yours as a member.

account or port sent.:

```json
{
  "error": {
    "code": "bad_request",
    "message": "Your agent profiles are kept per member, not per account or port. Leave account and port out."
  }
}
```

### 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: `not_found`. Agent profiles are switched off, or this Skylit account hasn't used Nexus. It answers this before anything else, whatever you sent.

Not open to you yet.:

```json
{
  "error": {
    "code": "not_found",
    "message": "No agent has that link."
  }
}
```

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