Документация · v1

Creodock API

Все операции
POSTИнтерфейс CreodockИдемпотентная команда

Создать: баланс аккаунта

Creates live TRC20 deposit details for the configured treasury address. The returned six-decimal amount includes a small server-assigned matching suffix and must be transferred exactly.

OpenAPI: Create a one-time USDT deposit request

POSThttps://api.creodock.com/api/v1/me/balance/deposits
Кто вызывает
Интерфейс Creodock
Операция выполняется от имени вошедшего пользователя через защищённую cookie-сессию.
Доступ
Определяется ролью и принадлежностью объекта
Отдельный scope не объявлен в OpenAPI. Сервер проверяет роль и рабочую область.

Что произойдёт

Поведение, которое важно учесть до отправки запроса.

  • Создаёт ресурс или запускает команду, описанную в теле запроса.
  • Поддерживает Idempotency-Key: повторяйте запрос с тем же ключом после сетевого сбоя.

Параметры

Где передать значение, обязательно ли оно и откуда его получить.

ПолеГдеТипОписание
Idempotency-KeyОбязательно
headerstring
Уникальный ключ команды. Используйте UUID и сохраняйте тот же ключ при безопасном повторе запроса.Минимальная длина: 16 · Максимальная длина: 128

Тело запроса

Обязательно для этой операции.

application/json

Схема: CreateAccountDepositRequest

ПолеТипОписание
amountОбязательно
MoneyUsdt
Поле «amount» в структуре запроса или ответа.
networkОбязательно
string
Поле «network» в структуре запроса или ответа.

Ответы

Все состояния ответа, объявленные этой операцией в OpenAPI.

201

Deposit request created

application/json

Схема: AccountDeposit

ПолеТипОписание
addressОбязательно
string
Поле «address» в структуре запроса или ответа.
confirmationsОбязательно
integer
Поле «confirmations» в структуре запроса или ответа.Минимум: 0
confirmationsRequiredОбязательно
integer
Поле «confirmationsRequired» в структуре запроса или ответа.Минимум: 1
createdAtОбязательно
string · date-time
Дата и время создания в ISO 8601.
creditedAmountОбязательно
MoneyUsd
Поле «creditedAmount» в структуре запроса или ответа.
expiresAtОбязательно
string · date-time
Поле «expiresAt» в структуре запроса или ответа.
idОбязательно
string · uuid
Уникальный идентификатор объекта.
networkОбязательно
string
Поле «network» в структуре запроса или ответа.
networkLabelОбязательно
string
Поле «networkLabel» в структуре запроса или ответа.
requestedAmountОбязательно
MoneyUsdt
Поле «requestedAmount» в структуре запроса или ответа.
statusОбязательно
string
Текущий статус объекта.Допустимо: awaiting_transfer, confirming, credited, expired, review, failedПример: awaiting_transfer
transactionHashОбязательно
object
Поле «transactionHash» в структуре запроса или ответа.
{
  "address": "string",
  "confirmations": 0,
  "confirmationsRequired": 1,
  "createdAt": "2026-09-05T12:00:00Z",
  "creditedAmount": {
    "amountMinor": "string",
    "currency": "string",
    "scale": 1
  },
  "expiresAt": "2026-09-05T12:00:00Z",
  "id": "00000000-0000-0000-0000-000000000000",
  "network": "string",
  "networkLabel": "string",
  "requestedAmount": {
    "amountMinor": "string",
    "currency": "string",
    "scale": 1
  },
  "status": "awaiting_transfer"
}
422

Problem Details response

application/json

Схема: Problem

503

Problem Details response

application/json

Схема: Problem

Ошибки и восстановление

Не только причина, но и конкретное действие для вызывающей стороны.

СтатусЧто означаетПовторЧто делать
422Данные не прошли бизнес-проверкуПосле исправленияИсправьте поля, перечисленные в fieldErrors.
503Сервис временно недоступенДаПовторите с экспоненциальной задержкой.

Формат Problem Details

{
  "type": "https://api.creodock.com/problems/invalid-request",
  "title": "Данные не прошли проверку",
  "status": 422,
  "code": "invalid_request",
  "detail": "Проверьте отмеченные поля.",
  "traceId": "req_01J8M4Y6QX",
  "fieldErrors": [
    { "field": "items[0].formats", "code": "required", "message": "Выберите формат." }
  ]
}