Binance API Trading Rules

In order to provide a better API trading environment, Binance has published the risk control indicators for user API behavior assessment.

The indicators are: Unfilled Ratio (UFR), IOC/FOK Expiration Ratio (IFER), and GTC Cancellation Ratio (GCR)

1. Indicator Descriptions

1) Unfilled Ratio (UFR)

• UFR = 1 - (Total Filled Quantity / Total Submitted Order Quantity)
• Total Filled Quantity: Total value of all orders filled
• Total Submitted Order Quantity:  Total value of all orders submitted
• The ratio is calculated independently for each trading pair based on all orders during the time interval stated in Table 2.1

2) IOC/FOK Expiration Ratio (IFER)

• IFER = Total Number of Expired Orders / Total Number FOK or IOC Orders
• FOK or IOC Orders: Order’s Time in Force is either FOK or IOC
• Expired Orders: FOK or IOC orders on ‘expired’ status with zero filled quantity
• The ratio is calculated independently for each trading pair based on all FOK or IOC orders during the time interval stated in Table 2.1

3) GTC Cancellation Ratio (GCR)

• GCR = Total number of Fully-Cancelled Orders / Total Number of GTC Orders
• GTC Orders: Order’s Time in Force is GTC
• Fully-Cancelled Orders: Order’s Time in Force is GTC, the order status is cancelled or expired, total filled amount equals to zero, and the time gap between order submit and order cancel is less than 2.5 seconds
• The ratio is calculated independently for each trading pair based on all GTC orders during the time interval stated in Table 2.1

4) Number of Bans within 24 hours

• Number of Bans within 24 hours = Number of bans issued by the API risk control system in the past 24 hour time frame across ALL trading pairs traded

2. Trigger Conditions

• Each Trigger Condition is checked independently for each trading pair.
  
• Breaking through single (or multiple) Trigger Conditions will result in a trading ban for ALL trading pairs. You may find additional information in Section 3, "API Usage Ban".

Table 2.1: Indicator reference table

3. API Usage Ban

During the banned period by the API Risk Control System, users cannot create new API keys or use the API to create new orders. Submitting and cancelling orders via UI clients and canceling orders via the API is allowed. Users will be notified by email whenever their API usage triggers the risk control system and is banned by the system.

4. Indicator Information

Users can query the indicator parameters of each trading pair via the API; please refer to corresponding API documentation.

An account that has a ban will receive a -2015 error code when using trading endpoints.

The reason for the ban can be queried from the Account Status WAPI endpoint while the account is banned.

Binance will periodically update the indicator reference based on market conditions.

Updated:2019/01/21

Links
API Documentation: https://github.com/binance-exchange/binance-official-api-docs
API Sample Code: https://github.com/binance-exchange
API Risk Control Rules: Account API Trading Status
API Group: https://t.me/binance_api_english