Modify Trade Credit

Creates or modifies a customer's trading-credit configuration.

Request parameters

Required: aaid (customer funding account ID), trade_credit_type (credit type), trade_credit_map (per-currency limit map), expired_at (expiry time), action (operation type)
Optional: remark, audit_frontend_resource (caller audit context)
See the field definitions for each field's format, allowed values, and business meaning.

Business notes

Depending on action, creates or modifies the account's trading credit. Limits are set per currency via the map and are bounded by the expired_at expiry time.

Risk warning

This operation changes a real trading credit. Verify the account, credit type, per-currency amounts, and expiry time before calling.

Result

On success the trading credit is created or modified; subsequent state and returned data follow the 200 response definition.

POSThttps://b-api.lbkrs.com/risk/v1/trade_credit/modify

Authorization

AuthorizationstringheaderRequired

Send the Broker ACCESS_TOKEN as Authorization: Bearer <token>.

Request body application/json

aaidstringrequired

Account AAID. The customer fund account selected via the request field member_query_aaid component; disabled and unchangeable when editing.

Pass the internal numeric ID of the customer's securities account (aaid), not the securities account number account_no (such as H00000000) or the customer ID member_id. One customer can have multiple aaid values.

trade_credit_typestringrequired

Credit type. Options come from a backend data dictionary; common values: 0 (single-currency trading credit), 1 (multi-currency trading credit).

Values

0: Single-Currency Trading Limit
1: Multi-Currency Trading Limit

trade_credit_mapobjectrequired

Trade Credit Map. Currency-to-limit key-value pairs, e.g. {"HKD":"100000"}; when trade_credit_type=0 it contains only a single currency, and when =1 it may contain multiple currencies.

expired_atnumberrequired

Expired At. A Unix timestamp (seconds); after a date is chosen in the date picker, the hour/minute/second are taken from the current time at submission.

remarkstring

Remark. A textarea, up to 100 characters.

actionnumberrequired

Action. 0=Create (add), 1=Edit (edit); computed automatically by the client based on whether an item record is passed in.

Values

0: add
1: edit

audit_frontend_resourceobject

Audit Context. A non-core business field carrying before and value (after) data plus $action/$behavior, used for display in risk-control approval tickets.

Responses

HTTP 200The request was processed successfully. The response data does not contain additional business fields.