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-фильтр, скоуп-права на каждый ключ.
С чего начать¶
Три коротких страницы — и вы от нуля до первой транзакции.
- Обзор — хранилище, кошелёк, транзакция, адресная книга, вебхук. Ментальная модель в пяти понятиях.
- Аутентификация — подпись каждого запроса. Рабочие примеры на bash, Node, Python, C#.
- Быстрый старт — первая сквозная интеграция за ~10 минут.
Два окружения¶
| Окружение | Префикс ключа | Реальные средства? |
|---|---|---|
| Sandbox | ..._test_… |
Нет — для интеграционных тестов. |
| Production | ..._live_… |
Да. |
Выбирайте нужное в выпадающем списке Server в Справочнике API. Ключи между окружениями не взаимозаменяемы.
Гайды¶
- Интеграция вебхуков — полные схемы payload-а каждого типа события, проверка подписи на трёх языках, гарантии и семантика повторов.
- Надёжность и лимиты — идемпотентность, rate-limit, защита от повторов, лимиты пагинации, безопасность URL вебхука. Рантайм-контракт; прочитайте один раз до интеграции.
- Обработка ошибок — каждый HTTP-код, который должен уметь обрабатывать ваш клиент, со стратегиями повторов.