Skip to content
Money Market Fund (MMF)

Save MMF Subscription Settings

Enables, upgrades, or updates the money market fund (MMF) subscription settings of a Client, including the subscription mode, the subscription fund of each currency, and whether auto-subscription is paused. After a successful save, idle cash is subscribed into money market funds according to the new settings.

Before calling, use GET /portfolio/mmf/status to decide the operation: pass operation = 2 (update) when mmf_version is 1, otherwise pass 1 (enable or upgrade). currency_funds must contain at least one currency entry. To pause or resume auto-subscription for a single currency, submit only that currency entry. In manual mode, each currency can have only one subscription fund.

On failure, handle the business code: guide the Client to complete the CKA when it is missing or expired; otherwise show message. A failed save does not change the existing settings, so roll back the changes on the page.

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

POSThttps://api.lbkrs.com/portfolio/mmf/save_mmf_purchase

Request body application/json

is_auto_purchasebooleanrequired

Subscription mode: true selects the subscription fund automatically; false means the Client picks one subscription fund per currency

operationintegerrequired

Operation type:

  • 1 - Enable or upgrade MMF
  • 2 - Update existing settings
Values
1
2
currency_fundsarray<object>required

Subscription settings per currency

Child attributes
currencystringrequired

Currency, such as USD

is_pausedbooleanrequired

Whether to pause auto-subscription for this currency

purchase_fundobjectrequired

Subscription fund of this currency

Child attributes
counter_idstringrequired

Security code of the subscription fund. In automatic mode, pass the current subscription fund, or the fund with the highest 7-day annualized yield in this currency when there is none

authorized_counter_idsarray<string>

All fund security codes in this currency that the Client authorizes in automatic mode, submitted in full each time. Required in automatic mode; omit it in manual mode. Omitting it keeps the existing authorization. Do not pass an empty array

Responses

HTTP 200The settings were saved.
codeintegerrequired

Business status code, 0 indicates success

messagestringrequired

Human-readable result or error message.

HTTP 400The request failed business rules or input validation. Fix the request based on the business code before retrying.
codeintegerrequired

Business status code, 0 indicates success

messagestringrequired

Human-readable result or error message.

Whale Docs