Skip to main content
In PORTFOLIO mode, contracts within a share group draw margin from a shared pool rather than individual per-MD balances. Use 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.
Your account must be in PORTFOLIO mode to use share groups. Switch modes first with setMarginShareType.

​
Endpoint

​
Request

Every request must carry an ECDSA signature and a nonce to prevent replay attacks.

​
Action parameters

​
int32
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
The ID of the target share group. Funds are credited to this group’s shared margin pool.
​
int32
required
The coin or currency ID to transfer.
​
string
required
The amount to transfer, expressed as a raw integer string (e.g. "1000"). Must be greater than zero and must not exceed the withdrawable amount on the source deployer. Decimals are not accepted — use the coin’s smallest unit.

​
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.

​
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 server-assigned integer errorCode and a human-readable errorMessage are populated while the numeric amount and balance fields are set to 0. Common causes include:
  • Amount exceeds withdrawable balance on the MD — position IM and frozen order margin on the source deployer constrain how much can be moved.
  • Account not in PORTFOLIO mode — share groups are only active when your margin share type is 1.
  • Invalid groupId — the specified share group must exist and be accessible to your account.
  • Amount ≤ 0 — the amount field must be a positive integer string.
To move funds in the opposite direction — from a share group back to a market deployer — use transferShareGroupToMd. To fund a share group directly from your chain-level balance, use lockIntoShareGroup.