Skip to content
Cards

Get Fund Interest-Boost Card Details

Returns a single fund interest-boost card with its boost earnings, for the card details page that shows the boost scope, boost days, annualized rate increase, daily principal cap, cumulative and latest earnings, settlement mode, and daily earnings history. Base card fields match the card object in GET /rewards/card_list; fund_interest holds the boost rules and earnings.

While a related fund subscription is being processed, card_status may return 5.

GEThttps://api.lbkrs.com/rewards/cards/fund_interest_info

Parameters

card_idstringqueryRequired

Card ID of the fund interest-boost card

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get fund interest-boost card details” operation.
Standard response envelopecodemessagedata
dataobjectdata structure

Card/Coupon information

card_idstring

Card/Coupon id

member_idstring

The member_id of the Client who holds the card.

card_typestring

Card/Coupon type: cash Cash card, quote Market data card, fundamental Fundamental card, commission Commission-free card, ipo IPO privilege card, ipo_interest IPO financing interest card, ipo_commission IPO fee card, stock Stock card, stock_fragment Fractional share card, platform_fee_deduct Platform fee deduction card, finance_interest Margin financing interest card, fund_interest Fund interest-boost card, coffee_coupon Coffee coupon

Values
cash
quote
fundamental
commission
ipo
ipo_interest
ipo_commission
stock
stock_fragment
platform_fee_deduct
finance_interest
fund_interest
coffee_coupon
titlestring

Card/Coupon title

title_secstring

Card/Coupon subtitle

coverstring

Cover image

descriptionstring

Client-facing description.

start_timestring

Usable start timestamp (seconds)

end_timestring

Expiry timestamp (seconds)

card_statusinteger

Coupon/voucher status:

  • 0 - Not activated
  • 1 - Used
  • 2 - Expired
  • 3 - In use
  • 4 - Activated
Values
0
1
2
3
4
detailstring

Card/Coupon details

currencystring

Currency unit, applicable to Cash cards, Commission-free cards, IPO financing interest cards, IPO fee cards

amountstring

Associated amount

activate_timestring

Card/Coupon activation time

invisibleboolean

Is invisible (used only in available-cards list scenario)

backgroundstring

Card/Coupon background image

stylestring

Card/Coupon style

account_channelstring

Account channels applicable to the card/coupon

new_flagboolean

New card indicator

cashobject

Cash card information

Child attributes
receive_durationstring

Cash arrival time required (seconds)

quoteobject

Market data card / Fundamental card information

Child attributes
quote_durationstring

Permission duration (seconds)

marketsarray<string>

Entitlement market(s)

superpositionboolean

Is time stackable

quote_marketstring

Market data market

current_end_timestring

Current expiration time

manual_activateboolean

Requires manual activation

need_certifyboolean

Requires professional investor accreditation

fundamentalobject

Market data card / Fundamental card information

Child attributes
quote_durationstring

Permission duration (seconds)

marketsarray<string>

Entitlement market(s)

superpositionboolean

Is time stackable

quote_marketstring

Market data market

current_end_timestring

Current expiration time

manual_activateboolean

Requires manual activation

need_certifyboolean

Requires professional investor accreditation

commissionobject

Commission-free card information

Child attributes
marketsarray<string>

Commission-free markets, e.g. US, SH, SG, HK

rebate_ratestring

Commission-free ratio, 1 represents 100%

bz_typesarray<integer>

Applicable instrument types

commission_durationstring

Commission-free card duration (seconds)

commission_balancestring

Commission-free card balance

unlimitedinteger

Commission-free mode:

  • 0 - Proportional commission-free (collect first, rebate later; time-limited)
  • 1 - Full commission-free (collect first, rebate later; time-limited)
  • 2 - Lifetime commission-free (direct deduction; no usage limit)
  • 6 - Fixed-amount per-use card (usage count limit, time-limited)
  • 7 - Discount per-use card (usage count limit, time-limited)
Values
0
1
2
6
7
commission_expired_timestring

Commission-free expiry time (for commission-free cards currently in use)

superpositionboolean

Is time stackable

settlement_modelstring

Settlement mode: payback charge-first-refund-later, compensate direct deduction

Values
payback
compensate
usage_countstring

Commission-free card usage count

lave_usage_countstring

Remaining available uses

amount_limitstring

Per-use amount cap (unit: cents); absence means no limit

ipoobject

IPO privilege card information

Child attributes
subscription_idstring

Reservation id; empty means generalized IPO card

ipo_interestobject

IPO financing interest card information

Child attributes
discount_ratestring

Subsidy interest rate, 1 represents 100%

ipo_commissionobject

IPO fee card information

Child attributes
bz_typesarray<integer>

IPO method

financing_limitstring

Financing IPO quota threshold, 0 means no threshold

counter_idstring

Specified IPO stock id; empty means no restriction

stockobject

Stock card information

Child attributes
counter_idstring

Stock id

amountnumber

Number of shares issued, supports fractional shares

redemption_typestring

Redemption type: by_card_value redeem by card face value, shares_number fixed shares redemption (default)

Values
by_card_value
shares_number
stock_fragmentobject

Fractional-share card information.

Child attributes
counter_idstring

Applicable stock id; empty means fractional-share general card

marketsarray<string>

Applicable market

amountsobject

Issuance quantity per market

underlying_typeinteger

Underlying/instrument type:

  • 0 - Stock trading
  • 1 - US equity options
  • 2 - HK warrants
  • 3 - Exchange-traded funds (ETF)
  • 4 - Off-exchange funds (LOF)
Values
0
1
2
3
4
platform_fee_deductobject

Platform fee deduction card information

Child attributes
usage_countstring

Usage count

lave_usage_countstring

Remaining available uses

superpositionboolean

Is time stackable

marketsarray<string>

Applicable market

bz_typesarray<integer>

Applicable instrument types

counter_idstring

Applicable stock id

finance_interestobject

Financing interest card information

Child attributes
discount_modeinteger

Discount method

discount_ratenumber

Discount rate

superpositionboolean

Is stackable/extendable

fund_interestobject

Fund interest-boost card rules and earnings

Child attributes
underlying_typestring

Boost scope type:

  • range - Boost applies to fund types; underlying_values holds fund types
  • specified - Boost applies only to specific funds; underlying_values holds fund identifiers
Values
range
specified
underlying_valuesarray<string>

Boost scope values. When underlying_type is range, values are UT (public funds), PE (private funds), or MMF (money market funds)

underlying_namesarray<string>

Names of the specified funds, for display when underlying_type is specified; show underlying_values when empty

aprstring

Annualized rate increase in percentage points; for example, 2 means +2% per year

total_dayinteger

Total boost days after activation

used_dayinteger

Days already boosted

maximum_principalstring

Daily principal cap for the boost, in the card currency; applies when greater than 0. If eligible fund holdings are below the cap, the boost uses the holding amount

profit_period_startstring

Boost period start timestamp (seconds)

profit_period_endstring

Boost period end timestamp (seconds)

sum_profitstring

Cumulative boost earnings

latest_profitstring

Most recent boost earnings

latest_profit_dayinteger

Date timestamp of the most recent boost (seconds)

sum_settlementstring

Settled boost earnings

latest_settlement_dayinteger

Date timestamp of the most recent settlement (seconds)

settlement_typestring

Earnings settlement mode:

  • single - Settled and paid once after the card is used up
  • multiple - Settled every settlement_interval days and paid after each settlement
Values
single
multiple
settlement_intervalstring

Settlement interval in days; applies when settlement_type is multiple

profitsarray<object>

Daily boost earnings history; amounts are rounded

Child attributes
dtinteger

Date timestamp (seconds)

amountstring

Boost earnings for the day

coffee_couponobject

Coffee coupon information

Child attributes
coupon_channelstring

Card/Coupon channel

coupon_nostring

Third-party card/coupon number

use_limitstring

Usage limit type: total total-use limit, period periodic-use limit

Values
total
period
thresholdstring

Maximum uses

period_typestring

Period type (effective when use_limit is period), e.g. day

coupon_idstring

Third-party card/coupon id

store_id_listarray<string>

Store IDs where the coupon can be used.

is_available_all_storeboolean

Whether the coupon can be used at every store.

settled_store_idstring

ID of the store where the coupon was redeemed.

store_listarray<object>

Stores where the coupon can be used. The item schema is not defined.

cryptoobject

Virtual asset card information. The object schema is not defined.

ai_benefitobject

AI benefit card information.

Child attributes
benefit_tagstring

Entitlement tag

benefit_daysinteger

Entitlement days

benefit_startstring

Entitlement start time

benefit_endstring

Entitlement end time

receive_durationstring

Time for cash to arrive (seconds). Deprecated and pending removal; semantics same as cash.receive_duration; retained only for compatibility with legacy Broker App.

quote_durationstring

Permission duration (seconds). Deprecated and pending removal; semantics same as quote.quote_duration; retained only for compatibility with legacy Broker App.

marketsarray<string>

Commission-free markets. Deprecated and pending removal; semantics same as commission.markets; retained only for compatibility with legacy Broker App.

rebate_ratestring

Commission-free rebate rate. Deprecated and pending removal; semantics same as commission.rebate_rate; retained only for compatibility with legacy Broker App.

bz_typesarray<integer>

Applicable underlying types. Deprecated and pending removal; semantics same as commission.bz_types; retained only for compatibility with legacy Broker App.

commission_balancestring

Commission-free card balance. Deprecated and pending removal; semantics same as commission.commission_balance; retained only for compatibility with legacy Broker App.

commission_durationstring

Commission-free card duration (seconds). Deprecated and pending removal; semantics same as commission.commission_duration; retained only for compatibility with legacy Broker App.

subscription_idstring

IPO privilege card subscription id. Deprecated and pending removal; semantics same as ipo.subscription_id; retained only for compatibility with legacy Broker App.

Whale Docs