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
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.1.tar.gz (19.7 kB view details)

Uploaded Source

File details

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

File metadata

  • Download URL: BinanceWatch-0.1.1.tar.gz
  • Upload date:
  • Size: 19.7 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.1.tar.gz
Algorithm Hash digest
SHA256 767796b964295bda35ee6d9c7e11c560f4d0f9a53edcf565ca46881c8f8b6154
MD5 e06e959498045c36d756915f5bd29dec
BLAKE2b-256 377ee84cb06933dd30439b81bc27ed1df8d0c19f6e248114550cb500b663864f

See more details on using hashes here.

Supported by

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