> ## Documentation Index
> Fetch the complete documentation index at: https://developer.9squid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Investor Portfolio Reports

> Fetch current holdings, trade history, tranche performance metrics, and pool analytics in one call.

<Steps>
  <Step title="Fetch Holdings">
    Returns all tranches you currently hold with quantity and tranche details.

    <CodeGroup>
      ```bash cURL theme={null}
      curl https://api.9squid.com/v1/api/investor/portfolio \
        -H "Authorization: Bearer <your_token>"
      ```

      ```json Response theme={null}
      {
        "success": true,
        "data": [
          {
            "trade_id": "clxtr001",
            "tranche_id": "clxtranche01",
            "tranche_name": "Senior A",
            "deal_id": "clxdeal001",
            "allocated_quantity": 500000,
            "price": 98.5,
            "settlement_date": "2026-03-01T00:00:00Z",
            "status": "SETTLED"
          }
        ]
      }
      ```
    </CodeGroup>
  </Step>

  <Step title="Portfolio Summary">
    Aggregated totals across all your holdings — useful for a dashboard view.

    <CodeGroup>
      ```bash cURL theme={null}
      curl https://api.9squid.com/v1/api/investor/portfolio/summary \
        -H "Authorization: Bearer <your_token>"
      ```

      ```json Response theme={null}
      {
        "success": true,
        "data": {
          "total_invested": 2500000,
          "total_holdings": 4,
          "active_deals": 2,
          "settled_trades": 3,
          "pending_trades": 1
        }
      }
      ```
    </CodeGroup>
  </Step>

  <Step title="Full Portfolio Report">
    All data in one call: holdings, trade history, tranche performance, and pool metrics from the latest completed ALM job.

    > `tranche_performance` and `pool_metrics` are populated from the latest completed ALM calculation job. If no job has completed for a deal, those arrays will be empty for that deal.

    <CodeGroup>
      ```bash cURL theme={null}
      curl https://api.9squid.com/v1/api/investor/portfolio/reports \
        -H "Authorization: Bearer <your_token>"
      ```

      ```json Response theme={null}
      {
        "success": true,
        "data": {
          "holdings": [
            {
              "trade_id": "clxtr001",
              "tranche_name": "Senior A",
              "allocated_quantity": 500000,
              "status": "SETTLED"
            }
          ],
          "trade_history": [
            {
              "trade_id": "clxtr001",
              "quantity": 500000,
              "price": 98.5,
              "trade_date": "2026-02-28T14:00:00Z",
              "status": "SETTLED"
            }
          ],
          "tranche_performance": [
            {
              "tranche_id": "clxtranche01",
              "tranche_name": "Senior A",
              "deal_id": "clxdeal001",
              "metrics": {}
            }
          ],
          "pool_metrics": [
            {
              "deal_id": "clxdeal001",
              "metrics": {}
            }
          ]
        }
      }
      ```
    </CodeGroup>
  </Step>
</Steps>