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

The tab Trades of the website's Payouts screen: how the profit was made. Read only; closing a position is not offered here.

Closed trades come newest first by when they closed, open ones by when they opened. profit of an open position is at the last quote, and null when its market has no quote yet.

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

Request

Parameter	Description
`status`	`closed` (the default) or `open`
`limit`	How many, see pagination
`starting_after`	The `next_cursor` of the page before

curl "https://api.proppertrading.com/v1/admin/payouts/po_pk2jjt25cw5swbwv/trades?limit=1" \
  -H "Authorization: Bearer ptat_9f2c1a44_3b8e7d2f5c9a1b4e6d8f0a2c4e6b8d1f" \
  -H "Propper-Workspace: acme"

Response

{
    "data": [
        {
            "object": "position",
            "id": "pos_dreba4bghmf4ap5v",
            "ticket": "TK-N6OCZRJEF3",
            "symbol": "NVDA",
            "instrument": "NVIDIA Corporation",
            "digits": 2,
            "side": "buy",
            "lots": 0.64,
            "open_price": 1.09395,
            "close_price": 1.10079,
            "stop_loss": 1.09032,
            "take_profit": 1.10418,
            "swap": { "value": "-0.56", "currency": "USD" },
            "commission": { "value": "-1.11", "currency": "USD" },
            "profit": { "value": "213.55", "currency": "USD" },
            "net": { "value": "214.66", "currency": "USD" },
            "opened_at": "2026-09-23T21:10:43+00:00",
            "closed_at": "2026-10-01T01:40:34+00:00",
            "close_reason": null,
            "copied": false
        }
    ],
    "meta": {
        "request_id": "req_01m50qhe0fk6q3erkaek7my4d9",
        "has_more": true,
        "next_cursor": "MjAyNi0wOS0zMCAyMjo0NDo0OC4wMDAwMDB8cG9zX3ZtaDI3dzZ5ejI1N2Y1amo"
    }
}

Field	Description
`ticket`	The position's number on the platform
`digits`	How many decimals a price of this instrument is written with
`side`	`buy` or `sell`
`net`	`profit` less `commission`
`close_reason`	Why it closed when it was not the trader: a stop, a target, a rule
`copied`	Opened by copy trading

Errors

Status	Code	Meaning
400	`workspace_required`	Asked by our own staff without naming a firm
400	`validation_failed`	`status` is not `open` or `closed`
400	`invalid_limit`	`limit` is not a positive integer
400	`invalid_cursor`	`starting_after` is not a cursor handed out by this list
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 trades

Request

Response

Errors