Leverage (margin)
The Partner API exposes margin (leverage) endpoints so you can enable margin on your account(s), create and repay margin loans, and view history. This is the only borrowing flow available to partners via the Partner API. Full request/response details are in the Partner API OpenAPI spec — Margin Trading.
By applying for a margin account or engaging in margin trading, you agree to the applicable terms and user agreements 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 | Via Accounts (crypto) or in-app (USD); no Partner API call for funding itself |
| 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).
Enable margin: POST /api/v1/margin
Example body:
{
"location": "US"
}
Use the location that applies to your account.
2. Fund the account
Fund the trading account so you have an initial margin balance. You can bring in collateral by:
- Crypto — Use Receive crypto (Accounts: generate crypto deposit address).
- USD (US entities) — In the app, use Funding & transfers to deposit USD via ACH or wire.
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), the target pool’s leveragePoolId (uuid), amount (decimal number, must be greater than zero), and loanType (e.g. MARGIN for on-platform margin). Use a leveragePoolId returned when you enabled margin or from leverage-pool listing 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), the loan’s 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.