Перейти к содержанию

API · v1

Встройте безопасное криптокастоди в свой продукт.

Подписанный REST API для открытия аккаунтов хранения, выпуска кошельков, переводов и реакции на on-chain события в реальном времени. Идемпотентный, мульти-тенантный, готовый к продакшену с первого дня.

  • Хранилища


    Хранилище на каждого конечного клиента. Изолированные балансы, отдельный аудит. Создаётся одним вызовом POST /vaults.

    → Обзор

  • Кошельки


    По одному на актив внутри хранилища. Нативный адрес для пополнения в каждой поддерживаемой сети. BTC, ETH, USDT, USDC и другие.

    → Обзор

  • Транзакции


    Внутренние переводы и on-chain выводы на адреса из адресной книги. Оценка комиссии перед отправкой. Отслеживание через вебхук или пулл.

    → Справочник

  • Вебхуки


    Подписанные HMAC-SHA256 коллбэки на каждое пополнение, вывод и изменение баланса. Гарантия at-least-once с повторами и dead-letter.

    → Интеграция вебхуков

  • Адресная книга


    Список разрешённых внешних адресов в рамках организации. Выводы только на добавленные адреса — защита от опечаток и компрометации.

    → Справочник

  • Подписанные ключи


    Каждый запрос подписан X-API-Key + X-Timestamp + X-Signature (HMAC-SHA256). Опциональный IP-фильтр, скоуп-права на каждый ключ.

    → Аутентификация

С чего начать

Три коротких страницы — и вы от нуля до первой транзакции.

  1. Обзор — хранилище, кошелёк, транзакция, адресная книга, вебхук. Ментальная модель в пяти понятиях.
  2. Аутентификация — подпись каждого запроса. Рабочие примеры на bash, Node, Python, C#.
  3. Быстрый старт — первая сквозная интеграция за ~10 минут.

Два окружения

Окружение Префикс ключа Реальные средства?
Sandbox ..._test_… Нет — для интеграционных тестов.
Production ..._live_… Да.

Выбирайте нужное в выпадающем списке Server в Справочнике API. Ключи между окружениями не взаимозаменяемы.

Гайды

  • Интеграция вебхуков — полные схемы payload-а каждого типа события, проверка подписи на трёх языках, гарантии и семантика повторов.
  • Надёжность и лимиты — идемпотентность, rate-limit, защита от повторов, лимиты пагинации, безопасность URL вебхука. Рантайм-контракт; прочитайте один раз до интеграции.
  • Обработка ошибок — каждый HTTP-код, который должен уметь обрабатывать ваш клиент, со стратегиями повторов.