Skip to main content
When you need to rebalance funds between your PORTFOLIO share groups and per-market-deployer cross margin pools, use transferShareGroupToMd. This action moves collateral from a share group’s shared margin pool back into a specific market deployer’s cross margin pool. The transfer is constrained by the withdrawable amount available in the source share group — meaning position IM and order-frozen margin held against contracts in that group 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
groupId (required) — The ID of the source share group. Funds are deducted from this group’s shared margin pool, subject to its withdrawable amount limit.
​
int32
required
marketDeployerId (required) — The ID of the destination market deployer. Funds are credited to this deployer’s cross 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 available in the source share group. 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 share group and the destination market deployer. The response type is shareGroupFund, consistent with other share group fund operations.
​
int32
The coin ID that was transferred.
​
int64
The amount moved from the share group into the market deployer.
​
int64
The share group’s margin pool balance after the transfer.
​
int64
The cross margin balance of the destination market deployer 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 with status: "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 in the share group — position IM and frozen order margin on contracts within the group constrain how much can be moved.
  • Unknown groupId — the specified share group does not exist.

​
HTTP errors

To move funds in the opposite direction — from a market deployer into a share group — use transferMdToShareGroup. To withdraw from a share group directly to your chain-level balance, use unlockFromShareGroup.