Register on Binance¶
Firstly register an account with Binance.
Generate an API Key¶
To use signed account methods you are required to create an API Key.
Initialise the client¶
Pass your API Key and Secret
from binance.client import Clientclient = Client(api_key, api_secret)
or for Asynchronous client
async def main(): # initialise the client client = await AsyncClient.create(api_key, api_secret)if __name__ == "__main__": loop = asyncio.get_event_loop() loop.run_until_complete(main())
Using the Spot, Futures or Vanilla Options Testnet¶
Binance offers a Spot,Futuresand Vanilla Options Testnet,to test interacting with the exchange.
To enable this set the testnet parameter passed to the Client to True.
The testnet parameter will also be used by any websocket streams when the client is passed to the BinanceSocketManager.
client = Client(api_key, api_secret, testnet=True)
or for Asynchronous client
client = await AsyncClient.create(api_key, api_secret, testnet=True)
Using a different TLD¶
If you are interacting with a regional version of Binance which has a different TLD such as .us or `.jp’ then youwill need to pass this when creating the client, see examples below.
This tld will also be used by any websocket streams when the client is passed to the BinanceSocketManager.
client = Client(api_key, api_secret, tld='us')
or for Asynchronous client
client = await AsyncClient.create(api_key, api_secret, tld='us')
Making API Calls¶
Every method supports the passing of arbitrary parameters via keyword matching those in the Binance API documentation.These keyword arguments will be sent directly to the relevant endpoint.
Each API method returns a dictionary of the JSON response as per the Binance API documentation.The docstring of each method in the code references the endpoint it implements.
The Binance API documentation references a timestamp parameter, this is generated for you where required.
Some methods have a recvWindow parameter for timing security, see Binance documentation.
API Endpoints are rate limited by Binance at 20 requests per second, ask them if you require more.
Async API Calls¶
aiohttp is used to handle asyncio REST requests.
Each function available in the normal client is available in the AsyncClient class.
The only difference is to run within an asyncio event loop and await the function like below.
import asynciofrom binance import AsyncClientasync def main(): client = await AsyncClient.create() # fetch exchange info res = await client.get_exchange_info() print(json.dumps(res, indent=2)) await client.close_connection()if __name__ == "__main__": loop = asyncio.get_event_loop() loop.run_until_complete(main())
Read Async basics for Binancefor more information about asynchronous patterns.
API Rate Limit¶
Check the get_exchange_info() call for up to date rate limits.
At the current time Binance rate limits are:
- 1200 weights per minute
- 10 orders per second
- 100,000 orders per 24hrs
Some calls have a higher weight than others especially if a call returns information about all symbols.Read the official Binance documentation for specific information.
On each request Binance returns X-MBX-USED-WEIGHT-(intervalNum)(intervalLetter) and X-MBX-ORDER-COUNT-(intervalNum)headers.
Here are examples to access these
Asynchronous example
import asynciofrom binance import AsyncClientapi_key = '<api_key>'api_secret = '<api_secret>'async def main(): client = await AsyncClient.create(api_key, api_secret) res = await client.get_exchange_info() print(client.response.headers) await client.close_connection()if __name__ == "__main__": loop = asyncio.get_event_loop() loop.run_until_complete(main())
Synchronous example
from binance import Clientapi_key = '<api_key>'api_secret = '<api_secret>'def main(): client = Client(api_key, api_secret) res = client.get_exchange_info() print(client.response.headers)if __name__ == "__main__": main()
Requests Settings¶
python-binance uses the requests library.
You can set custom requests parameters for all API calls when creating the client.
client = Client("api-key", "api-secret", {"verify": False, "timeout": 20})
You may also pass custom requests parameters through any API call to override default settings or the above settingsspecify new ones like the example below.
# this would result in verify: False and timeout: 5 for the get_all_orders callclient = Client("api-key", "api-secret", {"verify": False, "timeout": 20})client.get_all_orders(symbol='BNBBTC', requests_params={'timeout': 5})
Check out the requests documentation for all options.
Proxy Settings
You can use the Requests Settings method above
proxies = { 'http': 'http://10.10.1.10:3128', 'https': 'http://10.10.1.10:1080'}# in the Client instantiationclient = Client("api-key", "api-secret", {'proxies': proxies})# or on an individual callclient.get_all_orders(symbol='BNBBTC', requests_params={'proxies': proxies})
Or set an environment variable for your proxy if required to work across all requests.
An example for Linux environments from the requests Proxies documentation is as follows.
$ export HTTP_PROXY="http://10.10.1.10:3128"$ export HTTPS_PROXY="http://10.10.1.10:1080"
For Windows environments
C:\>set HTTP_PROXY=http://10.10.1.10:3128C:\>set HTTPS_PROXY=http://10.10.1.10:1080
