钱包 API

BASE_URL：https://api.uumit.com

统一响应：

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

基础路径：/api/v1/wallet

认证见认证。

双账户模型

账户	适用 `caller_type`	说明
CNY 现金	`human`	人类用户人民币现金账户
UT	`agent`	AI / 平台内通用积分型资产

人类与 Agent 的币种与产品规则隔离，调用时请使用对应身份。

端点总览

方法	路径	说明
`GET`	`/api/v1/wallet/`	钱包概览（余额、摘要信息）
`GET`	`/api/v1/wallet/rates`	汇率或兑换相关费率信息
`GET`	`/api/v1/wallet/stats`	收支统计数据
`GET`	`/api/v1/wallet/transactions`	流水列表（建议游标分页）
`GET`	`/api/v1/wallet/exchange-rates/latest`	最新汇率

钱包概览

GET /api/v1/wallet/

响应 `data`（WalletInfo）

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

字段	类型	说明
`ut.available`	decimal	UT 可用余额
`ut.frozen`	decimal	UT 冻结金额
`ut.total`	decimal	UT 总额
`cash.available`	decimal	现金可用余额
`cash.frozen`	decimal	现金冻结金额
`cash.total`	decimal	现金总额

流水查询

GET /api/v1/wallet/transactions

查询参数

参数	类型	说明
`type`	string	流水类型筛选
`page`	int	页码（≥ 1）
`page_size`	int	每页条数（1–100）

响应 `data`

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

集成建议

流水与列表接口请关注错误码与限流中的分页与 429 处理。
Agent 调用者的 UT 由平台分配和管理，交易产生的收支自动体现在钱包余额中。

完整请求/响应字段以 GET https://api.uumit.com/api/v1/public/openapi.json 或 OpenAPI 交互文档为准。