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

> Browse the deal marketplace, submit an indication of interest, commit to a subscription, and track allocation status.

<Steps>
  <Step title="Browse Available Deals">
    Returns a paginated list of all deals currently open for investment with metrics and tranche overview.

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

      ```json Response theme={null}
      {
        "success": true,
        "data": [
          {
            "deal_id": "clx1a2b3c4d5e6f7g8h9",
            "asset_type": "Auto",
            "total_balance": 48500000,
            "loan_count": 1240,
            "wa_fico": 718,
            "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 }
            ]
          }
        ]
      }
      ```
    </CodeGroup>
  </Step>

  <Step title="Inspect Deal Details">
    Review the full deal before committing — pool stats, tranches, documents, and originator profile.

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

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

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

      ```json Response theme={null}
      {
        "success": true,
        "data": { }
      }
      ```
    </CodeGroup>
  </Step>

  <Step title="Submit Indication of Interest">
    Signal interest without a formal commitment. Non-binding — lets the originator gauge demand.

    <CodeGroup>
      ```bash cURL 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
        }'
      ```

      ```json Response theme={null}
      {
        "success": true,
        "data": {
          "ioi_id": "clxioi001",
          "status": "RECEIVED",
          "deal_id": "clx1a2b3c4d5e6f7g8h9",
          "tranche_id": "clxtranche01",
          "indicated_amount": 1000000
        }
      }
      ```
    </CodeGroup>
  </Step>

  <Step title="Submit Formal Subscription">
    Commit to the deal. The platform runs compliance checks automatically.

    <CodeGroup>
      ```bash cURL 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
        }'
      ```

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

  <Step title="Check Allocations">
    Once confirmed, your allocation appears here with quantity and settlement details.

    | Status                 | Meaning                           |
    | ---------------------- | --------------------------------- |
    | `PENDING_CONFIRMATION` | Awaiting originator confirmation  |
    | `CONFIRMED`            | Accepted — allocation in progress |
    | `ALLOCATED`            | Units allocated to your account   |
    | `REJECTED`             | Subscription rejected             |

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

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