Skip to content
Risk Assessment and Investor Certification

Submit Risk Assessment

Submits the Client risk tolerance assessment answers. The server calculates the risk level from the assessment configuration and returns it. Questions, options, and scores come from the server-side assessment configuration (configuration ID risk_account_application). The Broker App renders the questions from that configuration and adds each selected value to content as a {key, value} item. For multiple-choice questions, join the values with commas.

Side effect: after a successful submission, the Client risk level becomes the returned risk, and GET /v1/member/ut/states returns the new level afterwards, possibly with a short delay. If the Client already has a result and wants to retake the assessment, call GET /v1/member/ut/check_frequency_limit first. If the submission fails, show message and do not change the level already shown.

When you call this operation through WhaleCore requestService(), you do not need to set requiresTradeToken to true.

POSThttps://api.lbkrs.com/v3/member/ut/risk/assess

Request body application/json

contentarray<object>required

Answers, one item per question

Child attributes
keystringrequired

Question number, such as Q1

valuestringrequired

Selected option value, such as A. For multiple-choice questions, join values with commas, such as A,B.

scenestringrequired

Assessment scene. Pass mmf.

schema_idstringrequired

Assessment configuration ID. Pass risk_account_application.

versionstringrequired

Assessment configuration version. Pass 1.

Responses

HTTP 200The request succeeded. The response body contains the result of the “Submit Risk Assessment” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
riskstring

Risk level after the assessment, from A1 to A5

Whale Docs