invest-api-java-sdk icon indicating copy to clipboard operation
invest-api-java-sdk copied to clipboard

Tinkoff Invest API Java SDK

Version Release License GitHub Actions Status

Java SDK для Tinkoff Invest API

Данный проект представляет собой инструментарий на языке Java для работы с API Тинькофф Инвестиции, который можно использовать для создания торговых роботов.

Пререквизиты

  • Java версии не ниже 11
  • Maven версии не ниже 3, либо Gradle версии не ниже 5.0

Использование

Для начала работы подключите к вашему проекту core-модуль

Система сборки Код
Maven <dependency>
      <groupId>ru.tinkoff.piapi</groupId>
      <artifactId>java-sdk-core</artifactId>
      <version>1.5</version>
</dependency>
Gradle with Groovy DSL implementation 'ru.tinkoff.piapi:java-sdk-core:1.5'
Gradle with Kotlin DSL implementation("ru.tinkoff.piapi:java-sdk-core:1.5")

После этого можно пользоваться инструментарием

import ru.tinkoff.piapi.core.InvestApi;

var token = "<secret-token>";
var api = InvestApi.create(token);

var order = api.getOrdersService().postOrderSync(...)

Сборка

JVM

Для сборки перейдите в директорию проекта и выполните одну из следующих команд

Система сборки Код
Maven mvn clean package
Gradle gradle clean build

Native

Для сборки native образа потребуется добавить зависимость от native-image-support в свой проект:

Maven:

<dependency>
 <groupId>com.google.cloud</groupId>
 <artifactId>native-image-support</artifactId>
 <version>0.14.1</version>
</dependency>

Gradle:

implementation 'com.google.cloud:native-image-support:0.14.1'

К аргументам сборки GraalVM необходимо добавить:

--initialize-at-build-time=ch.qos.logback,org.slf4j.LoggerFactory,org.slf4j.simple.SimpleLogger,org.slf4j.impl.StaticLoggerBinder,org.slf4j.MDC

Предложения и пожелания к SDK

Смело выносите свои предложения в Issues, задавайте вопросы. Pull Request'ы также принимаются.

У меня есть вопрос по работе API

Документация к API находится в отдельном репозитории. Там вы можете задать вопрос в Issues.