Skip to content
Clear Street Clear Street Clear Street
Start Trading
API Reference
V1
Private Markets

Create an IOI for a visible upcoming offering.

v1.private_markets.create_ioi(PrivateMarketCreateIoiParams**kwargs) -> PrivateMarketCreateIoiResponse
POST/v1/private-markets/iois

Create an IOI for a visible upcoming offering.

ParametersExpand Collapse
account_id: int
notional_amount: str
offering_id: str
nda_acceptance: Optional[NdaAcceptance]

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

accepted: bool

Must be true; confirms affirmative assent.

agreement_id: str

Exact agreement id returned by offering detail.

formatuuid
authority_confirmed: bool

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

ReturnsExpand Collapse
class PrivateMarketCreateIoiResponse: …

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

Company identity embedded in an IOI list item.

id: str
name: str

Offering identity embedded in an IOI list item.

id: str
headline: str

Create an IOI for a visible upcoming offering.

from clearstreet import ClearStreet

client = ClearStreet(
    api_key="My API Key",
)
response = client.v1.private_markets.create_ioi(
    account_id=0,
    notional_amount="100000.00",
    offering_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
)
print(response)
{
  "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
{
  "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"
  }
}