Get Portfolio History

$ clear-street v1:accounts get-portfolio-history

GET/v1/accounts/{account_id}/portfolio-history

Retrieves daily portfolio history for the specified account.

ParametersExpand Collapse

--account-id: number

Account identifier

--start-date: string

Start date for the portfolio history range, in YYYY-MM-DD format.

--end-date: optional string

Defaults to today in America/New_York when omitted.

ReturnsExpand Collapse

V1AccountGetPortfolioHistoryResponse: BaseResponse { metadata, error }

data: object { segments }

segments: array of PortfolioHistorySegment { date, eod_equity, realized_pnl, 7 more }

date: string

The date for this segment

eod_equity: string

The equity at the end of the trading day.

realized_pnl: string

Sum of the profit and loss realized from position closing trading activity.

sod_equity: string

The equity at the start of the trading day.

unrealized_pnl: string

Sum of the profit and loss from market changes.

bought_notional: optional string

Amount bought MTM

day_pnl: optional string

Sum of the profit and loss from intraday trading activities for the trading day.

net_pnl: optional string

P&L after netting all realized and unrealized P&L, adjustments, dividends, change in accruals, income and expenses

position_pnl: optional string

P&L attributable to start-of-day (carried) positions from market movement during this trading day.

sold_notional: optional string

Amount sold MTM

Get Portfolio History

clear-street v1:accounts get-portfolio-history \
  --api-key 'My API Key' \
  --account-id 0 \
  --start-date "'2019-12-27'"

{
  "data": {
    "segments": [
      {
        "bought_notional": "39800.00",
        "date": "2026-04-15",
        "day_pnl": "850.25",
        "eod_equity": "100850.25",
        "net_pnl": "850.25",
        "position_pnl": "-350.25",
        "realized_pnl": "1200.50",
        "sod_equity": "100000.00",
        "sold_notional": "42500.00",
        "unrealized_pnl": "-350.25"
      }
    ]
  },
  "error": null,
  "metadata": {
    "request_id": "f076d6f6-10c9-42a0-98c5-18cebc427e80"
  }
}

{
  "data": {
    "segments": [
      {
        "bought_notional": null,
        "date": "2026-05-12",
        "day_pnl": null,
        "eod_equity": "100009.00",
        "net_pnl": null,
        "position_pnl": null,
        "realized_pnl": "12.00",
        "sod_equity": "100000.00",
        "sold_notional": null,
        "unrealized_pnl": "-3.00"
      }
    ]
  },
  "error": {
    "code": 500,
    "message": "upstream calc-engine returned an error"
  },
  "metadata": {
    "request_id": "2f3d7b0a-1111-4a4b-9e1f-8c4e5d3a9f12"
  }
}

{
  "error": {
    "code": 403,
    "message": "The caller does not have permission to execute the specified operation"
  },
  "metadata": {
    "request_id": "5518f0c6-58ff-4b4a-81a5-701556d41206"
  }
}

Returns Examples

{
  "data": {
    "segments": [
      {
        "bought_notional": "39800.00",
        "date": "2026-04-15",
        "day_pnl": "850.25",
        "eod_equity": "100850.25",
        "net_pnl": "850.25",
        "position_pnl": "-350.25",
        "realized_pnl": "1200.50",
        "sod_equity": "100000.00",
        "sold_notional": "42500.00",
        "unrealized_pnl": "-350.25"
      }
    ]
  },
  "error": null,
  "metadata": {
    "request_id": "f076d6f6-10c9-42a0-98c5-18cebc427e80"
  }
}

{
  "data": {
    "segments": [
      {
        "bought_notional": null,
        "date": "2026-05-12",
        "day_pnl": null,
        "eod_equity": "100009.00",
        "net_pnl": null,
        "position_pnl": null,
        "realized_pnl": "12.00",
        "sod_equity": "100000.00",
        "sold_notional": null,
        "unrealized_pnl": "-3.00"
      }
    ]
  },
  "error": {
    "code": 500,
    "message": "upstream calc-engine returned an error"
  },
  "metadata": {
    "request_id": "2f3d7b0a-1111-4a4b-9e1f-8c4e5d3a9f12"
  }
}

{
  "error": {
    "code": 403,
    "message": "The caller does not have permission to execute the specified operation"
  },
  "metadata": {
    "request_id": "5518f0c6-58ff-4b4a-81a5-701556d41206"
  }
}