GET/v1/admin/payouts/{payout}/account

The tab Account of the website's Payouts screen: where the account stands, the payout rules the request was held to, how the account traded over its whole life, how deep it went, and every other payout the trader asked for, on any account. A firm judges the fourth request of a month differently from a first one.

account, rules, statistics and risk are null when the account was removed.

Needs a firm. Our own staff name one with the Propper-Workspace header.

Request

curl "https://api.proppertrading.com/v1/admin/payouts/po_pk2jjt25cw5swbwv/account" \
  -H "Authorization: Bearer ptat_9f2c1a44_3b8e7d2f5c9a1b4e6d8f0a2c4e6b8d1f" \
  -H "Propper-Workspace: acme"

Response

{
    "data": {
        "object": "payout_account",
        "account": {
            "id": "acct_gcmnympgg8quua3k",
            "number": "PAQ4YX4NQX",
            "status": "funded",
            "currency": "USD",
            "challenge": "50K Challange",
            "size": { "value": "50000.00", "currency": "USD" },
            "phase": "Funded",
            "is_funded": true,
            "starting_balance": { "value": "50000.00", "currency": "USD" },
            "balance": { "value": "52012.60", "currency": "USD" },
            "profit": { "value": "2012.60", "currency": "USD" },
            "high_water_mark": null,
            "started_at": "2026-08-30T12:56:46+00:00"
        },
        "rules": {
            "split": 80,
            "split_from_firm": false,
            "frequency": null,
            "first_delay": null,
            "minimum": null,
            "minimum_pct": null,
            "maximum": null,
            "maximum_pct": null,
            "min_trading_days": 0
        },
        "statistics": {
            "trades": 29,
            "wins": 19,
            "losses": 10,
            "win_rate": 65.52,
            "profit_factor": 2.16,
            "avg_win": { "value": "201.00", "currency": "USD" },
            "avg_loss": { "value": "176.63", "currency": "USD" },
            "expectancy": { "value": "70.79", "currency": "USD" },
            "best_day": { "value": "974.73", "currency": "USD" },
            "worst_day": { "value": "-549.03", "currency": "USD" },
            "trading_days": 13,
            "win_days": 9,
            "longest_win_streak": 7,
            "longest_loss_streak": 2,
            "avg_duration_minutes": 12865
        },
        "risk": {
            "equity": { "value": "52012.60", "currency": "USD" },
            "max_drawdown": { "value": "3240.46", "currency": "USD" },
            "max_drawdown_pct": 6.4,
            "current_drawdown_pct": 0.44,
            "best_trade": { "value": "337.48", "currency": "USD" },
            "worst_trade": { "value": "-275.32", "currency": "USD" },
            "lots": 71.74,
            "commission": { "value": "-118.85", "currency": "USD" },
            "swap": { "value": "-1.33", "currency": "USD" }
        },
        "history": {
            "items": [],
            "total": 0,
            "paid": []
        }
    },
    "meta": {
        "request_id": "req_01m50qh60xev0xsfdp21wh8t3c"
    }
}

Field	Description
`account.size`	The size of the challenge bought
`account.high_water_mark`	The highest balance the account reached, when the firm tracks it
`rules.split`	The trader's percentage; `split_from_firm` when the phase leaves it to the firm's default
`rules.frequency`	How often a payout may be asked for, as `count` and `unit` (`hour`, `day`, `week`, `month`). Null for no limit
`rules.first_delay`	How long after funding the first payout may be asked for, the same way
`rules.minimum`, `maximum`	An amount, or with `minimum_pct` and `maximum_pct` a percentage of the profit
`statistics.win_rate`	Percent of closed trades in profit
`statistics.profit_factor`	Gross profit over gross loss. Null when nothing was lost
`statistics.avg_duration_minutes`	How long a trade was held, on average
`risk.max_drawdown_pct`	The deepest drop from a peak, from the daily snapshots
`history.items`	Up to 20 of the trader's other payouts, newest first; `same_account` for those from this account
`history.total`	How many other payouts there are
`history.paid`	What has gone out to the trader so far, per currency

Errors

Status	Code	Meaning
400	`workspace_required`	Asked by our own staff without naming a firm
401	`invalid_token`	Not a token, or the secret does not match
401	`revoked_token`	Signed out here or from another device
401	`expired_token`	Ninety days without use, or a set expiry passed
403	`admin_access_required`	This account no longer helps run the environment
403	`insufficient_scope`	This device does not hold `admin:read`
403	`workspace_not_permitted`	The `Propper-Workspace` header names an environment this account cannot act in
403	`forbidden`	Without `view_payouts`
404	`resource_not_found`	No payout with that id in this firm

A payout: the account

Request

Response

Errors