fiobank

Fio Bank API in Python.

Installation

From PyPI:

pip install fiobank

In case you have an adventurous mind, give a try to the source:

pip install git+https://github.com/honzajavorek/fiobank.git#egg=fiobank

Usage

First, get your API token.

Initialization of the client:

>>> from fiobank import FioBank
>>> client = FioBank(token='...', decimal=True)

Account information:

>>> client.info()
{
  'currency': 'CZK',
  'account_number_full': 'XXXXXXXXXX/2010',
  'balance': Decimal('42.00'),
  'account_number': 'XXXXXXXXXX',
  'bank_code': '2010'
}

Listing transactions within a period:

>>> gen = client.period('2013-01-20', '2013-03-20')
>>> list(gen)[0]
{
  'comment': 'N\xe1kup: IKEA CR, BRNO, CZ, dne 17.1.2013, \u010d\xe1stka  2769.00 CZK',
  'recipient_message': 'N\xe1kup: IKEA CR, BRNO, CZ, dne 17.1.2013, \u010d\xe1stka  2769.00 CZK',
  'user_identification': 'N\xe1kup: IKEA CR, BRNO, CZ, dne 17.1.2013, \u010d\xe1stka  2769.00 CZK',
  'currency': 'CZK',
  'amount': Decimal('-2769.0'),
  'instruction_id': 'XXXXXXXXXX',
  'executor': 'Vilém Fusek',
  'date': datetime.date(2013, 1, 20),
  'type': 'Platba kartou',
  'transaction_id': 'XXXXXXXXXX'
}

Getting transactions with account information in one request:

 >>> info, transactions = client.transactions('2013-01-20', '2013-03-20')
(
   {'currency': 'CZK', 'account_number_full': 'XXXXXXXXXX/2010', 'balance': 42.00, 'account_number': 'XXXXXXXXXX', 'bank_code': '2010'},
     <generator object _parse_transactions at 0x170c190>
)

Listing transactions from a single account statement:

>>> client.statement(2013, 1)  # 1 is January only by coincidence - arguments mean 'first statement of 2013'

Listing the latest transactions:

>>> client.last()  # return transactions added from last listing
>>> client.last(from_id='...')  # sets cursor to given transaction_id and returns following transactions
>>> client.last(from_date='2013-03-01')  # sets cursor to given date and returns following transactions

Getting the latest transactions with account information in one request:

 >>> info, transactions = client.last_transactions()
(
   {'currency': 'CZK', 'account_number_full': 'XXXXXXXXXX/2010', 'balance': 42.00, 'account_number': 'XXXXXXXXXX', 'bank_code': '2010'},
     <generator object _parse_transactions at 0x170c190>
)

Conflict Error

Fio API documentation (Section 8.3) states that a single token should be used only once per 30s. Otherwise, an HTTP 409 Conflict will be returned.

The client automatically retries throttling errors up to 3 times with exponential backoff. If all attempts fail, fiobank.ThrottlingError will be raised.

Notes

• Use decimal=True for money-safe Decimal values. Without it,

  amounts are parsed as float.

• Date arguments accept date, datetime, or ISO-like strings

  (e.g. YYYY-MM-DD and YYYY-MM-DDTHH:MM:SS).

Development

Install using uv:

git clone git@github.com:honzajavorek/fiobank.git
cd fiobank
uv sync

Then run tests:

uv run pytest

Releasing

Release flow is automated by GitHub Actions in .github/workflows/release.yml.

1. Bump the version in pyproject.toml using uv:

   uv version --bump patch  # or minor / major
   

2. Review and commit the version change:

   git commit -am "release vX.Y.Z"
   

3. Create and push a git tag for that version:

   git tag vX.Y.Z
   git push origin HEAD --tags
   

When the tag appears on GitHub, the release workflow builds and smoke-tests the package, then publishes it to PyPI automatically (for the honzajavorek/fiobank repository only).

The changelog is maintained in GitHub Releases.

License: ISC

© 2026 Honza Javorek <mail@honzajavorek.cz>

This work is licensed under the ISC license.