Skip to main content

Local tracker of a binance account

Project description

Note

This library is under development by EtWnn, feel free to drop your suggestions or remarks in the discussion tab of the git repo. You are also welcome to contribute by submitting PRs.

This is an unofficial tracker for binance accounts. I am in no way affiliated with Binance, use at your own risk.

Source Code:

https://github.com/EtWnn/BinanceWatch

Documentation:

https://binancewatch.readthedocs.io/en/latest/

Features

If you used quite intensively Binance, it can take some time to retrieve everything that happened on your account. This library is made to save locally the events of your account so that you don’t need to fetch your history from the beginning every time.

It currently supports:

  • Spot Trades

  • Spot Crypto Deposits

  • Spot Crypto Withdraws

  • Spot Dividends

  • Spot Dusts

  • Universal Transfers

  • Lending Purchases

  • Lending Interests

  • Lending Redemptions

  • Cross Margin Trades

  • Cross Margin Repayment

  • Cross Margin Loans

  • Cross Margin Interests

Quick Tour

Generate an API Key in your binance account. Only read permissions are needed.

BinanceWatch is available on PYPI, install with pip:

pip install BinanceWatch

If you prefer to install the latest developments use:

pip install git+https://github.com/EtWnn/BinanceWatch.git@develop

Use your Binance api keys to initiate the manager:

from BinanceWatch.BinanceManager import BinanceManager

api_key = "<API_KEY>"
api_secret = "<API_SECRET>"

bm = BinanceManager(api_key, api_secret)

# fetch the latest spot trades from Binance
bm.update_all_spot_trades()
Out -> fetching BIFIBUSD: 100%|██████████████████████| 1349/1349 [06:24<00:00,  3.51it/s]
from datetime import datetime
from BinanceWatch.utils.time_utils import datetime_to_millistamp


start_time = datetime_to_millistamp(datetime(2018,1,1))

# get the locally saved spot trades made after 2018/01/01
spot_trades = bm.db.get_trades('spot', start_time=start_time)

You can also call update functions at an account-type level, and it will call every update methods related to this account-type:

bm.update_spot()  # (trades, transfers, deposits ...)

bm.update_cross_margin()  # (trades, loans, repays, interests...)

bm.update_lending()  # (purchases, interests, redemptions..)

Donation

If this library has helped you in any way, feel free to donate:

  • BTC: 14ou4fMYoMVYbWEKnhADPJUNVytWQWx9HG

  • ETH: 0xfb0ebcf8224ce561bfb06a56c3b9a43e1a4d1be2

  • LTC: LfHgc969RFUjnmyLn41SRDvmT146jUg9tE

  • EGLD: erd1qk98xm2hgztvmq6s4jwtk06g6laattewp6vh20z393drzy5zzfrq0gaefh

Known Issues:

Some endpoints are not yet provided by Binance, so they can’t be implemented in this library:

  • Fiat withdraws and deposits

  • Locked stacking history

  • Direct purchases with debit card

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

BinanceWatch-0.1.2.tar.gz (20.0 kB view details)

Uploaded Source

File details

Details for the file BinanceWatch-0.1.2.tar.gz.

File metadata

  • Download URL: BinanceWatch-0.1.2.tar.gz
  • Upload date:
  • Size: 20.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.7.3 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.7.9

File hashes

Hashes for BinanceWatch-0.1.2.tar.gz
Algorithm Hash digest
SHA256 425aa58c09cd1db317debb8bf602bed26a230b0163f0e79f9206950ae2804fb3
MD5 068fb291e1d8b0bb29c197ca1f44925a
BLAKE2b-256 83bf1878f13778f1ad53743cccbe2aa2eb9703dd95528f24b264dfc9b99936ce

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page