Примеры с открытым исходным кодом для API истории сделок Veltra
Четыре готовых к запуску примера для API истории сделок Veltra: отслеживание PnL, бэктест копитрейдинга, ML-скоринг кошельков и оповещения о новых сделках. Копируйте, запускайте, выкладывайте.
Мы открыли исходный код veltra-examples, набора небольших, законченных и готовых к копированию проектов, которые показывают, как строить реальные инструменты поверх API истории сделок кошельков Veltra. Каждый клонируется, запускается через npm install && npm start и рассчитан на то, чтобы перенести его прямо в ваш проект.
Идея проста: API отдаёт вам полную разобранную историю покупок и продаж кошелька из одного эндпоинт, поэтому вместо документации вы можете читать работающую программу, которая уже делает то, что вам нужно.
Что внутри
pnl-tracker: реализованная прибыль и убыток по каждому токену с себестоимостью по FIFO, доля прибыльных сделок и открытые позиции. Настоящий учёт, а не оценка «SOL пришло, SOL ушло».copy-trade-backtester: отвечает на вопрос «сколько бы я заработал, копируя этот кошелёк?». Проигрывает историю кошелька с конечным банкроллом, фиксированным размером позиции и проскальзыванием на каждом исполнении.trade-scoring: конвейер машинного обучения, который извлекает признаки из истории кошелька и обучает модель оценивать мастерство трейдера, с режимом разметки собственных кошельков.wallet-watcher: опрашивает кошелёк и присылает оповещение в тот момент, когда он совершает новую сделку, в терминал или в webhook Discord либо Slack.
Один эндпоинт, много инструментов
Каждый пример построен на одном вызове: GET /v1/wallets/{address}/history. Он возвращает каждую сделку чистой строкой: сторона, токен, mint, стоимость в SOL, количество токена, DEX и метка времени, без декодирования транзакций с вашей стороны. Этого единственного потока «кто, что, за сколько, где и когда покупал и продавал» достаточно, чтобы посчитать себестоимость, протестировать стратегию копирования, обучить модель скоринга или следить за новой активностью.
Не используете JavaScript? В репозитории также есть сборник рецептов curl: потоковая передача, постраничный обход, мультичейн, обработка ошибок и однострочники с jq, которые чисто переносятся на любой язык.
Начните с одного вызова
curl -N "https://veltrabot.com/v1/wallets/{address}/history" \
-H "Authorization: Bearer YOUR_API_KEY"Сделано, чтобы это копировали
- Каждый пример, это самостоятельная папка: скопируйте нужный, остальные проигнорируйте. Никаких monorepo-инструментов изучать не нужно.
- Каждый пример выполняет реальную работу поверх данных, а не просто перепечатывает ответ API.
- Примеры в торговом стиле, это честные исторические симуляции, а не живое исполнение, и они прямо говорят, что моделируют, а что нет.
- У каждого есть собственные тесты, а CI прогоняет проверку типов и тесты для всех.
Забрать код
Полный исходный код на GitHub: https://github.com/QuirkyTurtle11/veltra-examples, лицензия MIT. Возьмите API-ключ, бесплатного периода хватит, чтобы запустить все примеры.