CosinnInvest API

REST API для институциональных инвесторов, фондов и финтех-партнёров. Авторизация через API-ключи с HMAC подписью.

REST API v1JSONHMAC-SHA256

Авторизация

Все запросы к API должны содержать заголовки авторизации:

X-API-Key: ci_xxxxxxxx...

X-Timestamp: 1700000000

X-Signature: HMAC-SHA256(timestamp + body)

Rate Limits

Free

100 req/min

Premium

1 000 req/min

Endpoints

GET/api/v1/contractsСписок контрактов с фильтрами и пагинацией

Разрешение: read

Параметры

Имя	Тип	Описание
`category`	string	Фильтр по категории
`min_return`	number	Минимальная доходность (%)
`risk_level`	string	Уровень риска: low, medium, high
`status`	string	Статус контракта (default: active)
`page`	number	Номер страницы (default: 1)
`per_page`	number	Записей на страницу (default: 20, max: 100)

GET/api/v1/contracts/:idДетали конкретного контракта по UUID

Разрешение: read

GET/api/v1/portfolioПортфель пользователя с инвестициями и сводкой

Разрешение: read

Параметры

Имя	Тип	Описание
`status`	string	Фильтр по статусу инвестиции

GET/api/v1/transactionsСписок транзакций пользователя

Разрешение: read

Параметры

Имя	Тип	Описание
`type`	string	Тип: deposit, withdrawal, investment, return, fee
`status`	string	Статус транзакции
`page`	number	Номер страницы (default: 1)
`per_page`	number	Записей на страницу (default: 20, max: 100)

POST/api/v1/investmentsСоздать инвестицию в контракт

Разрешение: write

Параметры

Имя	Тип	Описание
`contract_id`	string	ID контракта (UUID)
`amount`	number	Сумма инвестиции (₽)

GET/api/v1/portfolio/analyticsАналитика портфеля (IRR, Sharpe Ratio и др.)

Разрешение: read

GET/api/v1/secondary-marketЛистинги вторичного рынка

Разрешение: read

Параметры

Имя	Тип	Описание
`min_price`	number	Минимальная цена
`max_price`	number	Максимальная цена

POST/api/v1/secondary-market/buyКупить долю на вторичном рынке

Разрешение: write

Параметры

Имя	Тип	Описание
`listing_id`	string	ID листинга (UUID)

Примеры

cURL

curl -X GET "https://api.cosinvest.ru/api/v1/contracts?category=IT&min_return=15" \ -H "X-API-Key: ci_your_api_key" \ -H "X-Timestamp: $(date +%s)" \ -H "X-Signature: your_hmac_signature"

Python

import hmac, hashlib, time, requests API_KEY = "ci_your_api_key" API_SECRET = "your_secret" BASE_URL = "https://api.cosinvest.ru" timestamp = str(int(time.time())) body = "" signature = hmac.new( API_SECRET.encode(), (timestamp + body).encode(), hashlib.sha256 ).hexdigest() response = requests.get( f"{BASE_URL}/api/v1/contracts", headers={ "X-API-Key": API_KEY, "X-Timestamp": timestamp, "X-Signature": signature }, params={"category": "IT", "min_return": 15} ) print(response.json())

Webhook Events

Событие	Описание
`new_contract`	Новый контракт на маркетплейсе
`milestone`	Обновление milestone контракта
`investment`	Новая инвестиция в ваш контракт
`return`	Начисление возврата
`default`	Дефолт контракта
`contract_funded`	Контракт полностью профинансирован
`payment_received`	Получен платёж

Endpoints

GET/api/v1/contractsСписок контрактов с фильтрами и пагинацией

Разрешение: read

Параметры

Имя	Тип	Описание
`category`	string	Фильтр по категории
`min_return`	number	Минимальная доходность (%)
`risk_level`	string	Уровень риска: low, medium, high
`status`	string	Статус контракта (default: active)
`page`	number	Номер страницы (default: 1)
`per_page`	number	Записей на страницу (default: 20, max: 100)

GET/api/v1/contracts/:idДетали конкретного контракта по UUID

Разрешение: read

GET/api/v1/portfolioПортфель пользователя с инвестициями и сводкой

Разрешение: read

Параметры

Имя	Тип	Описание
`status`	string	Фильтр по статусу инвестиции

GET/api/v1/transactionsСписок транзакций пользователя

Разрешение: read

Параметры

Имя	Тип	Описание
`type`	string	Тип: deposit, withdrawal, investment, return, fee
`status`	string	Статус транзакции
`page`	number	Номер страницы (default: 1)
`per_page`	number	Записей на страницу (default: 20, max: 100)

POST/api/v1/investmentsСоздать инвестицию в контракт

Разрешение: write

Параметры

Имя	Тип	Описание
`contract_id`	string	ID контракта (UUID)
`amount`	number	Сумма инвестиции (₽)

GET/api/v1/portfolio/analyticsАналитика портфеля (IRR, Sharpe Ratio и др.)

Разрешение: read

GET/api/v1/secondary-marketЛистинги вторичного рынка

Разрешение: read

Параметры

Имя	Тип	Описание
`min_price`	number	Минимальная цена
`max_price`	number	Максимальная цена

POST/api/v1/secondary-market/buyКупить долю на вторичном рынке

Разрешение: write

Параметры

Имя	Тип	Описание
`listing_id`	string	ID листинга (UUID)

Примеры

cURL

curl -X GET "https://api.cosinvest.ru/api/v1/contracts?category=IT&min_return=15" \ -H "X-API-Key: ci_your_api_key" \ -H "X-Timestamp: $(date +%s)" \ -H "X-Signature: your_hmac_signature"

Python

Webhook Events

Событие	Описание
`new_contract`	Новый контракт на маркетплейсе
`milestone`	Обновление milestone контракта
`investment`	Новая инвестиция в ваш контракт
`return`	Начисление возврата
`default`	Дефолт контракта
`contract_funded`	Контракт полностью профинансирован
`payment_received`	Получен платёж