Titanbay Private Markets API

RESTful API for managing private market funds, investors, and their investments

v1.0.0

Funds

Fund management operations

GET /funds
List all funds
Response (200 OK)
[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Titanbay Growth Fund I",
    "vintage_year": 2024,
    "target_size_usd": 250000000.00,
    "status": "Fundraising",
    "created_at": "2024-01-15T10:30:00Z"
  }
]
POST /funds
Create a new fund
Request Body
{
  "name": "Titanbay Growth Fund II",
  "vintage_year": 2025,
  "target_size_usd": 500000000.00,
  "status": "Fundraising"
}
Response (201 Created)
{
  "id": "660e8400-e29b-41d4-a716-446655440001",
  "name": "Titanbay Growth Fund II",
  "vintage_year": 2025,
  "target_size_usd": 500000000.00,
  "status": "Fundraising",
  "created_at": "2024-09-22T14:20:00Z"
}
PUT /funds
Update an existing fund
Request Body
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Titanbay Growth Fund I",
  "vintage_year": 2024,
  "target_size_usd": 300000000.00,
  "status": "Investing"
}
Response (200 OK)
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Titanbay Growth Fund I",
  "vintage_year": 2024,
  "target_size_usd": 300000000.00,
  "status": "Investing",
  "created_at": "2024-01-15T10:30:00Z"
}
GET /funds/{id}
Get a specific fund
Path Parameters
id string (uuid) REQUIRED
Response (200 OK)
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Titanbay Growth Fund I",
  "vintage_year": 2024,
  "target_size_usd": 250000000.00,
  "status": "Fundraising",
  "created_at": "2024-01-15T10:30:00Z"
}

Investors

Investor management operations

GET /investors
List all investors
Response (200 OK)
[
  {
    "id": "770e8400-e29b-41d4-a716-446655440002",
    "name": "Goldman Sachs Asset Management",
    "investor_type": "Institution",
    "email": "investments@gsam.com",
    "created_at": "2024-02-10T09:15:00Z"
  }
]
POST /investors
Create a new investor
Request Body
{
  "name": "CalPERS",
  "investor_type": "Institution",
  "email": "privateequity@calpers.ca.gov"
}
Response (201 Created)
{
  "id": "880e8400-e29b-41d4-a716-446655440003",
  "name": "CalPERS",
  "investor_type": "Institution",
  "email": "privateequity@calpers.ca.gov",
  "created_at": "2024-09-22T15:45:00Z"
}

Investments

Investment management operations

GET /funds/{fund_id}/investments
List all investments for a specific fund
Path Parameters
fund_id string (uuid) REQUIRED
Response (200 OK)
[
  {
    "id": "990e8400-e29b-41d4-a716-446655440004",
    "investor_id": "770e8400-e29b-41d4-a716-446655440002",
    "fund_id": "550e8400-e29b-41d4-a716-446655440000",
    "amount_usd": 50000000.00,
    "investment_date": "2024-03-15"
  }
]
POST /funds/{fund_id}/investments
Create a new investment to a fund
Path Parameters
fund_id string (uuid) REQUIRED
Request Body
{
  "investor_id": "880e8400-e29b-41d4-a716-446655440003",
  "amount_usd": 75000000.00,
  "investment_date": "2024-09-22"
}
Response (201 Created)
{
  "id": "aa0e8400-e29b-41d4-a716-446655440005",
  "investor_id": "880e8400-e29b-41d4-a716-446655440003",
  "fund_id": "550e8400-e29b-41d4-a716-446655440000",
  "amount_usd": 75000000.00,
  "investment_date": "2024-09-22"
}

Data Models

Fund

Field Type Description
id string (uuid) Unique identifier for the fund
name string Name of the fund
vintage_year integer Year the fund was established
target_size_usd number (decimal) Target size of the fund in USD
status string Fund status: Fundraising, Investing, or Closed
created_at string (date-time) Timestamp when the fund was created

Investor

Field Type Description
id string (uuid) Unique identifier for the investor
name string Name of the investor
investor_type string Type of investor: Individual, Institution, or Family Office
email string (email) Contact email address
created_at string (date-time) Timestamp when the investor was created

Investment

Field Type Description
id string (uuid) Unique identifier for the investment
investor_id string (uuid) Reference to the investor making the investment
fund_id string (uuid) Reference to the fund receiving the investment
amount_usd number (decimal) Investment amount in USD
investment_date string (date) Date when the investment was made