Invest

Get a secondary market offer

Fetch a specific secondary market offer by ID.

get/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

Response

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