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

GET /investor/portfolio              → list current holdings (positions)
GET /investor/portfolio/summary      → aggregate totals across all holdings
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.

curl https://api.9squid.com/v1/api/investor/portfolio \
  -H "Authorization: Bearer <your_token>"

Response

{
  "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.

curl https://api.9squid.com/v1/api/investor/portfolio/summary \
  -H "Authorization: Bearer <your_token>"

Response

{
  "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.

curl https://api.9squid.com/v1/api/investor/portfolio/reports \
  -H "Authorization: Bearer <your_token>"

Response

{
  "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:

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 — run duration, convexity, and stress tests on a specific deal
Webhooks — subscribe to real-time events for trade settlements and deal updates
API Reference — Investor Portfolio — full schema for all portfolio endpoints

​Overview

​Step 1 — Fetch Your Holdings

​Step 2 — View Portfolio Summary

​Step 3 — Pull Full Portfolio Reports

​Exploring the Deal Marketplace

​What’s Next

Overview

Step 1 — Fetch Your Holdings

Step 2 — View Portfolio Summary

Step 3 — Pull Full Portfolio Reports

Exploring the Deal Marketplace

What’s Next