Документация/Все методы API

Список кошельков клиента

GET/crypto/wallets

Заполните параметры запроса и отправьте его в API.

Возвращает криптовалютные кошельки клиента merchant_customer. Можно фильтровать по asset и статусу кошелька status; по умолчанию используется active. Передайте текущее время UTC в миллисекундах Unix и новый nonce, включив оба поля в подпись.

GEThttps://secure-api.404stage.com/crypto/wallets?status=activeПрямой запрос к API

Запрос

Правила подписи
curl --request GET 'https://secure-api.404stage.com/crypto/wallets?status=active' \
  --header 'accept: application/json'
ЗаголовкиAccept: application/json

Укажите свои реквизиты и подпись. Запрос отправляется на адрес выше.

Ответ

Запрос выполнен; проверяйте статус операции в ответе.

Кошельки клиента

application/json
{
  "merchant_customer": "customer-001",
  "status": "success",
  "total": 1,
  "wallets": [
    {
      "asset": "USDT_TRC20",
      "created_at": "2026-09-14T10:00:00Z",
      "id": "58184561-a14b-4e42-8e37-6f47b8f7a754",
      "merchant_customer": "customer-001",
      "public_address": "TXLAQ63Xg1NAzckPwKHvzw7CSEmLMEqcdj",
      "status": "active",
      "tag": null
    }
  ]
}
Описание и правила метода

Возвращает криптовалютные кошельки клиента merchant_customer. Можно фильтровать по asset и статусу кошелька status; по умолчанию используется active. Передайте текущее время UTC в миллисекундах Unix и новый nonce, включив оба поля в подпись.

Пример запроса (замените заполнители и пересчитайте подпись):

http
GET /crypto/wallets?merchant_id=16ec5bed-30a5-470c-9b41-c74ead9d4855&merchant_customer=customer-001&asset=USDT_TRC20&status=active&timestamp={{timestamp_ms}}&nonce={{unique_nonce}}&signature={{signature}}
Host: api.example.com

Все параметры и схемы

Свернуть схему

Параметры запроса

merchant_id*string

ID мерчанта, выданный при регистрации.

merchant_customer*string

Идентификатор клиента в вашей системе.

asset?string

Необязательный фильтр актива и сети, например USDT_TRC20.

status?string

Фильтр по статусу кошелька; по умолчанию active.

По умолчанию"active"
timestamp*integer

Текущее время Unix в миллисекундах, UTC. Устаревшее значение приводит к ошибке подписи.

nonce*string

Новая строка запроса длиной 8–64 символа; включите её в подпись.

Длина8 <= length <= 64
signature*string

Подпись запроса: используйте общие правила HS256 и фактический путь URL.

Тело ответа

Запрос выполнен; проверяйте статус операции в ответе.

application/json
  1. response

Криптокошельки клиента мерчанта.

merchant_customer*string

Идентификатор клиента в системе мерчанта.

status?string

Результат выполнения запроса API.

По умолчанию"success"
total*integer

Количество возвращённых кошельков.

wallets?array<>

Кошельки указанного клиента мерчанта.