Invest

Create a secondary market offer

Create a buy or sell offer on the secondary market. For sell offers, lockup periods and share balance are verified.

post/v1/invest/offers

Request

Base URL: https://api.prod.keyban.io
URL: https://api.prod.keyban.io/v1/invest/offers
Auth: bearer (a scheme the document does not define)

Request body

fundstring uuid required

The unique identifier of the investment fund

identitystring uuid required

The unique identifier of the investor identity

type'BUY' | 'SELL' required

Direction of the offer on the secondary market. BUY indicates the investor is looking to purchase shares; SELL indicates they are offering shares for sale.

sharesinteger required

Number of shares offered

pricenumber required

Unit price per share

Example request

{
  "fund": "550e8400-e29b-41d4-a716-446655440000",
  "identity": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "type": "SELL",
  "shares": 10,
  "price": 125.5
}

Response

Offer created successfully

idstring uuid required

Entity UUID

createdAtstring date-time required

Creation date (ISO 8601)

updatedAtstring date-time required

Last update date (ISO 8601)

type'BUY' | 'SELL' required

Direction of the offer on the secondary market. BUY indicates the investor is looking to purchase shares; SELL indicates they are offering shares for sale.

sharesinteger required

Number of shares offered

pricenumber required

Unit price per share

currency'EUR' | 'USD' required

Currency of the offer

expiresAtstring date-time required

Expiration date of the offer

Example response

{
  "fund": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Green Energy Fund I"
  },
  "identity": {
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "firstName": "Jane",
    "lastName": "Doe",
    "email": "jane.doe@acme.example"
  },
  "type": "SELL",
  "shares": 10,
  "price": 125.5,
  "currency": "EUR",
  "expiresAt": "2026-12-31T23:59:59.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.