Bondana Client
Неофициальная обертка официального Tinkoff Invest API v2, оптимизированная для торговли облигациями на языке Python.
:warning: На данный момент отлажена работа на облигациях номиналом 1000 рублей, на других номиналах не тестировалось
Установка клиента
$ pip install bondana-client
Как пользоваться
Инициализация клиента
from bondana_client import Bondana
TOKEN = 'token'
client = Bondana(TOKEN)
Получить баланс свободных денег в рублях
balance_rub, blocked = client.get_balance('rub')
Получение списка бумаг в портфеле
client.portfolio.portfolio_get()
for bond in portfolio.positions:
print(bond)
Получение истории операций
from datetime import datetime, timedelta
nw = datetime.now() - timedelta(days=1) # получим сделки за последний день
d1 = datetime(nw.year, nw.month, nw.day, 0, 0, 0, tzinfo=timezone('Europe/Moscow'))
d2 = datetime.now(tz=timezone('Europe/Moscow'))
ops = client.operations.operations_get(limit=1000, from_=d1, to=d2)
ops.reverse()
for op in ops:
print(op.get("figi"), op.get("price"), op.get("payment"), op.get("quantity"))
Постановка лимитной заявки
# лимитная заявка на покупку
lots = 1
price = 987.65
figi = "BBG00Y9B45C2"
order_limit = client.orders.orders_limit_order_post(figi,
limit_order_request = {"lots": lots, "operation": "Buy", "price":price, })
# лимитная заявка на продажу
lots = 1
price = 997.65
figi = "BBG00Y9B45C2"
order_limit = client.orders.orders_limit_order_post(figi,
limit_order_request = {"lots": lots, "operation": "Sell", "price":price, })
Получение списка активных заявок
client.orders.orders_get() # список заявок в формате объектов Tinkoff API
client.orders.orders_get_json() # список заявок в формате JSON
for order in client.orders.orders_get_json():
print(order.get("order_id"), order.get("operation"), order.get("figi"))
Отмена заявки на покупку
# последовательная отмена всех активных заявок, для примера
for order in client.orders.orders_get_json():
client.orders.orders_cancel_post(order.get("order_id"))
Просмотр стакана по figi
figi = "BBG00Y9B45C2"
orderbook = client.market.market_orderbook_get_dict(figi, 20)
Получение списка всех доступных облигаций
bonds = client.market.market_bonds_get()
for bond in bonds:
print(bond)
Получение свечей
candles = client.market.candles(figi, from_, to, interval, candle_source_type)
for candle in candles:
print(candle)
TODO:
получение лотности
шаг цены
Metadata
Release files for bondana-client 2025.8.25062617
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| bondana_client-2025.8.25062617.tar.gz | 6.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| bondana_client-2025.8.25062617-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 12.6 kB
Release files / bondana_client-2025.8.25062617.tar.gz
| Download URL | bondana_client-2025.8.25062617.tar.gz |
|---|---|
| Size | 6.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2f0512ddcda6973b58147c92814fb1be46e10d7b47b6deff767b5f815ebc81a2
|
|
BLAKE2b-256 checksum How to use checksums |
dcd31b955a645154b2ce8c76be649fc5e93a4b7b328851de1317f79ef981209f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / bondana_client-2025.8.25062617-py3-none-any.whl
| Download URL | bondana_client-2025.8.25062617-py3-none-any.whl |
|---|---|
| Size | 6.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
464cca9cc2b3c1f71a8d00152ba1156e527503534997e815526d3c21647cbd5e
|
|
BLAKE2b-256 checksum How to use checksums |
52aff0e3a62dbaa24afe8fa9e19732a6481e49fc17a60554a8990ecdd41f29b4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|