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

This recipe walks an investor through the full deal investment flow — browsing the marketplace, reviewing deal details, signalling interest, and committing to a subscription. Results are tracked through allocation.

## Overview

```
1. GET  /investor/deals                           → browse available deals
2. GET  /investor/deals/:dealId                   → inspect deal details & tranches
3. POST /investor/subscriptions/ioi               → submit indication of interest
4. POST /investor/subscriptions                   → submit formal subscription
5. GET  /investor/subscriptions/allocations       → check allocation status
```

***

## Step 1 — Browse the Deal Marketplace

Returns a paginated list of all deals currently open for investment with metrics and tranche overview.

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

**Response**

```json theme={null}
{
  "success": true,
  "data": [
    {
      "deal_id": "clx1a2b3c4d5e6f7g8h9",
      "asset_type": "Auto",
      "total_balance": 48500000,
      "loan_count": 1240,
      "wa_fico": 718,
      "wa_ltv": 72.4,
      "status": "OPEN",
      "tranches": [
        { "tranche_id": "clxtranche01", "name": "Senior A", "rating": "AAA", "yield": 5.2 },
        { "tranche_id": "clxtranche02", "name": "Mezzanine B", "rating": "BBB", "yield": 7.8 }
      ]
    }
  ]
}
```

***

## Step 2 — Inspect Deal Details

Before committing, review the full deal including documents, pool statistics, originator info, and comparable deals.

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

# Pool statistics for the deal
curl https://api.9squid.com/v1/api/investor/deals/clx1a2b3c4d5e6f7g8h9/pool \
  -H "Authorization: Bearer <your_token>"

# Available tranches
curl https://api.9squid.com/v1/api/investor/deals/clx1a2b3c4d5e6f7g8h9/tranches \
  -H "Authorization: Bearer <your_token>"

# Deal room documents (prospectus, legal)
curl https://api.9squid.com/v1/api/investor/deals/clx1a2b3c4d5e6f7g8h9/documents \
  -H "Authorization: Bearer <your_token>"

# Originator profile
curl https://api.9squid.com/v1/api/investor/deals/clx1a2b3c4d5e6f7g8h9/originator \
  -H "Authorization: Bearer <your_token>"
```

***

## Step 3 — Submit an Indication of Interest

Signal interest in a deal without a formal commitment. This is non-binding and lets the originator gauge demand before final allocation.

```bash theme={null}
curl -X POST https://api.9squid.com/v1/api/investor/subscriptions/ioi \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "deal_id": "clx1a2b3c4d5e6f7g8h9",
    "tranche_id": "clxtranche01",
    "indicated_amount": 1000000
  }'
```

**Response**

```json theme={null}
{
  "success": true,
  "data": {
    "ioi_id": "clxioi001",
    "status": "RECEIVED",
    "deal_id": "clx1a2b3c4d5e6f7g8h9",
    "tranche_id": "clxtranche01",
    "indicated_amount": 1000000
  }
}
```

***

## Step 4 — Submit a Formal Subscription

When ready to commit, submit a formal subscription. The platform runs compliance checks automatically.

```bash theme={null}
curl -X POST https://api.9squid.com/v1/api/investor/subscriptions \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "deal_id": "clx1a2b3c4d5e6f7g8h9",
    "tranche_id": "clxtranche01",
    "amount": 1000000
  }'
```

**Response**

```json theme={null}
{
  "success": true,
  "data": {
    "subscription_id": "clxsub001",
    "status": "PENDING_CONFIRMATION",
    "compliance_check_result": "PASSED",
    "deal_id": "clx1a2b3c4d5e6f7g8h9",
    "tranche_id": "clxtranche01",
    "amount": 1000000
  }
}
```

**Subscription statuses:**

| Status                 | Meaning                                        |
| ---------------------- | ---------------------------------------------- |
| `PENDING_CONFIRMATION` | Submitted, awaiting originator confirmation    |
| `CONFIRMED`            | Originator accepted — allocation in progress   |
| `ALLOCATED`            | Units allocated to your account                |
| `REJECTED`             | Subscription rejected — see reason in response |

***

## Step 5 — Check Your Allocations

Once confirmed, your allocation appears here with quantity and settlement details.

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

**Response**

```json theme={null}
{
  "success": true,
  "data": [
    {
      "allocation_id": "clxalloc001",
      "subscription_id": "clxsub001",
      "tranche_id": "clxtranche01",
      "tranche_name": "Senior A",
      "deal_id": "clx1a2b3c4d5e6f7g8h9",
      "allocated_quantity": 1000000,
      "price": 98.5,
      "settlement_date": "2026-05-01T00:00:00Z",
      "status": "PENDING_SETTLEMENT"
    }
  ]
}
```

***

## View Your Subscriptions

List all subscriptions across all deals:

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

***

## What's Next

* [Investor Portfolio Reports](/workflows/investor-portfolio) — view your holdings and performance once settled
* [Webhooks](/workflows/webhooks) — subscribe to `trade.settled` events to know when allocation completes
* [API Reference — Investor Deals](/api-reference/investor-deals/investordealscontroller_listdeals) — full schema for all investor deal endpoints