# Traders

> Create and read the trader records your accounts are attached to, and their performance across every account they hold.

Source: https://www.propexecutor.com/docs/traders
Whole reference in one file: https://www.propexecutor.com/doc.md

A trader record is a name and an email you create so an account and its credentials have somewhere to hang. It is not a login — a trader has no account with us, no password and no way in.

> **Why this is only a record**
> Recruiting traders, vetting them, taking their evaluation fee and paying out their profits all happen in your systems. We run the executor and manage the accounts on it. So this endpoint exists to give an account an owner you recognise, not to model a person.

## List traders

`GET /v1/traders` · **Planned** · scope `accounts:read`

<!-- curl -->
```bash
curl "https://api.propexecutor.com/v1/traders?limit=100" \
  -H "Authorization: Bearer $PFX_KEY"
```

| Field | Type | Description |
| --- | --- | --- |
| `id` | uuid | Use this when assigning an account. |
| `name` | string \| null | Whatever you called them. |
| `email` | string | Unique within your organization. |
| `account_count` | integer | How many trading accounts they currently hold. |
| `created_at` | timestamp | When you created the record. |

## Create a trader

`POST /v1/traders` · **Planned** · scope `accounts:write`

<!-- curl -->
```bash
curl -X POST https://api.propexecutor.com/v1/traders \
  -H "Authorization: Bearer $PFX_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Jordan Ellis","email":"jordan@example.com"}'
```

Sends no email and creates no login. Costs nothing — traders are free, only [accounts](https://www.propexecutor.com/docs/limits) cost credits.

## Read one trader

`GET /v1/traders/{id}` · **Planned** · scope `accounts:read`

The record plus every account they hold, with each account’s status and current equity — which is the view most firms want on a trader’s profile page.

## Correct a trader

`PATCH /v1/traders/{id}` · **Planned** · scope `accounts:write`

Name and email only, for a typo or a change of address. It does not move accounts: to change who holds an account, reassign the account [by its number](https://www.propexecutor.com/docs/accounts#assign) — that is the call that actually revokes the old holder’s sessions.

## Trader summary

`GET /v1/traders/{id}/summary` · **Planned** · scope `accounts:read`

Aggregate performance across every account this trader has ever held — how many passed, how many breached, and their net result. What a firm looks at before scaling someone up.

<!-- 200 OK -->
```json
{
  "trader_id": "3d21…",
  "accounts": { "total": 4, "active": 1, "passed": 2, "breached": 1, "archived": 0 },
  "pass_rate": 0.5,
  "net_realized_pnl": 3120.44,
  "best_account": { "account": 10000042, "gain": 0.118 },
  "first_account_at": "2026-04-02T10:05:00Z"
}
```