查询投注记录（按时间段）
1、查询投注记录（按时间段）
接口路径
- Get
- /api/game/transaction/query
说明
- 查询接口以分页模式，例如时间区间 1732589000000 - 1732600000000 内共有 269 条记录，设置 100 条每页
- 第一页，start-index 参数设置为 0 , page-size 参数为 100
- 第二页，start-index += 100 参数设置为 100，page-size 参数为 100
- 第三页，start-index += 100 参数设置为 200，page-size 参数为 100
- 依次类推
查询时间说明
- 投注记录只能查询最近三个月内的数据
- start_time 和 end_time 之间的时间跨度要小于 1 天
接口频率说明
- 查询投注记录 api 调用最多 30 秒钟调用 1 次
请求参数
| 参数 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| agent_id | 商户 ID | string | 必填 | 商户 ID |
| start_time | 订单更新时间，开始时间（包含） | string | 必填 | 单位毫秒 |
| end_time | 订单更新时间，结束时间(不包含) | string | 必填 | 单位毫秒 |
| start_index | 分页开始下标 | string | 必填 | 分页开始下标 |
| page_size | 分页每页大小 | string | 必填 | 分页每页大小，值不能大于 5000 |
| timestamp | 当前时间戳 | string | 必填 | 传调用接口时的时间戳（单位毫秒，有效期十分钟） |
| sign | 签名 | string | 必填 | 签名算法详见接口说明 |
响应参数
| 参数 | 名称 | 类型 | 说明 |
|---|---|---|---|
| code | 响应码 | int | 错误码 |
| message | 响应信息 | string | 错误信息 |
| data | 响应数据 | dict | 响应数据详情 |
| --start_index | 开始下标 | int | 开始下标 |
| --page_size | 每页订单数量 | int | 每页订单数量 |
| --total | 时间段内总投注订单数量 | int | 时间段内总投注订单数量 |
| --transactions | 投注订单列表 | List | 投注订单列表 |
| ----id | 订单 ID | string | 订单 ID |
| ----game_id | 游戏 ID | string | 游戏 ID， 101: 百家乐 |
| ----user_id | 用户 ID | string | 用户 ID |
| ----inst_id | 台桌 ID | string | 台桌 ID |
| ----shoe_id | 牌靴 ID | int | 牌靴 ID |
| ----round_id | 牌局 ID | int | 牌局 ID |
| ----bet_time | 投注时间 | int | 投注时间 |
| ----settle_time | 结算时间 | int | 结算时间 |
| ----bet_amount | 投注金额 | string | 投注金额 |
| ----real_bet_amount | 有效投注金额 | string | 有效投注金额 |
| ----win_amount | 派彩金额 | string | 派彩金额 |
| ----currency | 币种 | string | 币种 |
| ----real_win_amount | 真实输赢金额 | string | 真实输赢金额 = 派彩金额 - 投注金额 |
| ----bet_detail | 投注详情 | dict | 投注详情，字典的 key 是投注项目，值是投注金额 |
| ----no_comm | 是否免佣 | boolean | 是否免佣 |
| ----game_result | 游戏结果 | Array | 游戏结果 |
| ----open_cards | 开牌牌面 | dict | banker:庄, player:闲 |
| ----create_time | 订单创建时间 | int | 订单创建时间 |
| ----update_time | 订单更新时间 | int | 订单更新时间 |
| ----status | 订单状态 | int | 0-已下注，1-已结算，2-用户取消，3-订单无效，4-结算改无效 |
投注项说明
| 投注项 | 说明 |
|---|---|
| Tie | 和 |
| Banker | 庄 |
| Player | 闲 |
| Big | 大 |
| Small | 小 |
| PlayerPair | 闲对 |
| BankerPair | 庄对 |
| Super6 | 幸运 6 |
| PDragonBonus | 闲龙宝 |
| BDragonBonus | 庄龙宝 |
| AnyPair | 任意对子 |
| PrefectPair | 完美对子 |
| PlayerNatural | 闲例牌 |
| BankerNatural | 庄例牌 |
牌面说明
- 开牌牌面，按开牌顺序依次拼接成字符串
- 例如，闲第一张牌红桃 A、第二张牌梅花 6、第三张牌方块 J，拼接字符串为“HeartsA,Clubs6,DiamondsJ”
| 花色 | 说明 |
|---|---|
| Hearts | 红桃 |
| Diamonds | 方块 |
| Clubs | 梅花 |
| Spades | 黑桃 |
请求范例
curl --location 'https://staging.aig1234.com/api/game/transaction/query?agent_id=agent001&start_time=1732589000000&end_time=1732600000000&start_index=0&page_size=100×tamp=1734417699302&sign=60694d77140617133bb4143311c25e09' \
--header 'Content-Type: application/json'
响应范例
{
"code": 200,
"message": "success",
"data": {
"start_index": 0,
"page_size": 100,
"total": 169,
"transactions": [
{
"id": "67453d0923c36d2571d40815",
"user_id": "7797",
"game_id": "101",
"inst_id": "iN95KcYR",
"shoe_id": 10907,
"round_id": 9,
"bet_time": 1732590857359,
"settle_time": 1732590881164,
"bet_amount": "100",
"real_bet_amount": "100",
"win_amount": "200.00",
"real_win_amount": "100.00",
"currency": "USD",
"bet_detail": {
"Banker": 100
},
"no_comm": true,
"game_result": [
"Banker",
"Big"
],
"open_cards": {
"banker": "Spades9,Hearts5",
"player": "Clubs7,Clubs7,DiamondsA"
},
"create_time": 1732590857359,
"update_time": 1732590857359,
"status": 1
}
]
}
}
错误码
200 成功
408000 请求参数错误
408003 白名单限制
408004 API频率限制
600100 签名不合法
600101 参数不合法
700101 商户不存在
700401 查询时间错误