Skip to content

3.2 交易状态查询 API ​

Exchange Prediction
http
POST /api/v1/wallet/transfer-wallet-transaction/status

适用范围

Exchange 与 Prediction 共用同一钱包。本 API 可查询两项产品的转入 / 转出交易状态。

依 ticket_id 查询该笔交易的最新状态(实时),常用于确认存款 / 提款是否成功。数据保留最近 6 个月。请求须带入 HMAC 验证 Header。

TIP

本 API 限流 100 次 / 分钟,超过返回 code:10060。额度按 api_key × 接口独立计算,各接口不共用;每次请求(含返回错误者)均计入。

请求 Body(JSON) ​

字段必填类型说明
ticket_idTRUEstring交易所 ticket ID,最长 256 字符
json
{ "ticket_id": "fadbd4ce-4f14-4b9e-8ee4-accd4b9c729e" }

响应 data ​

返回单笔交易记录(非列表)。

json
{
  "code": 0,
  "message": "success",
  "data": {
    "id": "0f8c1b2a-6d4e-4a1f-9c33-2a1d4e6f7a80",
    "source_id": "fadbd4ce-4f14-4b9e-8ee4-accd4b9c729e",
    "source_id_type": "ticket_id",
    "order_ids": [],
    "player_id": "45d3d8eb-1a95-4e47-9315-bc507ea06d65",
    "player_external_id": "player1",
    "player_name": "player1_name",
    "agent_id": "bea4274e-4333-423c-a8e8-4c203d256d2c",
    "agent_name": "agent_demo",
    "transaction_type": "EXCHANGE_TRANSACTION_TYPE_DEPOSIT",
    "currency": "CNY",
    "amount": "100",
    "balance_after": "1000",
    "created_at": "2026-05-20T10:00:00Z",
    "kind": "EXCHANGE_WALLET_KIND_WALLET"
  }
}

IMPORTANT

查无该 ticket_id 时返回 code:10030,transfer wallet transaction not found。

10030 同时代表「不存在」与「尚未入账」两种情况。转账为单一数据库交易、全同步处理,没有「已受理、未入账」的中间状态——查不到即代表当下没有入账。

请勿依赖 10030 推断后补单。确认未入账后,直接以同一个 ticket_id 重送原请求即可(HMAC Header 须重新产生新的 X-Nonce 与 X-Timestamp)。

data 字段 ​

字段类型说明
idstring该笔钱包记录的唯一 ID(UUID)
source_idstring来源 ID;转入 / 转出为请求带入的 ticket_id
source_id_typestringsource_id 的来源类型(见来源类型枚举)
order_idsarray关联的交易所挂单号;转入 / 转出均为空数组
player_idstring玩家内部 ID(UUID)
player_external_idstring玩家 ID
player_namestring玩家名称
agent_idstring代理内部 ID(UUID)
agent_namestring代理名称
transaction_typestring交易类型(见交易类型枚举)
currencystring货币
amountstring金额变动(可为负)
balance_afterstring变动后余额
created_atstring交易时间(RFC3339 UTC)
kindstring钱包类型(见钱包类型枚举)

BFX · BE THE GAME CHANGER