Creates a MarginX margin group and adds the specified DMA accounts and/or RapidX Portfolio venues. DMA-only, RapidX-only and mixed groups are supported.

Rate limit: 10 requests per minute per API key.

API key access

Requires a signed LTP Open API request with TRANSFER permission. Creating a group does not itself borrow or transfer funds.

Body parameters

Send a JSON object. Both member arrays are required; use [] for the member type you are not adding.

Members and limits

• Use Get Trading Account Assets V2 to find account and Portfolio IDs. memberId identifies an account or Portfolio; it is not a margin group ID.
• The two arrays must contain 1–30 members in total. A main user can have up to 20 groups.
• A DMA account is identified by memberId; a RapidX member is identified by memberId and venue. Do not submit duplicate members or members already belonging to another group.
• Accounts must be eligible for MarginX. Frozen, restricted or external accounts cannot be added. Visibility in the account list alone does not establish eligibility.
• If any member fails validation, the creation request fails; invalid members are not silently skipped.

Signing a body containing member arrays

Follow Authentication for the headers and HMAC-SHA256 algorithm. For this endpoint, the signature uses the following representation of nested body values; the HTTP body remains standard JSON:

Sort top-level parameter names alphabetically. Preserve array order and the order of fields within each member object. Exclude top-level fields with JSON null values from the signing string; required fields must still contain valid values.

For the request below, the HMAC input is:

dmaGroupMemberList=[{memberId=51001}]&name=Group Alpha&rxGroupMemberList=[{memberId=71001, venue=BINANCE}]&<nonce>

Runnable Python example (replace the example IDs with eligible accounts):

import hashlib
import hmac
import json
import os
import time
import urllib.request

payload = {
    "name": "Group Alpha",
    "dmaGroupMemberList": [{"memberId": "51001"}],
    "rxGroupMemberList": [{"memberId": "71001", "venue": "BINANCE"}],
}

def signing_value(value):
    if isinstance(value, list):
        return "[" + ", ".join(signing_value(item) for item in value) + "]"
    if isinstance(value, dict):
        return "{" + ", ".join(
            key + "=" + signing_value(item) for key, item in value.items()
        ) + "}"
    return str(value)

nonce = str(int(time.time()))
parameters = "&".join(
    key + "=" + signing_value(payload[key])
    for key in sorted(payload) if payload[key] is not None
)
signature = hmac.new(
    os.environ["LTP_SECRET_KEY"].encode(),
    (parameters + "&" + nonce).encode(),
    hashlib.sha256,
).hexdigest()

request = urllib.request.Request(
    "https://api.liquiditytech.com/api/v2/lending/marginx/groups",
    data=json.dumps(payload).encode(),
    headers={
        "Content-Type": "application/json",
        "X-MBX-APIKEY": os.environ["LTP_API_KEY"],
        "nonce": nonce,
        "signature": signature,
        "ts": str(time.time_ns() // 1000),
    },
    method="POST",
)
with urllib.request.urlopen(request, timeout=30) as response:
    print(response.read().decode())

Response fields

Success and error examples are available in the response panel.

Error codes

Business errors can return HTTP 200 with a non-success JSON code. Check code, not HTTP status alone. See Error Codes for shared errors.

If a creation request times out, check the group list for the submitted name before resubmitting it.