binance-futures-availability
DuckDB-based availability tracker for Binance USDT-Margined perpetual futures from Binance Vision S3.
Installation
pip install binance-futures-availability
Development installation:
git clone https://github.com/terrylica/binance-futures-availability.git
cd binance-futures-availability
pip install -e ".[dev]"
Usage
Python API
from binance_futures_availability.queries import SnapshotQueries, TimelineQueries
# Query symbols available on a specific date
with SnapshotQueries() as q:
symbols = q.get_available_symbols_on_date('<DATE>')
# Query availability timeline for a symbol
with TimelineQueries() as q:
timeline = q.get_symbol_availability_timeline('<SYMBOL>')
CLI
binance-futures-availability query snapshot <DATE>
binance-futures-availability query timeline <SYMBOL>
binance-futures-availability query range <START_DATE> <END_DATE>
Data Source
Source: Binance Vision S3
Coverage: UM-futures inception to present (daily granularity)
Database Schema
Table: daily_availability
| Column | Type | Description |
|---|---|---|
| date | DATE | Trading date |
| symbol | VARCHAR | Futures symbol |
| available | BOOLEAN | Data availability flag |
| file_size_bytes | BIGINT | ZIP file size from S3 |
| last_modified | TIMESTAMP | S3 upload timestamp |
| quote_volume_usdt | DOUBLE | Daily USDT trading volume |
| trade_count | BIGINT | Number of trades |
| open/high/low/close_price | DOUBLE | OHLC prices |
Primary Key: (date, symbol)
Full schema: availability-database.schema.json
GitHub Releases
Pre-built database and volume rankings published to GitHub Releases:
gh release download latest --pattern "availability.duckdb.gz"
gh release download latest --pattern "volume-rankings-timeseries.parquet"
Architecture Decisions
| ADR | Decision |
|---|---|
| 0001 | Daily table pattern |
| 0002 | DuckDB storage |
| 0003 | Strict error handling |
| 0005 | AWS CLI bulk operations |
| 0007 | Volume metrics collection |
| 0009 | GitHub Actions automation |
| 0010 | Dynamic symbol discovery |
| 0013 | Volume rankings archive |
| 0028 | Upsert integrity gate, daily volume |
Documentation
Development
./scripts/check.sh # ruff + format check + full test suite (the local quality gate)
License
1 maintainer
Metadata
1 maintainer
Release files for binance-futures-availability 1.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| binance_futures_availability-1.5.0.tar.gz | 261.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| binance_futures_availability-1.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 306.8 kB
Release files / binance_futures_availability-1.5.0.tar.gz
| Download URL | binance_futures_availability-1.5.0.tar.gz |
|---|---|
| Size | 261.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
44a32311e1e82982d4c9399ef68e713490d45ef3223d1682c6c154d8f850b936
|
|
BLAKE2b-256 checksum How to use checksums |
15d4e696c027e700cacc53c145d812aace74b17cb542b0c2cbc670f38686e51e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / binance_futures_availability-1.5.0-py3-none-any.whl
| Download URL | binance_futures_availability-1.5.0-py3-none-any.whl |
|---|---|
| Size | 45.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
99ad233f6d42df97235579f37cd08eee9d234ae80f7c8fc69f867d87a2324b3c
|
|
BLAKE2b-256 checksum How to use checksums |
8340cc5fdcae66e75538b05696f4bf98aaba05ef61a41269d13269e811e5e911
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
