Skip to main content

Bondana Client

PyPI - Python Version

Неофициальная обертка официального Tinkoff Invest API v2, оптимизированная для торговли облигациями на языке Python.

⚠️ На данный момент отлажена работа на облигациях номиналом 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.6.2064233

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bondana-client 2025.6.2064233
File Size Uploaded
bondana_client-2025.6.2064233.tar.gz 6.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for bondana-client 2025.6.2064233
File Interpreter ABI Platform
bondana_client-2025.6.2064233-py3-none-any.whl Python 3 none any Details

Total release size: 12.6 kB

Release files / bondana_client-2025.6.2064233.tar.gz

Download URL bondana_client-2025.6.2064233.tar.gz
Size 6.1 kB
Tags Source
SHA-256 checksum
How to use checksums
81f4b271d0b68cfb29fbfa4d091d84dde71ddbe45fe285f5b22e8783d72458c0
BLAKE2b-256 checksum
How to use checksums
4a634bb7c10a9e2bb75b50dc07a87d5b8fd8abf2ffae2bf597e8e1f7d9e12bd3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.3

Release files / bondana_client-2025.6.2064233-py3-none-any.whl

Download URL bondana_client-2025.6.2064233-py3-none-any.whl
Size 6.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1cfcb4c9d0f266bebff4aa8f656a3808525f8d44f302ebd1bd75291f9b5f49d9
BLAKE2b-256 checksum
How to use checksums
d93ee990a431514df36a396f6c0435b1c1e0391ac92b940af94cb77f2c19f017
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.3
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page