PHPackages                             fin/tinkoff-api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. fin/tinkoff-api

ActiveLibrary[API Development](/categories/api)

fin/tinkoff-api
===============

Library for working with Tinkoff GRPC

0207↓29.6%PHP

Since Nov 19Pushed 7mo ago2 watchersCompare

[ Source](https://github.com/MasyaSmv/TinkoffFinApi)[ Packagist](https://packagist.org/packages/fin/tinkoff-api)[ RSS](/packages/fin-tinkoff-api/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependenciesVersions (2)Used By (0)

TinkoffFinApi
=============

[](#tinkofffinapi)

TinkoffFinApi — это PHP-библиотека, упрощающая работу с Tinkoff API для различных FIN-проектов. Она содержит готовые классы и методы для удобного доступа к данным о счетах, операциях и другим ресурсам, а также обеспечивает быструю и легкую интеграцию с фреймворком Laravel.

---

Содержание
----------

[](#содержание)

- [Особенности](#%D0%BE%D1%81%D0%BE%D0%B1%D0%B5%D0%BD%D0%BD%D0%BE%D1%81%D1%82%D0%B8)
- [Установка](#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0)
- [Быстрый-start](#%D0%B1%D1%8B%D1%81%D1%82%D1%80%D1%8B%D0%B9-%D1%81%D1%82%D0%B0%D1%80%D1%82)
    - [Настройка клиента](#%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%BA%D0%BB%D0%B8%D0%B5%D0%BD%D1%82%D0%B0)
    - [Работа с ресурсами](#%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%B0-%D1%81-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81%D0%B0%D0%BC%D0%B8)
        - [Получение списка счетов](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D0%BF%D0%B8%D1%81%D0%BA%D0%B0-%D1%81%D1%87%D0%B5%D1%82%D0%BE%D0%B2)
        - [Получение конкретного счета](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BA%D0%BE%D0%BD%D0%BA%D1%80%D0%B5%D1%82%D0%BD%D0%BE%D0%B3%D0%BE-%D1%81%D1%87%D0%B5%D1%82%D0%B0)
        - [Работа с операциями](#%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%B0-%D1%81-%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%86%D0%B8%D1%8F%D0%BC%D0%B8)
            - [Получение всех операций](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B2%D1%81%D0%B5%D1%85-%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%86%D0%B8%D0%B9)
            - [Получение операции по ID](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%86%D0%B8%D0%B8-%D0%BF%D0%BE-id)
            - [Получение операций за период](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%86%D0%B8%D0%B9-%D0%B7%D0%B0-%D0%BF%D0%B5%D1%80%D0%B8%D0%BE%D0%B4)
            - [Получение операций через ресурс Account](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%86%D0%B8%D0%B9-%D1%87%D0%B5%D1%80%D0%B5%D0%B7-%D1%80%D0%B5%D1%81%D1%83%D1%80%D1%81-account)
        - [Работа с портфелями](#%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%B0-%D1%81-%D0%BF%D0%BE%D1%80%D1%82%D1%84%D0%B5%D0%BB%D1%8F%D0%BC%D0%B8)
            - [Получение всех портфелей](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B2%D1%81%D0%B5%D1%85-%D0%BF%D0%BE%D1%80%D1%82%D1%84%D0%B5%D0%BB%D0%B5%D0%B9)
            - [Получение портфеля по ID счета](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BF%D0%BE%D1%80%D1%82%D1%84%D0%B5%D0%BB%D1%8F-%D0%BF%D0%BE-id-%D1%81%D1%87%D0%B5%D1%82%D0%B0)
        - [Работа со свечами](#%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%B0-%D1%81%D0%BE-%D1%81%D0%B2%D0%B5%D1%87%D0%B0%D0%BC%D0%B8)
- [Обработка ошибок](#%D0%BE%D0%B1%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%BA%D0%B0-%D0%BE%D1%88%D0%B8%D0%B1%D0%BE%D0%BA)
- [Интеграция с Laravel](#%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F-%D1%81-laravel)
- [Структура проекта](#%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%82%D1%83%D1%80%D0%B0-%D0%BF%D1%80%D0%BE%D0%B5%D0%BA%D1%82%D0%B0)
- [Тестирование](#%D1%82%D0%B5%D1%81%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5)
- [Вклад в развитие](#%D0%B2%D0%BA%D0%BB%D0%B0%D0%B4-%D0%B2-%D1%80%D0%B0%D0%B7%D0%B2%D0%B8%D1%82%D0%B8%D0%B5)
- [Лицензия](#%D0%BB%D0%B8%D1%86%D0%B5%D0%BD%D0%B7%D0%B8%D1%8F)

---

Особенности
-----------

[](#особенности)

- **Управление API-токеном и соединением.** Библиотека предоставляет клиентский класс для хранения токена и настройки всех API-запросов.
- **Работа с ресурсами.** Специализированные классы (Resources) облегчают доступ к сущностям, таким как счета (Accounts) и операции (Operations).
- **Чёткие DTO-модели.** Объектные модели упрощают чтение и работу с данными, обеспечивая лучшую структуру.
- **Кастомные исключения.** Позволяют грамотно обрабатывать ошибки (например, при неверном или истекшем токене).
- **Интерфейсы.** Обеспечивают гибкую архитектуру и дают возможность при необходимости легко расширять функционал.
- **Интеграция с Laravel.** Сервис-провайдер для упрощения регистрации и использования библиотеки в вашем Laravel-приложении.
- **Тестирование.** Набор юнит- и функциональных тестов для проверки стабильности и корректности работы.

---

Установка
---------

[](#установка)

Установите библиотеку через [Composer](https://getcomposer.org/):

```
composer require fin/tinkoff-api
```

> **Примечание:** Убедитесь, что в вашем проекте уже установлен Composer. Если нет, перейдите по [ссылке](https://getcomposer.org/) и следуйте официальной инструкции.

---

Быстрый старт
-------------

[](#быстрый-старт)

### Настройка клиента

[](#настройка-клиента)

Подключите автозагрузчик Composer и создайте экземпляр клиента, передав в него API-токен:

```
