Queries all MarginX borrowing-currency configurations. No query parameters. Pool field rename and value alignment are pending deployment; see the rollout note.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Returns the MarginX borrowing-currency configuration, including amount precision, borrowing and repayment limits, floating-pool availability, and floating and fixed-term rate options. This is a configuration view, not a particular group's borrowing capacity.
Rate limit: 10 requests per minute per API key.
Rollout note:
poolAvailableAmountreplacespoolRemainingAmount. The field rename and value alignment with Get Group Borrowable Assets are pending deployment. Until then, responses may still containpoolRemainingAmountwith a different value; use the group endpoint'sfloating.poolAvailableAmountwhen checking floating-pool availability.
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 | MarginX borrowing-currency configuration. |
| 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. |
Request parameters
No query parameters. The endpoint returns all configured currencies without pagination. Supplying currency, groupId, page or pageSize returns 100400.
For a specific group's borrowing capacity in a currency, use Get Group Borrowable Assets.
Response fields
| Field | Type | Description |
|---|---|---|
code | integer | 200 means success; any other value indicates an error. |
message | string | Result message. |
data.list | array of objects | Configured borrowing currencies. |
Currency configuration: data.list[]
data.list[]Amounts and prices are decimal strings. Amounts are in currency, not USD valuations.
| Field | Type | Description |
|---|---|---|
currency | string | Currency symbol. |
currencyDetails | object or null | Currency metadata; see below. |
precision | integer | Maximum number of decimal places for borrowing and repayment quantities. |
canBorrow | boolean | Currency-level borrowing switch. A corresponding enabled borrowing term is also required. |
minBorrowAmountPerRequest | string or null | Minimum borrowing quantity per request. |
minRepayAmountPerRequest | string or null | Minimum repayment quantity per request. |
maxBorrowPerGroup | string or null | Configured borrowing cap for this currency per group, not the group's remaining borrowing capacity. |
poolAvailableAmount | string or null | Available quantity in this currency's floating borrowing pool, aligned with floating.poolAvailableAmount in the group endpoint after rollout. Not a fixed-term pool balance or the customer's borrowing limit. See the rollout note for current responses. |
price | string or null | USD price of one unit of currency. |
borrowTerms | array of objects | Floating and fixed-term configurations, including disabled terms. |
A currency may have canBorrow=true while floating borrowing is disabled and fixed-term borrowing remains enabled. An enabled floating term can also have zero pool availability. To assess whether a group can borrow, check its currency-specific capacity and limits using the group endpoint.
Borrowing term: borrowTerms[]
borrowTerms[]| Field | Type | Description |
|---|---|---|
interestRateType | string | FLOATING or FIXED. |
termDays | integer or null | Fixed-term duration in days, such as 30, 60 or 180. null for floating borrowing. |
annualInterestRate | string or null | Current annual rate as a decimal: "0.0401" means 4.01% annually. May be null for an unavailable floating term. A configured rate on a disabled term does not make that term available. |
nextAnnualInterestRateEstimate | string or null | Floating annual-rate estimate for the next UTC 00:00 rate reset. Updated hourly as the next reset approaches; null when unavailable. Always null for fixed terms. |
enabled | boolean | Whether this term is enabled. Borrowing also requires canBorrow=true. |
updatedAt | integer or null | Rate update time in Unix milliseconds, when available. |
The effective floating rate resets daily at UTC 00:00. Hourly forecast updates do not replace the current effective rate. Fixed-term quotes are indicative; the actual fixed rate is determined when funds are disbursed.
Unlike the group endpoint, this configuration endpoint retains disabled fixed terms and their configured rates. For example, a currency can return 30-, 60- and 180-day fixed terms here while only the enabled 30-day term appears in the group endpoint.
currencyDetails
currencyDetails| Field | Type | Description |
|---|---|---|
id | integer | Currency identifier. |
iconUrl | string | Currency icon URL. |
currencyName | string | Currency display name. |
slug | string | Currency slug. |
referenceAssetId | integer or null | Reference asset identifier. |
multiplier | number or null | Conversion multiplier to the reference asset. |
The response panel contains a four-currency example of the aligned response and the current pre-alignment response. Unavailable rate forecasts remain null in both examples.
Error codes
Errors can return HTTP 200 with a non-success JSON code. Check both HTTP status and JSON code. See Error Codes for shared errors.
| Code | When it occurs | What to do |
|---|---|---|
100400 | Unsupported query parameters are supplied. | Send no query parameters. |
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. |