Skip to main content

No project description provided

Project description

GitHub last commit GitHub license<space><space> PyPI PyPI - Python Version

Short Overview.

binance_historical_data is a python package (py>=3.7) which makes dumping of historical crypto data from binance server as simple as possible. You don’t even need to have an account at binance.com to dump all history of crypto data

Using this package you will be able to have full binance historical data with only 3 lines of python code
And if you need to update already dumped data then once again 3 lines of python code will do the job
Limitations: The previous day data appear on binance server a few minutes after 0 a.m. UTC
So there is a delay in which you can get the data.

Installation via pip:

pip install binance_historical_data

How to use it

Init main object: data_dumper

from binance_historical_data import CandleDataDumper

data_dumper = CandleDataDumper(
    path_dir_where_to_dump=".",
    str_data_frequency="1m",
)

Arguments:

  1. path_dir_where_to_dump:
    (string) Path to folder where to dump the historical data
  2. str_data_frequency:
    (string) One of [1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h]

The main method to dump data

data_dumper.dump_data(
    list_tickers=None,
    date_start=None,
    date_end=None,
    is_to_update_existing=False,
)

Arguments:

  1. list_tickers=None:
    list
    Trading pairs for which to dump data
    if equals to None all USDT pairs will be used
  2. date_start=None:
    datetime.date
    The date from which to start dump
  3. date_end=True=None:
    datetime.date
    The last date for which to dump data
  4. is_to_update_existing=False:
    bool
    Flag if you want to update data if it’s already exists

Examples

How to dump all data for all USDT trading pairs

Please be advised that the first data dump for all trading pairs might take some time (~40 minutes)

data_dumper.dump_data()

How to update data dump and get all new data

data_dumper.dump_data()

How to update (reload) all data for the asked time period

data_dumper.dump_data(
    date_start=datetime.date(year=2021, month=1, day=1),
    date_end=datetime.date(year=2022, month=1, day=1),
    is_to_update_existing=True
)

How to get all trading pairs (tickers) from binance

print(data_dumper.get_list_all_trading_pairs())

Contacts

License

This project is licensed under the MIT License.

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

binance_historical_data-0.1.0.tar.gz (9.4 kB view hashes)

Uploaded Source

Built Distribution

binance_historical_data-0.1.0-py3-none-any.whl (9.0 kB view hashes)

Uploaded Python 3

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