PropExecutor
API reference

Traders

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

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/tradersPlannedscope · accounts:read
curl
curl "https://api.propexecutor.com/v1/traders?limit=100" \
  -H "Authorization: Bearer $PFX_KEY"
iduuid
Use this when assigning an account.
namestring | null
Whatever you called them.
emailstring
Unique within your organization.
account_countinteger
How many trading accounts they currently hold.
created_attimestamp
When you created the record.

Create a trader

POST/v1/tradersPlannedscope · accounts:write
curl
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 cost credits.

Read one trader

GET/v1/traders/{id}Plannedscope · 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}Plannedscope · 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 — that is the call that actually revokes the old holder’s sessions.

Trader summary

GET/v1/traders/{id}/summaryPlannedscope · 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
{
  "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"
}
PreviousExecutor credentialsNextAccount types