Создание кошелька

Создаёт постоянный адрес под выбранную монету и сеть.

POST/static-wallets

Системная информация

API-ключ: Требуется
Rate Limit: 20 запросов в минуту

Body-параметры

Параметр	Тип	Обязательный	Описание
coinCode	string	Да	Код криптовалюты, например `USDT`.
networkCode	string	Да	Код блокчейн-сети, например `tron`.
orderId	string	Нет	Идентификатор заказа в вашей системе. Используется для идемпотентности и связи кошелька с вашей системой.
description	string	Нет	Описание кошелька.

curl -X POST "https://api.atomic.wallet/api/v1/static-wallets" \
  -H "x-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "coinCode": "USDT",
  "networkCode": "tron",
  "orderId": "order-1001",
  "description": "Payment wallet"
}'

{
  "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "projectUuid": "73e68013-32f0-4248-95ac-46aed61e59b0",
  "orderId": "order-1001",
  "description": "Customer wallet",
  "fiatAmount": "100.00",
  "fiatCurrency": "USD",
  "coinCode": "USDT",
  "networkCode": "tron"
}

Описание полей ответа

Параметр	Тип	Описание
uuid	string	UUID статического кошелька.
projectUuid	string	UUID проекта.
orderId	string	Идентификатор заказа, переданный при создании.
description	string	Описание, переданное при создании.
fiatAmount	string	Сумма в фиатной валюте.
fiatCurrency	string	Фиатная валюта.
coinCode	string	Код криптовалюты.
networkCode	string	Код блокчейн-сети.

Идемпотентность

Отдельный заголовок Idempotency-Key не используется — повторы определяются по orderId.

Ситуация	Результат
Тот же `orderId` и тот же payload	Возвращается существующий кошелёк.
Тот же `orderId`, другой payload	`409 PROJECT_STATIC_WALLET_EXTERNAL_ID_CONFLICT`
Без `orderId`	Каждый `POST` создаёт новый кошелёк.
`429 PROJECT_STATIC_WALLET_CREATION_RATE_LIMITED`	Лимит: 20 кошельков за 60 секунд на проект.
`500` или таймаут	Исход неизвестен: повторяйте только с тем же `orderId` и сохраните `requestId`.

Возможные ошибки

HTTP	Код	Описание
400	`PROJECT_STATIC_WALLET_INVALID`	Некорректный статический кошелёк.
400	`PROJECT_STATIC_WALLET_ASSET_UNAVAILABLE`	Актив недоступен для статического кошелька.
400	`PROJECT_STATIC_WALLET_LIMIT_EXCEEDED`	Превышен лимит статических кошельков.
409	`PROJECT_STATIC_WALLET_EXTERNAL_ID_CONFLICT`	`orderId` уже используется с другими параметрами кошелька.
429	`PROJECT_STATIC_WALLET_CREATION_RATE_LIMITED`	Превышен лимит создания статических кошельков.
503	`PROJECT_DEPOSIT_ADDRESS_UNAVAILABLE`	Адрес для депозита временно недоступен.
503	`PROJECT_WALLET_GENERATION_FAILED`	Не удалось сгенерировать кошелёк проекта.

← НазадОбзор Далее →Список кошельков