:::endpoint 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](/docs/api/pagination) |
| `starting_after` | The `next_cursor` of the page before |

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

## Response

```json
{
    "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                                             |