Leverage (margin)
The Trader API exposes margin (leverage) endpoints so you can enable margin, create and repay margin loans, and view history. Use your Trader API credentials; paths and base are on the Standard API page. Full request/response details are in the Margin Trading spec. Use your Trader API bearer token; see Authentication.
By applying for a margin account or engaging in margin trading, you agree to the applicable terms and accept the risks of these services. Read the full disclosure here.
Request sequence
Call the endpoints in this order when building a margin flow:
| Step | Action | Request |
|---|---|---|
| 1 | Enable margin (per location) | POST /api/v1/margin |
| 2 | Fund the account | In-app (USD/crypto) only; no API for traders |
| 3 | Create a margin loan | POST /api/v2/margin/loan |
| 4 | Repay loans | POST /api/v2/margin/payment |
| 5 | View balances and history | See Margin Trading spec (loan balances, payment history, loan history, leverage pools, liquidations) |
Steps 3–4 can be repeated; step 5 can be called anytime to monitor state.
1. Enable margin
Enable margin for the account per location (e.g. US, CAYMAN) via the web or mobile app.
2. Fund the account
Fund the trading account so you have an initial margin balance. For traders, bring in collateral via in-app funding (USD/crypto) only; there is no API for funding in this persona.
Figure Markets offers leverage up to 4:1 for spot markets. A full list of collateral currencies is on the website.
3. Create a margin loan
Create loan: POST /api/v2/margin/loan
Provide a unique id (request is idempotent by this id), leveragePoolId, amount (decimal number, greater than zero), and loanType (e.g. MARGIN). Use a pool id from when you enabled margin or from leverage-pool endpoints in the Margin Trading spec. Funds are credited to your trading account and appear in positions/balances as spendable.
Example body:
{
"id": "7eb025fa-1ea8-49c5-90d8-5eb1ea6d251c",
"amount": 5000,
"leveragePoolId": "3229a80e-6400-4afe-a15e-c4b4652ff574",
"loanType": "MARGIN"
}
4. Repay loans
Make a loan payment: POST /api/v2/margin/payment
Provide a unique payment id (idempotent), leveragePoolId, and amount (decimal number). Payments are scheduled, not taken immediately; they are applied at the top of the hour using available trading power. Interest accrues hourly; make payments as needed to stay within LTV.
Example body:
{
"id": "c37610fb-ba74-4fc0-b03a-31eaff70c969",
"amount": 1000,
"leveragePoolId": "3229a80e-6400-4afe-a15e-c4b4652ff574"
}
5. Loan balances and history
For outstanding loan balances, payment history, loan history, leverage pools, and liquidations, see the full Margin Trading spec.
Margin call and liquidation
- Margin calls: If the value of your collateral falls below the required LTV ratio during a settlement interval, your account may go into default. A margin call occurs when account value falls below the required LTV threshold.
- Automatic liquidation: If LTV exceeds the specified threshold within the settlement period, the Exchange may automatically liquidate assets in your account to restore the required LTV ratio. Forced liquidation can result in losses greater than the collateral you provided.
It is your responsibility to keep LTV within limits.