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

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": {}
}