Tinkoff Invest Python SDK

The Tinkoff Invest API provides two environments:

• Production (INVEST_GRPC_API): For executing real orders on the exchange.
• Sandbox (INVEST_GRPC_API_SANDBOX): For testing API calls and trading hypotheses in an emulator without real market impact.

To switch environments, pass the desired constant to the target parameter when initializing the Client.

from tinkoff.invest import Client
from tinkoff.invest.constants import INVEST_GRPC_API

TOKEN = 'token'

# Using INVEST_GRPC_API for production or INVEST_GRPC_API_SANDBOX for sandbox
with Client(TOKEN, target=INVEST_GRPC_API) as client:
    print(client.users.get_accounts())

Before running any examples or using the library, you must add your Tinkoff Invest API token to your environment variables. This allows the client to authenticate your requests.

Set the INVEST_TOKEN variable in your terminal session:

$ export INVEST_TOKEN=YOUR_TOKEN

Install the client using pip to start interacting with the Tinkoff Invest trading platform.

$ pip install tinkoff-investments

For testing strategies without risking real money, use a Sandbox token. A Sandbox is a virtual environment where price and stream data match the real market, but your portfolio and orders are simulated.

You can obtain a token via the Tinkoff Invest Open API documentation: https://www.tinkoff.ru/invest/open-api/

# sandbox token
token = "YOUR_SANDBOX_TOKEN"

Demonstrates using a synchronous client with retry logic to fetch and print minute-interval candle data.

# See examples/retrying_client.py for implementation

Demonstrates how to subscribe to a real-time stream of minute candles and print the incoming data to the console using an asynchronous stream client.

# See examples/async_stream_client.py for implementation

Demonstrates how to download the full history of minute-interval candles for a specific instrument.

# See examples/download_all_candles.py for implementation

A utility example for implementing error logging within your application using the library.

# See examples/logger.py for implementation

Demonstrates how to resolve a ticker symbol to its corresponding FIGI (Financial Instrument Global Identifier).

# See examples/wiseplat_get_figi_for_ticker.py for implementation

Demonstrates how to create a specific type of order: a Take-Profit Stop order.

# See examples/wiseplat_create_take_profit_stop_order.py for implementation

Demonstrates an easy-to-use asynchronous subscription to a stream of minute candles.

# See examples/easy_async_stream_client.py for implementation