Skip to main content

Easy Python data downloader & reader of brazilian Tesouro Direto

Project description

tddata - easly download & read brazilian Tesouro Direto's data

GitHub GitHub Workflow Status Coveralls github

tddata is a simple Python package to download and read Brazil's bonds data from Tesouro Direto program.

1. Install

pip install it! As simple as that! :)

pip install git+

2. Usage

2.1 The td-download CLI utility

This package comes with a Command - Line Interface(CLI) that makes downloading Tesouro Direto's data easier.

The syntax is as follows:

td-download {bond_name} {year} [-o|--output OUTPUT/DIRECTORY/PATH]

2.2 The tddata Python package

Import the package with:

import tddata

Before you start to work the data, you need to download it to your local machine.

# Download LFT bond data from years 2002-2020 and save at ~/DATA/TD/LFT
# The file is saved with the following name pattern: {bond_name}_{year}.xls
for year in range(2002, 2021):"LFT", year=year, dest_path="~/DATA/TD/LFT")

Now you can read the data. Because the data in these downloaded files aren't in a data scientist aware format, tddata provides functions to read it correctly.

The most basic is read_file() that reads only one file at a time:

# Read data file of LFT bond from year 2019
lft2019 = tddata.read_file("~/DATA/TD/LFT/LFT_2019.xls")

The functions read_directory() and read_tree reads an entire directory and an entire tree of directories respectively, returning all data in one Pandas DataFrame.

# Read data directory
lft = tddata.read_directory("~/DATA/TD/LFT")

# Read data tree directory recursively
td = tdtddata.read_tree("~/DATA/TD")

3. Examples

In the example below we plot the daily yields of LTN bonds from 2016-01-01 to 2020-05-05

import matplotlib.pyplot as plt
import seaborn as sns

import tddata

ltn = tddata.read_directory("/DATA/TD/LTN")

# Filter data by date and create a new column with the bond's year of maturity
ltn = ltn[ltn["RefDate"] >= "2016-01-01"]
ltn = ltn.assign(

# Now plot the data with matplotlib and seaborn
# With the hue argument we plot each year of maturity by a diferent lines and colors
f, ax = plt.subplots()
f.set_size_inches(16, 8)
ax.set_title("LTN Daily Yield")

Chart showing LTN daily rates

4. License

This project is licensed under the MIT License.

See LICENSE to see the full text.

Data Source: all data are downloaded from STN.

Project details

Download files

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

Files for tddata, version 0.1.3
Filename, size File type Python version Upload date Hashes
Filename, size tddata-0.1.3-py3-none-any.whl (10.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size tddata-0.1.3.tar.gz (10.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page