Redeem Fractional-Share Card

POSThttps://api.lbkrs.com/rewards/realize_stock_fragment_card

Request body application/json

card_idsarray<string>required

List of voucher/card ids to be redeemed

counter_idstringrequired

Target stock id for redemption

amountintegerrequired

Quantity of shares to redeem

aaidstringrequired

Target account aaid to receive the redeemed shares

account_channelstringrequired

Broker channel

display_idstringrequired

Target account display id (account)

Responses

HTTP 200The request succeeded. The response body contains the result of the “Redeem fractional-share card” operation.

Standard response envelopecodemessagedata

dataobjectdata structure

Empty object; no specific business fields

No nested fields

HTTP 400The service rejected the request because a business rule or input validation failed. Review the business codes and correct the request before retrying.

codeintegerrequired

Business status code, 0 indicates success

messagestringrequired

Human-readable result or error message.

Request

let request = WhaleCoreHTTPRequest(
    method: .post,
    path: "/rewards/realize_stock_fragment_card"
)
request.body = [
    "card_ids": [
        "<CARD_ID>"
    ],
    "counter_id": "ST/US/AAPL",
    "amount": 1,
    "aaid": "<AAID>",
    "account_channel": "<BROKER_CHANNEL>",
    "display_id": "<ACCOUNT_DISPLAY_ID>"
]

let response = try await WhaleCoreService.requestService.send(request)
print(response.bodyString)

Example response

{
  "code": 0,
  "message": "success",
  "data": {}
}