---
updatedAt: 2026-05-03T17:38:24.000Z
agentTools:
  projectIndex: https://docs.clearstreet.io/studio/llms.txt
---

# List account PNL details

List PNL details for a given account. This includes cash positions.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Risk & Margin API",
    "description": "API for Studio's Risk Management System.",
    "version": "2.0.0"
  },
  "x-readme": {
    "explorer-enabled": false
  },
  "servers": [
    {
      "url": "https://api.clearstreet.io/studio/v2",
      "description": "Production environment"
    },
    {
      "url": "https://demo-api.clearstreet.io/studio/v2",
      "description": "Demo environment"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "paths": {
    "/accounts/{account_id}/pnl-details": {
      "get": {
        "operationId": "listPnlDetails",
        "summary": "List account PNL details",
        "description": "List PNL details for a given account. This includes cash positions.",
        "tags": [
          "PNL"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "account_id",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/PnlDetails/properties/account_id",
              "description": "The account ID or account number to list PNL details for."
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Account PNL details",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PnlDetails"
                      }
                    }
                  },
                  "required": [
                    "data"
                  ]
                }
              }
            }
          },
          "default": {
            "$ref": "#/paths/~1entities~1%7Bentity_id%7D~1margin~1pm/get/responses/default"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    },
    "schemas": {
      "PnlSummary": {
        "type": "object",
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64",
            "minimum": 1710613560668,
            "maximum": 2900000000000,
            "description": "Milliseconds since epoch."
          },
          "entity_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "example": "100000",
            "description": "Entity ID for the legal entity."
          },
          "sod_equity": {
            "type": "number",
            "format": "double",
            "description": "Net value of instruments held in the portfolio at the start of a trading day."
          },
          "equity": {
            "type": "number",
            "format": "double",
            "description": "Net value of instruments held in the portfolio."
          },
          "sod_gross_market_value": {
            "type": "number",
            "format": "double",
            "description": "Absolute market value at the start of a trading day."
          },
          "gross_market_value": {
            "type": "number",
            "format": "double",
            "description": "Absolute market value of long and short market values."
          },
          "net_market_value": {
            "type": "number",
            "format": "double",
            "description": "Market value net of long and short market values."
          },
          "long_market_value": {
            "type": "number",
            "format": "double",
            "description": "Market value of securities positioned long."
          },
          "short_market_value": {
            "type": "number",
            "format": "double",
            "description": "Market value of securities positioned short."
          },
          "sod_long_market_value": {
            "type": "number",
            "format": "double",
            "description": "Market value of securities positioned long at the start of a trading day."
          },
          "sod_short_market_value": {
            "type": "number",
            "format": "double",
            "description": "Market value of securities positioned short at the start of a trading day."
          },
          "overnight_pnl": {
            "type": "number",
            "format": "double",
            "description": "Profit and loss from previous trading date."
          },
          "day_pnl": {
            "type": "number",
            "format": "double",
            "description": "Profit and loss from intraday trading activities."
          },
          "realized_pnl": {
            "type": "number",
            "format": "double",
            "description": "Profit and loss realized from position closing trading activity"
          },
          "unrealized_pnl": {
            "type": "number",
            "format": "double",
            "description": "Profit and loss from market changes."
          },
          "total_pnl": {
            "type": "number",
            "format": "double",
            "description": "`realized_pnl + unrealized_pnl`\n"
          },
          "net_pnl": {
            "type": "number",
            "format": "double",
            "description": "`total_pnl + total_fees`\n"
          },
          "total_fees": {
            "type": "number",
            "format": "double",
            "description": "Total fees incurred from trading activities."
          }
        },
        "required": [
          "timestamp",
          "entity_id",
          "sod_equity",
          "equity",
          "sod_gross_market_value",
          "gross_market_value",
          "net_market_value",
          "long_market_value",
          "short_market_value",
          "sod_long_market_value",
          "sod_short_market_value",
          "overnight_pnl",
          "day_pnl",
          "realized_pnl",
          "unrealized_pnl",
          "total_pnl",
          "net_pnl",
          "total_fees"
        ]
      },
      "PnlDetails": {
        "properties": {
          "timestamp": {
            "$ref": "#/components/schemas/PnlSummary/properties/timestamp"
          },
          "entity_id": {
            "$ref": "#/components/schemas/PnlSummary/properties/entity_id",
            "description": "Name of the legal entity."
          },
          "account_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "example": "100000",
            "description": "Account ID for the account."
          },
          "account_number": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "example": "ACC0001",
            "description": "Account number for the account."
          },
          "symbol": {
            "type": "string",
            "minLength": 1,
            "maxLength": 32,
            "example": "AAPL"
          },
          "symbol_description": {
            "type": "string",
            "description": "Description of the symbol."
          },
          "asset_class": {
            "type": "string",
            "enum": [
              "other",
              "currency",
              "equity",
              "option",
              "debt",
              "fund",
              "swap",
              "fx",
              "future",
              "crypto",
              "cash_and_equivalent"
            ],
            "description": "The asset class of the symbol."
          },
          "day_pnl": {
            "type": "number",
            "format": "double",
            "description": "Profit and loss from intraday trading activities."
          },
          "unrealized_pnl": {
            "type": "number",
            "format": "double",
            "description": "Profit and loss from market changes."
          },
          "realized_pnl": {
            "type": "number",
            "format": "double",
            "description": "Profit and loss realized from position closing trading activity."
          },
          "total_pnl": {
            "type": "number",
            "format": "double",
            "description": "`realized_pnl + unrealized_pnl`\n"
          },
          "overnight_pnl": {
            "type": "number",
            "format": "double",
            "description": "Profit and loss from previous trading date."
          },
          "total_fees": {
            "type": "number",
            "format": "double",
            "description": "Total fees incurred from trading activities."
          },
          "net_market_value": {
            "type": "number",
            "format": "double",
            "description": "Market value net of long and short market values."
          },
          "gross_market_value": {
            "type": "number",
            "format": "double",
            "description": "Absolute market value of long and short market values."
          },
          "sod_market_value": {
            "type": "number",
            "format": "double",
            "description": "Market value of a given instrument a the start of a trading day."
          },
          "quantity": {
            "type": "string",
            "minLength": 1,
            "maxLength": 16,
            "example": "100",
            "description": "String representation of quantity."
          },
          "sod_quantity": {
            "$ref": "#/components/schemas/PnlDetails/properties/quantity",
            "description": "Quantity of a given instrument at the start of a trading day."
          },
          "bought_quantity": {
            "$ref": "#/components/schemas/PnlDetails/properties/quantity",
            "description": "Quantity of a given instrument bought."
          },
          "sold_quantity": {
            "$ref": "#/components/schemas/PnlDetails/properties/quantity",
            "description": "Quantity of a given instrument sold."
          },
          "buys": {
            "type": "integer",
            "format": "int32",
            "description": "Total buys of a given instrument."
          },
          "sells": {
            "type": "integer",
            "format": "int32",
            "description": "Total sells of a given instrument."
          },
          "price": {
            "type": "number",
            "format": "double",
            "description": "Price used in this pnl calculation."
          },
          "sod_price": {
            "type": "number",
            "format": "double",
            "description": "Price at the start of a trading day."
          },
          "underlier": {
            "$ref": "#/components/schemas/PnlDetails/properties/symbol",
            "description": "The underlying instrument."
          }
        },
        "required": [
          "timestamp",
          "entity_id",
          "entity_name",
          "account_id",
          "account_number",
          "side",
          "symbol",
          "symbol_description",
          "asset_class",
          "day_pnl",
          "unrealized_pnl",
          "realized_pnl",
          "total_pnl",
          "overnight_pnl",
          "total_fees",
          "net_market_value",
          "gross_market_value",
          "sod_market_value",
          "quantity",
          "sod_quantity",
          "bought_quantity",
          "sold_quantity",
          "buys",
          "sells",
          "price",
          "sod_price",
          "underlier"
        ]
      }
    }
  }
}
```