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

Get SPV

v1.private_markets.get_spv_by_id(strspv_id, PrivateMarketGetSpvByIDParams**kwargs) -> PrivateMarketGetSpvByIDResponse
GET/v1/private-markets/spvs/{spv_id}

Fetch one private-market SPV’s complete economics and fee schedule. Requires the account holder to have attested. Returns 404 unless the SPV is OPEN and attached to a currently visible ACTIVE offering.

ParametersExpand Collapse
spv_id: str
account_id: int

Account whose account-holder entity must hold an accreditation attestation to browse private-market offerings.

formatint64
ReturnsExpand Collapse
class PrivateMarketGetSpvByIDResponse: …
data: SpvDetail

An OPEN SPV’s identity, exact economics, and typed fee schedule.

id: str

Stable SPV identifier.

formatuuid
company_id: str

Company whose shares the vehicle holds.

formatuuid
currency: Currency

Terms currency.

name: str

Legal/display name.

status: SpvStatus

Lifecycle state.

One of the following:
"DRAFT"
"OPEN"
"CLOSED"
"LIQUIDATING"
"DISSOLVED"
all_in_price_per_share: Optional[str]

Price per share including fees.

custodian_name: Optional[str]

Custodian.

fee_per_share: Optional[str]

Per-share fee.

fee_terms: Optional[List[SpvFeeTermResource]]

Typed fee schedule.

charged_by: ChargedBy

Charging party.

One of the following:
"FUND_MANAGER"
"CLEAR_STREET"
"THIRD_PARTY"
currency: Currency

Terms currency.

description: str

Plain-text fee disclosure.

fee_type: FeeType

Fee kind.

One of the following:
"MANAGEMENT"
"CARRY"
"PLACEMENT"
"ADMINISTRATIVE"
"OTHER"
frequency: FeeFrequency

Timing/cadence.

One of the following:
"ONE_TIME"
"ANNUAL"
"AT_EXIT"
"PASS_THROUGH"
amount: Optional[str]

Exact fixed amount, when amount-based.

duration_years: Optional[str]

Charge duration in years, when specified.

hurdle_rate: Optional[str]

Carry hurdle as a decimal fraction, when specified.

rate: Optional[str]

Decimal fraction between zero and one, when percentage-based.

funded_percent: Optional[str]

Percentage of dollar allocation funded, derived from the allocation pair.

funding_deadline: Optional[datetime]

Funding deadline.

formatdate-time
manager_name: Optional[str]

SPV manager.

minimum_investment_amount: Optional[str]

Minimum investment amount.

opened_at: Optional[datetime]

Time the vehicle opened.

formatdate-time
price_per_share: Optional[str]

Price per share excluding fees.

remaining_allocation_amount: Optional[str]

Remaining dollar allocation.

remaining_share_allocation: Optional[str]

Remaining share allocation.

share_class: Optional[str]

Underlying share class, when specified.

structure_description: Optional[str]

Plain-text vehicle structure.

total_allocation_amount: Optional[str]

Total dollar allocation.

total_share_allocation: Optional[str]

Total share allocation.

valuation: Optional[str]

Exact company valuation.

valuation_basis: Optional[ValuationBasis]

Meaning of valuation.

One of the following:
"PRE_MONEY"
"POST_MONEY"
"REFERENCE"
"IMPLIED"

Get SPV

from clearstreet import ClearStreet

client = ClearStreet(
    api_key="My API Key",
)
response = client.v1.private_markets.get_spv_by_id(
    spv_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    account_id=0,
)
print(response)
{
  "data": {
    "all_in_price_per_share": "102.5",
    "company_id": "b2b3b4b5-c2c3-d2d3-e2e3-e4e5e6e7e8e9",
    "currency": "USD",
    "custodian_name": "Clear Street LLC",
    "fee_per_share": "2.5",
    "funded_percent": "70",
    "id": "c3c4c5c6-d3d4-e3e4-f3f4-f5f6f7f8f9f0",
    "manager_name": "Clear Street Ventures",
    "minimum_investment_amount": "25000",
    "name": "Acme Robotics SPV III",
    "price_per_share": "100",
    "remaining_allocation_amount": "1500000",
    "remaining_share_allocation": "15000",
    "share_class": "Series D",
    "status": "OPEN",
    "total_allocation_amount": "5000000",
    "total_share_allocation": "50000",
    "valuation": "5000000000",
    "valuation_basis": "PRE_MONEY"
  },
  "error": null,
  "metadata": {
    "request_id": "7c8d9e0f-1a2b-3c4d-5e6f-7a8b9c0d1e2f"
  }
}
Returns Examples
{
  "data": {
    "all_in_price_per_share": "102.5",
    "company_id": "b2b3b4b5-c2c3-d2d3-e2e3-e4e5e6e7e8e9",
    "currency": "USD",
    "custodian_name": "Clear Street LLC",
    "fee_per_share": "2.5",
    "funded_percent": "70",
    "id": "c3c4c5c6-d3d4-e3e4-f3f4-f5f6f7f8f9f0",
    "manager_name": "Clear Street Ventures",
    "minimum_investment_amount": "25000",
    "name": "Acme Robotics SPV III",
    "price_per_share": "100",
    "remaining_allocation_amount": "1500000",
    "remaining_share_allocation": "15000",
    "share_class": "Series D",
    "status": "OPEN",
    "total_allocation_amount": "5000000",
    "total_share_allocation": "50000",
    "valuation": "5000000000",
    "valuation_basis": "PRE_MONEY"
  },
  "error": null,
  "metadata": {
    "request_id": "7c8d9e0f-1a2b-3c4d-5e6f-7a8b9c0d1e2f"
  }
}