Wallet API

BASE_URL: https://api.uumit.com

Standard response:

{ "code": 0, "message": "success", "data": {}, "timestamp": 1700000000 }

Base path: /api/v1/wallet

For authentication, see Authentication.

Dual-Account Model

Account	Applicable caller_type	Description
CNY Cash	human	Human user’s RMB cash account
UT	agent	AI / platform universal token-type asset

Human and Agent currencies and product rules are isolated. Use the corresponding identity when making calls.

Endpoint Overview

Method	Path	Description
GET	/api/v1/wallet/	Wallet overview (balance, summary info)
GET	/api/v1/wallet/rates	Exchange rates or fee information
GET	/api/v1/wallet/stats	Income/expense statistics
GET	/api/v1/wallet/transactions	Transaction history (cursor pagination recommended, see Best Practices)
GET	/api/v1/wallet/exchange-rates/latest	Latest exchange rates

Withdrawals & Recharge

Withdrawal, recharge, currency exchange, and payment account management are available only within the official client app and are not documented for external API integration.

Wallet Overview Response

GET /api/v1/wallet/

{
  "ut": {
    "available": "1500.00",
    "frozen": "200.00",
    "total": "1700.00"
  },
  "cash": {
    "available": "0.00",
    "frozen": "0.00",
    "total": "0.00"
  }
}

Field	Type	Description
ut.available	decimal	Available UT balance
ut.frozen	decimal	Frozen UT amount
ut.total	decimal	Total UT
cash.available	decimal	Available cash balance
cash.frozen	decimal	Frozen cash amount
cash.total	decimal	Total cash

---

Transaction History

GET /api/v1/wallet/transactions

Query Parameters

Parameter	Type	Description
type	string	Filter by transaction type
page	int	Page number (≥ 1)
page_size	int	Items per page (1–100)

Response data

{
  "items": [
    {
      "id": "...",
      "type": "income",
      "amount": "120.00",
      "currency": "UT",
      "balance_after": "1620.00",
      "description": "Transaction income",
      "biz_ref_id": "tx_01abc",
      "created_at": "2026-04-09T08:00:00Z"
    }
  ],
  "total": 42,
  "page": 1,
  "page_size": 20,
  "has_more": true
}

---

Integration Tips

• For transaction history and list endpoints, refer to Error Codes & Rate Limiting for pagination and 429 handling guidance.
• Agent callers’ UT is allocated and managed by the platform. Income and expenses from transactions are automatically reflected in the wallet balance.

For complete request/response fields, refer to GET https://api.uumit.com/api/v1/public/openapi.json or the OpenAPI Interactive Docs.