Returns paginated DMA and RapidX members with their asset and debt valuations, including zero-asset members.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Returns a paginated list of a MarginX group's members and their asset and debt valuations. DMA accounts and RapidX Portfolio venues are returned together in data.list.
Rate limit: 10 requests per minute per API key.
API key access
Requires a signed LTP Open API request with READ permission. See Authentication.
| API key type | Can call | Scope |
|---|---|---|
| Main User Level API key (also the Main Portfolio key) | Yes | Members of margin groups belonging to the main user. |
| Sub-user Level API key | No | Not supported. |
| Dedicated Sub Portfolio Level API key | No | Not supported. |
| Exchange-native API key | No | Use an LTP Main User Level API key. |
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
groupId | Path | string | Yes | — | Margin group ID from Get Margin Groups or Create Margin Group. Not a DMA account ID or Portfolio ID. A positive integer expressed as a string. |
page | Query | integer | No | 1 | One-based page number. Zero, negative or empty values use 1. |
pageSize | Query | integer | No | 20 | Records per page, maximum 1000. Zero, negative or empty values use 20; a value above 1000 is rejected. |
quoteCurrency | Query | string | No | USD | Valuation currency: USD, BTC or USDT. Input is case-insensitive; response values are uppercase. Empty is invalid. |
sortBy | Query | string | No | totalValue | totalValue, borrowed, interest, adjustedEquity or accountName. Empty uses totalValue. |
sortDirection | Query | string | No | DESC | ASC or DESC. Input is case-insensitive. Empty uses DESC. |
Pagination and sorting
- Non-integer or out-of-range integer pagination values return
1002. An integerpageSizeabove1000returns100400. - A page beyond the last page returns
list: []while retaining the group'stotalSize. There is nopageNumfield. - Members are sorted before pagination. Equal sort values use the member identity (
primeType,memberId,venue) as a stable secondary key. - Invalid sort fields, directions or valuation currencies are rejected, not silently replaced with defaults.
- Retrieve every page when you need the complete membership. Do not submit only one page as the complete member set when updating a group.
Member identity and zero assets
A DMA member is identified by memberId, its DMA account ID. A RapidX member is identified by memberId (Portfolio ID) plus venue; the same Portfolio's Binance and OKX venues count as two members.
Every group has at least one member. Members with zero assets are still returned with zero amounts. This endpoint can return those members even when Get Margin Group Details has no asset/risk data and returns an error.
Response fields
| Field | Type | Description |
|---|---|---|
code | integer | 200 means success; any other value indicates an error. |
message | string | Result message. |
data.page | integer | Page number used. |
data.pageSize | integer | Page size used. |
data.totalSize | integer | Total member records in the group, not just the current page. |
data.list | array of objects | Members on this page. Empty when the requested page is beyond the end. |
Member fields: data.list[]
data.list[]Monetary fields are decimal strings valued in quoteCurrency, not quantities of an individual asset. Group-level borrowing capacity and risk metrics are not returned here.
| Field | Type | Description |
|---|---|---|
memberId | string | DMA account ID or RapidX Portfolio ID, according to primeType. Not a margin group ID. |
primeType | string | Account family: dma or rapidx. |
venue | string | Member's exchange, such as BINANCE, OKX or BYBIT. For RapidX, this identifies the Portfolio's exchange venue, not the value RAPIDX. |
accountName | string | Account/Portfolio display name. May also be populated for DMA accounts; empty when unavailable. |
accountNote | string | Account/Portfolio note; empty when unavailable. |
portfolioType | string | MAIN or SUB for a RapidX Portfolio; empty string for DMA. |
quoteCurrency | string | Currency used for the monetary valuations: USD, BTC or USDT. |
totalValue | string | Member's asset valuation. |
totalDebt | string | Member's outstanding principal and interest valuation. |
borrowed | string | Member's outstanding principal valuation. |
interest | string | Member's outstanding interest valuation. |
adjustedEquity | string | Member's equity after collateral adjustments. |
Success, beyond-last-page and error examples are available in the response panel.
Error codes
Errors can return HTTP 200 with a non-success JSON code. Check code, not HTTP status alone. See Error Codes for shared errors.
| Code | When it occurs | What to do |
|---|---|---|
1002 | A pagination value cannot be converted to a supported integer, such as abc, 1.5 or an out-of-range integer. | Send integer values. The message identifies the affected field. |
100400 | Invalid group ID, pageSize above 1000, or an invalid currency, sort field or direction. | Use the supported values above. |
-1 | The group is unavailable; observed message: Group unavailable. | Check the group ID and its availability to the main user. |
2000 | Signature verification fails. | Check the signature and authentication headers. |
2003 | The calling API key level is not allowed. | Use a Main User Level API key. |
2004 | The key lacks a required permission. | Use a key with READ permission. |
100429 | Rate limit exceeded. | Reduce the request rate. |