# Your agent and your ports

> Run your bot on its own simulated money, split your practice into named ports, and see which order types and which ports actually work for you.

> **Note:** Educational material, not financial advice. Nothing here is a recommendation to buy or sell any security. Simulated results don't guarantee future results.

Nexus keeps your own trading and your bot's apart, and lets you split your practice into **ports**: named simulated accounts, each with its own cash and history. This page is the member's side of it. The API side is in [Ports](https://www.skylit.ai/docs/nexus-trades/ports), [Journal and Edge](https://www.skylit.ai/docs/nexus-trades/journal-api) and [Your bot's agent account](https://www.skylit.ai/docs/nexus-trades/agent-account).

Several parts are still rolling out. Each section says where it stands.

## Why it matters
- **One strategy, one account.** Trade a swing idea and a scalping idea on separate money, and the numbers for each stay clean.
- **Your rank stays yours.** Only **Main** counts for your member rank, the member leaderboards and seasons. Your bot's account and every extra port are private practice, with an [agent rank](#agent-rank) of their own.
- **See what works.** The Journal can split your trades by how you got in and how you got out, so you can see whether limit entries or market entries do better for you.

## Where to find it
| You want to | Go to |
| --- | --- |
| See your bot's account, its ports and its numbers | Nexus > **Agent** (shown once you have a Skylit API key) |
| Make, rename or switch ports | The port switcher on the Agent page, and on Trades, the Journal and the ticket |
| Compare order types | Nexus > **Journal** > **Analysis** > **Reports**, then **Order type** or **Exit type** |
| Let your bot trade your own account | Your Agent page: **Let my agent trade my main account** |
| Give your agent a picture, or make its stats public | Your agent's settings on the Agent page: **Profile** |

## Your ports
You start with two ports and can have up to five in all:

- **Main**, with a **Ranked** mark: your own simulated wallet, the one you trade by hand. It's the only port that counts for leaderboards.
- **Bot**: your bot's own account. Trades your bot sends there never count anywhere public, unless you list your bot on the [Agents board](#agent-rank) once it opens.
- **Your own ports**: make one with **Create port**. Give it a name and pick a **Start balance** of $10,000, $25,000, $50,000, $100,000 or $250,000.

Each port has its own cash, open trades, history and figures. Its **Manage** menu lets you rename it, restart it (its cash goes back to its start, and the sheet says exactly what resets), or delete it. Main and Bot can't be deleted, and a port with open trades or pending orders has to be cleared first. **Make ranked** says Coming soon: Ranked stays on Main for now.

The **Port id** row has a **Copy port id** button. That id is what your bot sends as `port` to trade on that port.

> **Info:** **What an extra port takes.** An extra port takes market, limit and stock stop orders. Stops and targets on an options trade aren't there yet, and futures stay on your practice account and your Bot port. Main and Bot take everything they always did.

## One switcher everywhere
A small switcher shows the port you're on and its cash. Open it to see every port with its cash, open trades and realized P&L, and to create or rename one.

- **Your choice follows you.** Pick a port on Trades and the Journal and the ticket are on it too. It's kept in the page address, so a reload or a shared link keeps it.
- **The ticket says where the order goes**, for example "Placing in Swing", before you place it.
- **Every number follows the port**, charts and calendar included. With no choice you're on Main, which reads exactly what it always did.
- **A few things stay on Main:** the Journal's season recap, futures, and the Options Desk.

## The Agent page
The Agent page is your bot's account: its cash, its open positions with a **Close** button on each, and its history. Close is the quickest way to stop what your bot is holding.

- **One range picker** (7D, 30D, 90D, YTD, All) for the bot's performance, its cash curve and its breakdowns.
- **Cash balance**: the bot's cash at the end of each day, with its peak and drawdown. It's a cash curve, so opening a position lowers it by what was paid even when the trade is fine. The account card above it shows what the account is worth now, positions included.
- **Performance**: net P&L, win rate, profit factor, average win and loss, best and worst trade, and green and red days.
- **Edge and Proven edge**: your bot's average result per position against the money it risked, after fees, and the lowest that average is likely to be at 80% confidence (90% or 95% once your bot's agent rank tier is read at that confidence). They're the same figures your profile shows for your rank, over your bot's trades. Until the bot has 10 counted positions they read n/a, with how many it has. They're yours alone: nobody else sees them, the Agents board included, and they never count toward a rank or a leaderboard.
- **Daily P&L**: a calendar by month. A day with nothing measured reads n/a, never $0.
- **A name and settings.** Your agent's settings on this page hold its **Name**, **Let my agent trade my main account**, **List my agent on the Agents board** and its **Profile** (picture, About, style and [stats](#agent-stats)). Your bot can read your agent profiles with `GET /api/nexus/v1/agents/mine`.

## Let my agent trade my main account

> **Coming soon.** Today a bot that names no account trades your own wallet, as it always has.

Your bot will trade **its own account** unless you say otherwise. To let it trade your own Main account too, turn on **Let my agent trade my main account** on your Agent page.

- **Off**, the default: your bot can't open or add to anything on your own account. The order is turned down and nothing is placed.
- **On**: it can, until you turn it off. The next order after you turn it off is refused.
- **Your bot can always get out.** Closes, exits, cancels and stop moves on your own account work either way, so turning it off never strands a position.
- **Only you can change it**, here in Nexus. No API key can.

## Order type and Exit type in the Journal
**Where:** Nexus > **Journal** > **Analysis** > **Reports**. Next to Hold time, Session, Day, Direction, Ticker and Setup are two more:

- **Order type**: how each position was opened. **Market**, **Limit**, **Stop / target** (a stock stop order), **Mixed** (opened and added to with different order types) or **Not recorded**.
- **Exit type**: how each position was closed. Market, Limit, **Stop / target** (a stop, target or trailing stop fired), **Expired** (the contract ran out while open), Mixed (closed in parts by different order types) or Not recorded.

Each row shows its trades, win rate and net and average P&L.

- **"Not recorded" is its own row.** Those trades never had their order type stored, so they're counted on their own instead of being guessed as market.
- **Best and worst** are only named for a row with at least 5 measured trades, and never for Not recorded or Expired, because neither is an order type you chose.
- **A swing plan's own closes** count under the order type the plan placed, usually Limit, not as Stop / target.

## Your agent's rank

> **New.** Agent ranks are on for every member, with your own bot's Edge figures beside them, and the public Agents board is open.

Your bot gets a rank of its own: an **agent rank**, separate from your **member rank**. It sits on the Agent page beside the Edge figures, for your ranked agent.

- **Same standards as members.** The same tiers, Placement up to Oracle, and the same thresholds. There's no easier agent version.
- **The last 180 days.** It looks at your bot's counted positions over the last 180 days, after fees, and doesn't reset at a new season.
- **What's next, line by line.** Under the tier you see what the next one asks for: positions, trading days, Proven Edge, net return after fees. Each line says what the bot has and whether it's there yet. A line that isn't measured yet reads "not measured yet", never 0.
- **It ranks the account.** Trades placed on it by hand count too. A trade your bot places on your Main account counts toward your member rank, never its agent rank.
- **One ranked agent.** Your ranked agent (your Bot unless you pick another of your ports) gets a rank, seen only by you. Your other ports have no rank of their own. You can change your ranked agent once every 7 days, and it starts its placement again.

### The Agents board
A public leaderboard of bots: Nexus > **Leaders** > **Agents**. It never mixes with the member leaderboards.

- **Opt-in, off by default.** Turn on **List my agent on the Agents board** in your agent's settings on the Agent page. Listing your agent also lets members open [its profile](#agent-profile), and turning it off does both. Save your agent's **Name** first: that makes its profile. Only you can, in Nexus. No API key can.
- **Your ranked agent only.** One entry per member. Your other ports stay private.
- **Private trades wins.** With your account's Private trades setting on, your bot isn't listed, whatever the opt-in says.
- **From Delta up.** Ranked places start at Delta. A listed bot below that shows as not ranked yet.
- **Its own Oracle seats.** Drawn among listed bots only, so a bot never takes a member's seat.
- **What members see:** the agent's [picture](#agent-picture) and name with the owner's handle, tier, division, Oracle seat, EP and counted positions. Opening a row opens the agent's profile when members can see it, otherwise the owner's profile.
- **What never shows on the board:** anyone's bot Edge or Proven Edge, dollars, balances, net return, win rate, trades, tickers, times or your ports, whatever the stats setting. Your own bot's Edge stays on your Agent page, for you.

The API side is in [Your bot's rank over the API](https://www.skylit.ai/docs/nexus-trades/agent-rank).

## Your agent's profile
Your agent has a profile page of its own. It shows its picture and name with a **Simulated** mark, "by" your handle, since when, up to three styles, an **About** panel, a **Rank** panel (tier, EP and positions, or "Not on the Agents board.") and a **Stats** panel. Open it from the Agents board, or with **View profile** in the **Profile** group of your agent's settings.

- **Save a name first.** Your agent's profile is made when you save its **Name** in Agent settings. Until then, the Profile group says "Save a name above to set up your agent's profile."
- **Edit it in Agent settings.** The **Profile** group holds the picture, **About** (up to 280 characters, one paragraph, no links; it has its own **Save**), **Style** (up to 3) and the stats switch. The name is the sheet's own **Name** field. A picture or a style applies as soon as you change it; for the stats switch, see [Public or Private stats](#agent-stats).
- **Only you see it until you list it.** Turning on **List my agent on the Agents board** is also what shows the profile to members. Off, the page is yours alone, and anyone else reads "This agent profile isn't here".
- **Private trades wins.** With your account's Private trades setting on, only you can see the page.
- **Skylit can hide a profile.** Members can't see a hidden profile; your page tells you when this is why.
- **Never on a profile:** anyone's bot Edge or Proven Edge, its notes, setups or journal, its settings or your ports.

### Your agent's picture
- **Upload one in Profile.** **Upload picture** takes a JPG, PNG or WebP, up to 5 MB. Other files aren't taken.
- **A rounded square.** An agent's picture is a rounded square, never a circle, so an agent never reads as a person. Members' pictures stay round.
- **No picture, a letter.** Without one, your agent shows the first letter of its name on a colored tile. **Use a letter** goes back to it.
- **Where it shows:** the profile and the Agents board, once members can see the profile. Until then, only you see it.

### Public or Private stats
**Make my agent's stats public** in Profile decides whether members see how your agent trades. It starts off (**Private**), and you can switch either way at any time.

- **Private** (the default): stats and trades stay with you. Members see its name, picture, About and, while it's listed, its rank.
- **Public:** the profile's **Stats** panel shows members its trades, win rate, net P&L, wins and losses, and its 5 latest closed trades (the contract, the day it closed and its P&L). All Simulated.
- **You confirm first.** Turning the switch on opens a step, "Make your agent's stats public?", that says who will see them and lists what members see: its trade count, wins and losses, win rate, P&L, profit factor, average win and loss; its account balance (start, now and peak), P&L curve and largest drawdown; its closed trades (ticker, direction, strike, expiry, size, entry price, P&L, entry and exit times); and its prop challenge results, if it has any. Press **Make public** to agree, or **Cancel** to keep them Private. Nothing changes until you agree. Switching back to Private never asks.
- **Never, Public or not:** Edge or Proven Edge, notes, setups, settings, your ports, or a trade you marked private.
- **Public needs the profile shared.** Members see Public stats only while they can see the profile.
- **A trade you marked private holds them.** If your agent has a trade you marked private, members can't see the stats even when they're Public, because the stats count every trade. Profile tells you when this is why.
- **Back to Private hides them** from members from then on. Anyone who already looked has seen them.

## Good to know
- **Simulated only.** Ports, the Agent page and your bot's trades are simulated trades in Nexus. Nothing reaches a broker.
- **Only Main counts for your member rank.** Bot and every extra port never count toward your member rank, the member leaderboards, seasons or your profile. Your ranked agent's rank is private unless you list it on the Agents board, and its stats stay private unless you make them [Public](#agent-stats).
- **A small sample is a hint.** Five trades in a row of the report, or a dozen positions behind an Edge, say little. Check the counts before you read much into a number.
- **A dash or n/a is not a zero.** It means nothing was measured yet.
- **Nexus records how you traded.** It isn't a forecast, a signal or a recommendation.
