Açıklamalar İngilizce

Bölümün arayüzü dilinize çevrildi, ancak işlem, şema ve hata açıklamaları yalnızca Rusça ve İngilizce mevcut — burada İngilizce sürüm gösteriliyor.

GET/wallets

List Wallets

The key owner's wallets: asset, available balance and funds locked against running orders. There may be several — one per asset.

billing.read

Amounts are in the asset's minor units and come with its precision: the real value is amount / 10^precision. A display-ready *_formatted field sits next to each.

This endpoint exists only while the wallet feature is enabled; in the subscription-only model it is absent (404) and the remaining allowance is read from GET /subscriptions.

Required key permission: billing.read.

Bu sayfada(3)

Parametreler

Değerler doğrudan istek satırına yazılır ve URL kendiliğinden oluşur. Aşağıda her parametrenin türü, zorunlu olup olmadığı ve izin verilen değerleri var.

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

pageintegersorgudaisteğe bağlı≥ 1
Page number, starting at 1.
per_pageintegersorgudaisteğe bağlı1..100
Wallets per page. Defaults to 20; there are usually only a few, so this is rarely needed.

Olası yanıtlar

200

Success. The payload is in data.

Gövde örneği

{
  "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
  }
}

Yanıt alanları

successzorunlu

Success flag. Branch on the HTTP status code instead: any 2xx response carries true here, while an error comes back in a different shape that need not contain this field at all.

boolean

messagezorunlu

A human-readable note in the account language. Fine to show to a user; do not parse it — the wording changes without notice and is not an error code.

string

datazorunlu

The response payload.

WalletListWalletList

itemszorunlu

Records on the current page, in the list’s sort order.

array<Wallet>Wallet

dizi öğesi

idzorunlu

Wallet ID. Use it to filter the history: GET /ledger-transactions?wallet_id=.

integer

user_idzorunlu

ID of the wallet owner — always the key owner.

null olabilir

integer

asset_idzorunlu

ID of the asset the wallet is kept in; the asset itself is in asset.

null olabilir

integer

purposezorunlu

Wallet purpose: main is the main balance, referral holds referral earnings.

string

balancezorunlu

Balance in the asset’s minor units: amount = balance / 10^asset.precision. An integer, not a fraction.

integer

locked_balancezorunlu

Locked part of the balance in the asset’s minor units — reserved for orders in progress and payout requests, so it cannot be spent.

integer

balance_formattedisteğe bağlı

Balance as a decimal number by asset.precision (balance / 10^precision), ready to display.

null olabilir

number

locked_balance_formattedisteğe bağlı

Locked part of the balance as a decimal number by asset.precision.

null olabilir

number

balance_convertedzorunlu

Informational conversion of the balance into the account’s display currency. null for non-LUMC wallets and when no rate is available; use balance for calculations.

null olabilir

object

currencyzorunlu

Display currency code (ISO 4217).

string

amountzorunlu

Amount in the display currency, rounded to its precision.

number

symbolzorunlu

Currency symbol for display; null if the currency has none.

string

precisionzorunlu

Number of decimal places of the display currency.

integer

assetisteğe bağlı

The wallet asset: code, kind and the precision that turns balance into an amount.

AssetAsset

idzorunlu

Internal identifier of the asset.

integer

codezorunlu

Asset code: LUMC is the internal currency, TOKEN the generation tokens.

string

kindzorunlu

Kind of asset: money or consumable units. It decides whether an amount counts as a payment or as quota consumption.

Değerlermoneyunit

AssetKindAssetKind

precisionzorunlu

Number of decimal places. The load-bearing field: every integer amount in this asset is divided by 10^precision to obtain the real value. Do not assume the divisor is 100.

integer

namezorunlu

Display name of the asset, in the account language.

string

deleted_atzorunlu

When the asset was retired, ISO 8601. null while it is in use.

null olabilirdate-time

string

created_atzorunlu

When the asset was created, ISO 8601.

null olabilirdate-time

string

updated_atzorunlu

When the asset last changed, ISO 8601.

null olabilirdate-time

string

deleted_atzorunlu

When the wallet was deleted; null for wallets in this list.

null olabilirdate-time

string

created_atzorunlu

When the wallet was created.

null olabilirdate-time

string

updated_atzorunlu

When the wallet last changed, balance included.

null olabilirdate-time

string

current_pagezorunlu

Current page number, starting from one.

integer

last_pagezorunlu

Number of the last page. The walk is over once current_page equals last_page.

integer

per_pagezorunlu

Page size the server applied.

integer

totalzorunlu

Total number of records matching the filter.

integer

401

The key is missing, unknown, disabled or expired.

Bu yanıtı çözümle

Gövde örneği

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

Yanıt alanları

successzorunlu

Always false in error responses.

boolean

messagezorunlu

Error text in the key's language (set through the X-Locale header).

string

datazorunlu

Always null when the request is rejected before processing.

null olabilir

null

403

The key lacks the required permission, or the object belongs to another user.

Bu yanıtı çözümle

Gövde örneği

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

Yanıt alanları

successzorunlu

Always false in error responses.

boolean

messagezorunlu

Error text in the key's language (set through the X-Locale header).

string

422

Validation error. Offending fields are listed in errors.

Bu yanıtı çözümle

Gövde örneği

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

Yanıt alanları

successzorunlu

Always false in error responses.

boolean

messagezorunlu

A summary of the validation errors in words, in the response language (X-Locale).

string

errorszorunlu

A per-field breakdown: the key names a request field, the value lists the complaints about it.

object

*isteğe bağlı

rastgele anahtarlar

array<string>

Düz anlatımla

Tokens, quotas, LMC and PAYG

Nesneler

Komşu işlemler

GET/ledger-transactions

Daha fazla

Yapay zekâ için bu sayfa

.md sürümünü aç llm.md

API sürümü 1.0.0

Parametreler

Olası yanıtlar

İlgili içerik

Yapay zekâ için bu sayfa