The Binance Margin Trading API allows developers to programmatically access cross-margin and isolated-margin trading functionality. Users can borrow assets, place leveraged trades, repay loans, and manage margin account balances. The API provides endpoints for transferring assets between spot and margin accounts, querying interest rates and borrow limits, and monitoring margin level and liquidation thresholds for risk management purposes.
openapi: 3.1.0
info:
title: Binance Margin Trading API
description: >-
The Binance Margin Trading API allows developers to programmatically
access cross-margin and isolated-margin trading functionality. Users
can borrow assets, place leveraged trades, repay loans, and manage
margin account balances.
version: '1'
contact:
name: Binance Support
url: https://www.binance.com/en/support
termsOfService: https://www.binance.com/en/terms
externalDocs:
description: Binance Margin Trading Documentation
url: https://developers.binance.com/docs/margin_trading/general-info
servers:
- url: https://api.binance.com
description: Production Server
tags:
- name: Borrow/Repay
description: >-
Endpoints for borrowing and repaying margin assets.
- name: Trading
description: >-
Margin order trading endpoints.
- name: Account
description: >-
Margin account information and transfer endpoints.
security:
- apiKey: []
paths:
/sapi/v1/margin/borrow-repay:
post:
operationId: marginBorrowRepay
summary: Margin borrow or repay
description: >-
Borrow or repay assets in margin account. Unified endpoint for
both cross margin and isolated margin borrowing and repayment.
tags:
- Borrow/Repay
parameters:
- name: asset
in: query
required: true
description: >-
Asset to borrow or repay.
schema:
type: string
- name: isIsolated
in: query
description: >-
Whether this is for isolated margin. TRUE or FALSE.
schema:
type: string
enum: ['TRUE', 'FALSE']
- name: symbol
in: query
description: >-
Required for isolated margin.
schema:
type: string
- name: amount
in: query
required: true
description: >-
Amount to borrow or repay.
schema:
type: string
- name: type
in: query
required: true
description: >-
BORROW or REPAY.
schema:
type: string
enum: [BORROW, REPAY]
- name: recvWindow
in: query
schema:
type: integer
- name: timestamp
in: query
required: true
schema:
type: integer
format: int64
- name: signature
in: query
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
tranId:
type: integer
format: int64
description: >-
Transaction ID.
security:
- apiKey: []
hmacSignature: []
/sapi/v1/margin/borrow-repay:
get:
operationId: getBorrowRepayRecords
summary: Query borrow/repay records
description: >-
Query margin borrow and repay records.
tags:
- Borrow/Repay
parameters:
- name: asset
in: query
description: >-
Asset to query.
schema:
type: string
- name: isolatedSymbol
in: query
description: >-
Isolated margin symbol.
schema:
type: string
- name: type
in: query
required: true
description: >-
BORROW or REPAY.
schema:
type: string
enum: [BORROW, REPAY]
- name: startTime
in: query
schema:
type: integer
format: int64
- name: endTime
in: query
schema:
type: integer
format: int64
- name: current
in: query
description: >-
Current page. Default 1.
schema:
type: integer
default: 1
- name: size
in: query
description: >-
Page size. Default 10, max 100.
schema:
type: integer
default: 10
maximum: 100
- name: recvWindow
in: query
schema:
type: integer
- name: timestamp
in: query
required: true
schema:
type: integer
format: int64
- name: signature
in: query
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
rows:
type: array
items:
type: object
total:
type: integer
security:
- apiKey: []
hmacSignature: []
/sapi/v1/margin/order:
post:
operationId: createMarginOrder
summary: Margin account new order
description: >-
Place a new order for margin account.
tags:
- Trading
parameters:
- name: symbol
in: query
required: true
schema:
type: string
- name: isIsolated
in: query
description: >-
TRUE for isolated margin, FALSE for cross margin.
schema:
type: string
enum: ['TRUE', 'FALSE']
- name: side
in: query
required: true
schema:
type: string
enum: [BUY, SELL]
- name: type
in: query
required: true
schema:
type: string
enum: [LIMIT, MARKET, STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT, LIMIT_MAKER]
- name: quantity
in: query
schema:
type: string
- name: quoteOrderQty
in: query
schema:
type: string
- name: price
in: query
schema:
type: string
- name: stopPrice
in: query
schema:
type: string
- name: newClientOrderId
in: query
schema:
type: string
- name: newOrderRespType
in: query
schema:
type: string
enum: [ACK, RESULT, FULL]
- name: timeInForce
in: query
schema:
type: string
enum: [GTC, IOC, FOK]
- name: sideEffectType
in: query
description: >-
NO_SIDE_EFFECT, MARGIN_BUY, or AUTO_REPAY.
schema:
type: string
enum: [NO_SIDE_EFFECT, MARGIN_BUY, AUTO_REPAY, AUTO_BORROW_REPAY]
- name: recvWindow
in: query
schema:
type: integer
- name: timestamp
in: query
required: true
schema:
type: integer
format: int64
- name: signature
in: query
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
security:
- apiKey: []
hmacSignature: []
get:
operationId: getMarginOrder
summary: Query margin account order
description: >-
Query a margin account order.
tags:
- Trading
parameters:
- name: symbol
in: query
required: true
schema:
type: string
- name: isIsolated
in: query
schema:
type: string
- name: orderId
in: query
schema:
type: integer
format: int64
- name: origClientOrderId
in: query
schema:
type: string
- name: recvWindow
in: query
schema:
type: integer
- name: timestamp
in: query
required: true
schema:
type: integer
format: int64
- name: signature
in: query
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
security:
- apiKey: []
hmacSignature: []
delete:
operationId: cancelMarginOrder
summary: Cancel margin account order
description: >-
Cancel an active margin order.
tags:
- Trading
parameters:
- name: symbol
in: query
required: true
schema:
type: string
- name: isIsolated
in: query
schema:
type: string
- name: orderId
in: query
schema:
type: integer
format: int64
- name: origClientOrderId
in: query
schema:
type: string
- name: recvWindow
in: query
schema:
type: integer
- name: timestamp
in: query
required: true
schema:
type: integer
format: int64
- name: signature
in: query
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
security:
- apiKey: []
hmacSignature: []
/sapi/v1/margin/openOrders:
get:
operationId: getMarginOpenOrders
summary: Query margin account open orders
description: >-
Get all open margin orders for a symbol.
tags:
- Trading
parameters:
- name: symbol
in: query
schema:
type: string
- name: isIsolated
in: query
schema:
type: string
- name: recvWindow
in: query
schema:
type: integer
- name: timestamp
in: query
required: true
schema:
type: integer
format: int64
- name: signature
in: query
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
type: object
security:
- apiKey: []
hmacSignature: []
/sapi/v1/margin/account:
get:
operationId: getMarginAccountInfo
summary: Query cross margin account details
description: >-
Get cross margin account details including balances and margin
level.
tags:
- Account
parameters:
- name: recvWindow
in: query
schema:
type: integer
- name: timestamp
in: query
required: true
schema:
type: integer
format: int64
- name: signature
in: query
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
borrowEnabled:
type: boolean
description: >-
Whether borrowing is enabled.
marginLevel:
type: string
description: >-
Current margin level.
totalAssetOfBtc:
type: string
description: >-
Total asset value in BTC.
totalLiabilityOfBtc:
type: string
description: >-
Total liability in BTC.
totalNetAssetOfBtc:
type: string
description: >-
Total net asset in BTC.
tradeEnabled:
type: boolean
description: >-
Whether trading is enabled.
transferEnabled:
type: boolean
description: >-
Whether transfers are enabled.
accountType:
type: string
description: >-
Account type.
userAssets:
type: array
items:
type: object
properties:
asset:
type: string
borrowed:
type: string
free:
type: string
interest:
type: string
locked:
type: string
netAsset:
type: string
description: >-
User asset balances.
security:
- apiKey: []
hmacSignature: []
/sapi/v1/margin/transfer:
post:
operationId: marginTransfer
summary: Cross margin account transfer
description: >-
Execute a transfer between spot and cross margin accounts.
tags:
- Account
parameters:
- name: asset
in: query
required: true
schema:
type: string
- name: amount
in: query
required: true
schema:
type: string
- name: type
in: query
required: true
description: >-
1 for spot to margin, 2 for margin to spot.
schema:
type: integer
enum: [1, 2]
- name: recvWindow
in: query
schema:
type: integer
- name: timestamp
in: query
required: true
schema:
type: integer
format: int64
- name: signature
in: query
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
tranId:
type: integer
format: int64
description: >-
Transaction ID.
security:
- apiKey: []
hmacSignature: []
/sapi/v1/margin/interestRateHistory:
get:
operationId: getInterestRateHistory
summary: Query margin interest rate history
description: >-
Get margin interest rate history for an asset.
tags:
- Account
parameters:
- name: asset
in: query
required: true
schema:
type: string
- name: vipLevel
in: query
schema:
type: integer
- name: startTime
in: query
schema:
type: integer
format: int64
- name: endTime
in: query
schema:
type: integer
format: int64
- name: recvWindow
in: query
schema:
type: integer
- name: timestamp
in: query
required: true
schema:
type: integer
format: int64
- name: signature
in: query
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
type: object
properties:
asset:
type: string
dailyInterestRate:
type: string
timestamp:
type: integer
format: int64
vipLevel:
type: integer
security:
- apiKey: []
hmacSignature: []
components:
securitySchemes:
apiKey:
type: apiKey
in: header
name: X-MBX-APIKEY
hmacSignature:
type: apiKey
in: query
name: signature