GET/wallets

Список кошельков

Кошельки владельца ключа: актив, доступный баланс и заблокированные средства (зарезервированные под выполняющиеся заказы). Кошельков может быть несколько — по одному на актив.

billing.read

Суммы приходят в минимальных единицах актива вместе с его precision: реальное значение — amount / 10^precision. Рядом лежит готовое к показу поле *_formatted.

Эндпоинт существует только при включённом кошельке; в модели «без аванса» его нет (404), а остаток услуги смотрят в GET /subscriptions.

Требуемое право ключа: billing.read.

На этой странице(3)

Параметры

Значения подставляются прямо в строку запроса, и URL собирается сам. Ниже — тип, обязательность и допустимые значения каждого параметра.

GEThttps://api.lumean.app/api/public/wallets

pageintegerв queryнеобязательный≥ 1
Номер страницы, начиная с 1.
per_pageintegerв queryнеобязательный1..100
Кошельков на странице. По умолчанию 20; их обычно единицы, так что параметр нужен редко.

Возможные ответы

200

Список кошельков

Пример тела

{
  "success": true,
  "message": "string",
  "data": {
    "items": [
      {
        "id": 1,
        "user_id": 1,
        "asset_id": 1,
        "purpose": "string",
        "balance": 1,
        "locked_balance": 1,
        "balance_formatted": 1,
        "locked_balance_formatted": 1,
        "balance_converted": {
          "currency": "string",
          "amount": 1,
          "symbol": "string",
          "precision": 1
        },
        "asset": {
          "id": 1,
          "code": "string",
          "kind": null,
          "precision": 1,
          "name": null,
          "is_active": true,
          "is_default": true,
          "default_balance": 1,
          "deleted_at": "2026-07-17T12:34:56+00:00",
          "created_at": "2026-07-17T12:34:56+00:00",
          "updated_at": "2026-07-17T12:34:56+00:00"
        },
        "user": {
          "id": 1,
          "email": "string",
          "lang_code": "string",
          "timezone": "string",
          "display_currency": "string",
          "has_telegram": true,
          "created_at": "2026-07-17T12:34:56+00:00",
          "updated_at": "2026-07-17T12:34:56+00:00",
          "referral_code": "string",
          "referral": {
            "kind": null,
            "code": null,
            "program_id": null,
            "commission_rate": null
          },
          "preferred_domain": "string",
          "email_verified_at": "string",
          "is_admin": true,
          "is_beta_tester": true,
          "allowed_models": "string",
          "referrer_id": 1,
          "deleted_at": "2026-07-17T12:34:56+00:00",
          "blocked_at": "2026-07-17T12:34:56+00:00",
          "is_blocked": true,
          "tickets_banned_at": "string",
          "is_tickets_banned": true,
          "tickets_ban_reason": "string",
          "voice_clone_banned_at": "string",
          "is_voice_clone_banned": true,
          "voice_clone_ban_reason": "string",
          "is_super_admin": true,
          "admin_permissions": [
            null
          ],
          "admin_roles": [
            null
          ],
          "referrer": null,
          "referral_link": "string",
          "active_referral_program": null,
          "wallets": [
            null
          ],
          "telegram": null,
          "subscriptions": [
            null
          ],
          "order_settings": null,
          "entitlements": [
            null
          ]
        },
        "deleted_at": "2026-07-17T12:34:56+00:00",
        "created_at": "2026-07-17T12:34:56+00:00",
        "updated_at": "2026-07-17T12:34:56+00:00",
        "system_key": "string"
      }
    ],
    "current_page": 1,
    "last_page": 1,
    "per_page": 1,
    "total": 1
  }
}

Поля ответа

successобязательное

Признак успеха. Решение принимайте по HTTP-коду: у любого ответа 2xx здесь true, а ошибка приходит телом другой формы, где этого поля может не быть вовсе.

boolean

messageобязательное

Пояснение для человека, на языке аккаунта. Показать пользователю можно; разбирать программно — нет: формулировки меняются без предупреждения и кодом ошибки не являются.

string

dataобязательное

Полезная нагрузка ответа.

WalletListWalletList

itemsобязательное

Записи текущей страницы в порядке сортировки списка.

array<Wallet>Wallet

элемент массива

idобязательное

ID кошелька. По нему фильтруют историю: GET /ledger-transactions?wallet_id=.

integer

user_idобязательное

ID владельца кошелька — всегда владелец ключа.

может быть null

integer

asset_idобязательное

ID актива, в котором ведётся кошелёк; сам актив — в asset.

может быть null

integer

purposeобязательное

Назначение кошелька: main — основной баланс, referral — реферальные начисления.

string

balanceобязательное

Баланс в минимальных единицах актива: сумма = balance / 10^asset.precision. Целое число, не дробь.

integer

locked_balanceобязательное

Заблокированная часть баланса в минимальных единицах актива — зарезервирована под заказы в работе и заявки на вывод, тратить её нельзя.

integer

balance_formattedнеобязательное

Баланс десятичным числом по asset.precision (balance / 10^precision), готовый к показу.

может быть null

number

locked_balance_formattedнеобязательное

Заблокированная часть баланса десятичным числом по asset.precision.

может быть null

number

balance_convertedобязательное

Справочный пересчёт баланса в валюту отображения аккаунта. null у не-LUMC кошельков и когда курс недоступен; для расчётов используйте balance.

может быть null

object

currencyобязательное

Код валюты отображения (ISO 4217).

string

amountобязательное

Сумма в валюте отображения, округлённая до её precision.

number

symbolобязательное

Символ валюты для показа; null, если у валюты его нет.

string

precisionобязательное

Число знаков после запятой у валюты отображения.

integer

assetнеобязательное

Актив кошелька: код, вид и precision для перевода balance в сумму.

AssetAsset

idобязательное

Внутренний идентификатор актива.

integer

codeобязательное

Код актива: LUMC — внутренняя валюта, TOKEN — токены генерации.

string

kindобязательное

Вид актива: деньги или расходуемые единицы. От него зависит, где сумма считается платежом, а где — расходом квоты.

Значенияmoneyunit

AssetKindAssetKind

precisionобязательное

Число десятичных знаков. Ключевое поле: любая целая сумма этого актива делится на 10^precision, чтобы получить реальное значение. Не считайте, что делитель равен 100.

integer

nameобязательное

Название актива для показа, на языке аккаунта.

string

deleted_atобязательное

Когда актив выведен из обращения, ISO 8601. null у действующего.

может быть nulldate-time

string

created_atобязательное

Когда актив заведён, ISO 8601.

может быть nulldate-time

string

updated_atобязательное

Когда актив последний раз менялся, ISO 8601.

может быть nulldate-time

string

deleted_atобязательное

Момент удаления кошелька; у кошельков в выдаче — null.

может быть nulldate-time

string

created_atобязательное

Когда кошелёк создан.

может быть nulldate-time

string

updated_atобязательное

Когда кошелёк последний раз менялся — в том числе баланс.

может быть nulldate-time

string

current_pageобязательное

Номер текущей страницы, с единицы.

integer

last_pageобязательное

Номер последней страницы. Обход списка закончен, когда current_page равен last_page.

integer

per_pageобязательное

Размер страницы, применённый сервером.

integer

totalобязательное

Сколько записей всего по фильтру.

integer

401

Невалидный или отсутствующий API-ключ

Разобрать этот ответ

Пример тела

{
  "success": false,
  "message": "API key is missing. Provide it in the X-API-KEY header.",
  "data": null
}

Поля ответа

successобязательное

Всегда false в ответах об ошибке.

boolean

messageобязательное

Текст ошибки на языке ключа (задаётся заголовком X-Locale).

string

dataобязательное

Всегда null, когда запрос отклонён до обработки.

может быть null

null

403

У ключа нет права billing.read

Разобрать этот ответ

Пример тела

{
  "success": false,
  "message": "This API key does not have permission to perform this action."
}

Поля ответа

successобязательное

Всегда false в ответах об ошибке.

boolean

messageобязательное

Текст ошибки на языке ключа (задаётся заголовком X-Locale).

string

422

Ошибка валидации. Поля с ошибками перечислены в errors.

Разобрать этот ответ

Пример тела

{
  "success": true,
  "message": "string",
  "errors": {}
}

Поля ответа

successобязательное

Всегда false в ответах об ошибке.

boolean

messageобязательное

Сводка ошибок валидации словами, на языке ответа (X-Locale).

string

errorsобязательное

Разбор по полям: ключ — поле запроса, значение — список претензий к нему.

object

*необязательное

произвольные ключи

array<string>

Об этом словами

Токены, квоты, LMC и PAYG

Объекты

Соседние операции

GET/ledger-transactions

Ещё

Эта страница для ИИ

Открыть .md llm.md

версия API 1.0.0