transferMdToShareGroup to fund that pool by moving collateral from a market deployer’s cross margin pool into a specific share group. The transfer is subject to the same withdrawable amount constraints that apply to the source market deployer — position IM and order-frozen margin reduce how much you can move.
Share-group margin applies to accounts in PORTFOLIO margin mode, where contracts in the same share group draw from one pooled balance. See
setMarginShareType.Endpoint
Request
Every request must carry an ECDSA signature and a nonce to prevent replay attacks.Action parameters
int32
required
marketDeployerId (required) — The ID of the source market deployer. Funds are deducted from this deployer’s cross margin pool and are subject to its withdrawable amount limit.int32
required
groupId (required) — The ID of the target share group. Funds are credited to this group’s shared margin pool.int32
required
coinId (required) — The coin or currency ID to transfer.string
required
amount (required) — The amount to transfer, expressed as a raw integer string (e.g. "1000"). Must be greater than zero — 0 or a negative value returns 400 INVALID_PARAM and must not exceed the withdrawable amount on the source deployer. Decimals are not accepted — use the coin’s smallest unit.The server does not reject a request that omits
marketDeployerId, groupId, or coinId with a 400: an omitted ID is treated as 0, and the resulting invalid combination is returned as HTTP 200 with a non-zero errorCode in response.data. Only a missing, malformed, or non-positive amount returns a 400. Always send every ID explicitly.Response
A successful transfer returns the updated balances for both the source market deployer and the destination share group.int32
The coin ID that was transferred.
int64
The amount moved from the market deployer into the share group.
int64
The cross margin balance of the source market deployer after the transfer.
int64
The share group’s margin pool balance after the transfer.
number
Present only when the request is rejected; a non-zero value means nothing moved.
string
Present together with
errorCode. The rejection reason.Errors
If the request cannot be fulfilled, the exchange still returns HTTP 200 withstatus: "ok" — the rejection is reported inside response.data, where a non-zero errorCode (number) and an errorMessage are present while the numeric amount and balance fields are set to 0. Common causes include:
- Amount exceeds withdrawable balance on the market deployer — position IM and frozen order margin on the source deployer constrain how much can be moved.
- Unknown
groupId— the specified share group does not exist.