tvdata 0.1.0

A Python library and CLI for fetching and exporting enormous amounts of financial & candle data without limit.

TvData

🇫🇷 Version française

A Python library and CLI for fetching and exporting financial candle data, timeframes, and tickers from your custom API.

Features

• Fetch candle data in chunks and return as a Pandas DataFrame
• Export candle data as CSV via CLI
• List available timeframes and tickers
• Type hints everywhere for static analysis (compatible with mypy)
• Examples available in the examples/ folder

Installation

pip install TvData

Usage

Library

from tvdata import Client

client = Client()

# Get available timeframes
timeframes = client.fetch_timeframes()
print(timeframes)

# Get available tickers
tickers = client.fetch_tickers()
print(tickers)

df = client.fetch_candles(
    symbol=tickers[0],
    timeframe=timeframes[0],
    start=1700000000,
    end=1700003600,
    chunk_size=100,
)
print(df)

See more in examples/example_tvdata.py.

CLI

tvdata candles SYMBOL TIMEFRAME START END --csv output.csv
# Example:
tvdata candles "BINANCE:BTCUSDT" 1 1700000000 1700003600 --csv aapl_1m.csv

tvdata timeframes

tvdata tickers

Development

• Clone the repository
• Install dependencies: pip install -r requirements-dev.txt
• Run tests: pytest
• Check typing: mypy tvdata

License

MIT

---

🇫🇷 Version française

Une bibliothèque Python et une CLI pour récupérer et exporter des données de chandeliers, timeframes et tickers depuis votre API personnalisée.

Fonctionnalités

• Récupération des chandeliers en DataFrame Pandas (par lots)
• Export CSV via la CLI
• Liste des timeframes et tickers disponibles
• Typage partout pour l'analyse statique (compatible mypy)
• Exemples dans le dossier examples/

Installation

pip install TvData

Utilisation

Librairie

from tvdata import Client

client = Client()

# Récupérer les timeframes disponibles
timeframes = client.fetch_timeframes()
print(timeframes)

# Récupérer les tickers disponibles
tickers = client.fetch_tickers()
print(tickers)

candles = client.fetch_candles(
    symbol=tickers[0],
    timeframe=timeframes[0],
    start=1700000000,
    end=1700003600,
    chunk_size=100,
)
print(candles)

Voir plus dans examples/example_tvdata.py.

CLI

tvdata candles SYMBOL TIMEFRAME START END --csv output.csv
# Exemple :
tvdata candles AAPL 1m 1700000000 1700003600 --csv aapl_1m.csv

tvdata timeframes

tvdata tickers

Développement

• Clonez le dépôt
• Installez les dépendances : pip install -r requirements-dev.txt
• Lancez les tests : pytest
• Vérifiez le typage : mypy tvdata

Licence

MIT