API Reference

V1

Private Markets

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Create an IOI for a visible upcoming offering.

PrivateMarketCreateIoiResponse v1().privateMarkets().createIoi(PrivateMarketCreateIoiParamsparams, RequestOptionsrequestOptions = RequestOptions.none())

POST/v1/private-markets/iois

Create an IOI for a visible upcoming offering.

ParametersExpand Collapse

PrivateMarketCreateIoiParams params

long accountId

String notionalAmount

String offeringId

Optional<NdaAcceptance> ndaAcceptance

Required only when the offering’s attached SPV has an NDA agreement.

boolean accepted

Must be true; confirms affirmative assent.

String agreementId

Exact agreement id returned by offering detail.

formatuuid

boolean authorityConfirmed

Must be true; confirms the signer may bind the account-holder entity.

ReturnsExpand Collapse

class PrivateMarketCreateIoiResponse:

IoiListingResource data

IOI list item with the campaign identity needed to render it.

IoiCompanyResource company

Company identity embedded in an IOI list item.

String id

String name

IoiOfferingResource offering

Offering identity embedded in an IOI list item.

String id

String headline

Create an IOI for a visible upcoming offering.

Java

HTTP

TypeScript

Python

Java

Go

CLI Tool

package com.clearstreet.api.example;

import com.clearstreet.api.client.ClearStreetClient;
import com.clearstreet.api.client.okhttp.ClearStreetOkHttpClient;
import com.clearstreet.api.models.v1.privatemarkets.PrivateMarketCreateIoiParams;
import com.clearstreet.api.models.v1.privatemarkets.PrivateMarketCreateIoiResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        ClearStreetClient client = ClearStreetOkHttpClient.builder()
            .fromEnv()
            .apiKey("My API Key")
            .build();

        PrivateMarketCreateIoiParams params = PrivateMarketCreateIoiParams.builder()
            .accountId(0L)
            .notionalAmount("100000.00")
            .offeringId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
            .build();
        PrivateMarketCreateIoiResponse response = client.v1().privateMarkets().createIoi(params);
    }
}

201 example

{
  "data": {
    "account_id": 19816,
    "company": {
      "id": "b2b3b4b5-c2c3-d2d3-e2e3-e4e5e6e7e8e9",
      "name": "Acme Robotics"
    },
    "created_at": "2026-05-30T02:37:10.709695Z",
    "currency": "USD",
    "id": "019dbae9-73b4-7760-a947-8b4bcab57c49",
    "notional_amount": "100000.00",
    "offering": {
      "headline": "Series D opportunity",
      "id": "a1a2a3a4-b1b2-c1c2-d1d2-d3d4d5d6d7d8"
    },
    "offering_id": "a1a2a3a4-b1b2-c1c2-d1d2-d3d4d5d6d7d8",
    "updated_at": "2026-05-30T02:37:10.709695Z"
  },
  "error": null,
  "metadata": {
    "request_id": "7c8d9e0f-1a2b-3c4d-5e6f-7a8b9c0d1e2f"
  }
}

Returns Examples

201 example

{
  "data": {
    "account_id": 19816,
    "company": {
      "id": "b2b3b4b5-c2c3-d2d3-e2e3-e4e5e6e7e8e9",
      "name": "Acme Robotics"
    },
    "created_at": "2026-05-30T02:37:10.709695Z",
    "currency": "USD",
    "id": "019dbae9-73b4-7760-a947-8b4bcab57c49",
    "notional_amount": "100000.00",
    "offering": {
      "headline": "Series D opportunity",
      "id": "a1a2a3a4-b1b2-c1c2-d1d2-d3d4d5d6d7d8"
    },
    "offering_id": "a1a2a3a4-b1b2-c1c2-d1d2-d3d4d5d6d7d8",
    "updated_at": "2026-05-30T02:37:10.709695Z"
  },
  "error": null,
  "metadata": {
    "request_id": "7c8d9e0f-1a2b-3c4d-5e6f-7a8b9c0d1e2f"
  }
}