Invest

Update a secondary market offer

Update the number of shares or unit price of an offer.

patch/v1/invest/offers/{id}

Request

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

Path parameters

idstring uuid required

The unique identifier of the offer

Request body

sharesinteger

Number of shares offered

pricenumber

Unit price per share

Example request

{
  "shares": 10,
  "price": 125.5
}

Response

Offer updated 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.