Investor Portfolio Reports

Fetch Holdings

Returns all tranches you currently hold with quantity and tranche details.

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

{
  "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"
    }
  ]
}

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

{
  "success": true,
  "data": {
    "total_invested": 2500000,
    "total_holdings": 4,
    "active_deals": 2,
    "settled_trades": 3,
    "pending_trades": 1
  }
}

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.

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

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