> ## 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

The portfolio endpoints give investors a full picture of their holdings — current positions, trade history, tranche performance, and underlying pool metrics. This recipe shows how to fetch each layer of data.

## Overview

```
1. GET /investor/portfolio              → list current holdings (positions)
2. GET /investor/portfolio/summary      → aggregate totals across all holdings
3. GET /investor/portfolio/reports      → full report: holdings + trades + performance + pool metrics
```

***

## Step 1 — Fetch Your Holdings

Returns a list of all tranches you currently hold, with quantity and tranche details.

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

**Response**

```json 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"
    }
  ]
}
```

***

## Step 2 — View Portfolio Summary

Aggregated totals across all your holdings — useful for a dashboard view.

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

**Response**

```json theme={null}
{
  "success": true,
  "data": {
    "total_invested": 2500000,
    "total_holdings": 4,
    "active_deals": 2,
    "settled_trades": 3,
    "pending_trades": 1
  }
}
```

***

## Step 3 — Pull Full Portfolio Reports

The reports endpoint returns all data in one call: your holdings, trade history, tranche-level performance analytics, and pool-level metrics from the latest completed calculation job.

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

**Response**

```json theme={null}
{
  "success": true,
  "data": {
    "holdings": [
      {
        "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"
      }
    ],
    "trade_history": [
      {
        "trade_id": "clxtr001",
        "tranche_id": "clxtranche01",
        "quantity": 500000,
        "price": 98.5,
        "trade_date": "2026-02-28T14:00:00Z",
        "settlement_date": "2026-03-01T00:00:00Z",
        "status": "SETTLED"
      }
    ],
    "tranche_performance": [
      {
        "tranche_id": "clxtranche01",
        "tranche_name": "Senior A",
        "deal_id": "clxdeal001",
        "metrics": { }
      }
    ],
    "pool_metrics": [
      {
        "deal_id": "clxdeal001",
        "metrics": { }
      }
    ]
  }
}
```

> `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.

***

## Exploring the Deal Marketplace

Before investing, browse available deals on the marketplace:

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

Returns all deals currently open for investment with tranche details and pricing.

***

## What's Next

* [ALM Analytics](/api-reference/originator-analytics/analyticscontroller_runalmanalysis) — run duration, convexity, and stress tests on a specific deal
* [Webhooks](/workflows/webhooks) — subscribe to real-time events for trade settlements and deal updates
* [API Reference — Investor Portfolio](/api-reference/investor-portfolio/portfoliocontroller_getreports) — full schema for all portfolio endpoints