Skip to content
Rights Issues and Tender Offers

Submit Rights Issue or Tender Offer Subscription

Submits a subscription instruction for an event. For a rights issue, the Client subscribes to new shares at the rights issue price (an excess rights application when is_excess is true). For a tender offer, the quantity is the number of shares tendered at the offer price.

Prerequisite: call POST /v1/portfolio/corpaction/subscribe/calculate_fee first, show the total fee to the Client, and get confirmation. Success means only that the application was submitted, not that it is complete. Track progress through state in the subscription details or history. On failure, show message to the Client and confirm that the event is still open before deciding whether to retry. Specify the target account in the x-target-aaid request header.

When calling through WhaleCore requestService(), set requiresTradeToken to true.

POSThttps://api.lbkrs.com/v1/portfolio/corpaction/subscribe/apply

Parameters

x-target-aaidstringheaderRequired

The aaid of the target account. The operation returns or processes subscription data for this account.

Request body application/json

ann_idintegerrequired

Corporate action event ID from ann_id of the event, converted to a number

quantitystringrequired

Number of shares to subscribe, as a positive integer string. It cannot exceed max_subscribe_quantity of the event.

Responses

HTTP 200The request succeeded. The response body contains the result of the “Submit Rights Issue or Tender Offer Subscription” operation.
Standard response envelopecodemessagedata
dataobjectdata structure

Always null. Use code to determine whether the request succeeded.

No nested fields

Whale Docs