子商户投注记录（按时间段）

1、子商户投注记录（按时间段）

接口路径

Get
/api/game/transaction/sub/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，用于验证签名
sub_agent_id	子商户 ID	string	选填	指定子商户 ID，不传则返回所有直接子商户的注单
start_time	订单更新时间，开始时间（包含）	string	必填	单位毫秒
end_time	订单更新时间，结束时间(不包含)	string	必填	单位毫秒
start_index	分页开始下标	string	必填	分页开始下标
page_size	分页每页大小	string	必填	分页每页大小，值不能大于 5000
timestamp	当前时间戳	int	必填	传调用接口时的时间戳（单位毫秒，有效期十分钟）
sign	签名	string	必填	签名算法详见接口说明

说明

agent_id 为总商户 ID，必须传，用于验证白名单与签名
传 sub_agent_id 时，接口会验证该子商户是否归属于 agent_id，非直接子商户会返回参数错误
不传 sub_agent_id 时，返回 agent_id 下所有直接子商户的注单
sub_agent_id 参与签名计算（有值时需加入签名）

响应参数

参数	名称	类型	说明
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	long	牌局 ID
----bet_time	投注时间	int	投注时间
----settle_time	结算时间	int	结算时间
----bet_amount	投注金额	string	投注金额
----real_bet_amount	有效投注金额	string	有效投注金额
----valid_bet_turnover	有效流水	string	有效流水，去掉对压金额以及和局金额
----win_amount	派彩金额	string	派彩金额
----real_win_amount	真实输赢金额	string	真实输赢金额 = 派彩金额 - 投注金额
----currency	币种	string	币种
----bet_detail	投注详情	dict	投注详情，字典的 key 是投注项目，值是投注金额
----win_detail	派彩详情	dict	派彩详情，字典的 key 是投注项目，值是派彩金额
----no_comm	是否免佣	boolean	是否免佣
----game_result	游戏结果	Array	游戏结果
----open_cards	开牌牌面	dict	banker:庄, player:闲, result:游戏结果
----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	任意对子
PerfectPair	完美对子
PlayerNatural	闲例牌
BankerNatural	庄例牌

牌面说明

开牌牌面，按开牌顺序依次拼接成字符串
例如，闲第一张牌红桃 A、第二张牌梅花 6、第三张牌方块 J，拼接字符串为"HeartsA,Clubs6,DiamondsJ"

花色	说明
Hearts	红桃
Diamonds	方块
Clubs	梅花
Spades	黑桃

请求范例（指定子商户）

curl --location 'https://staging.aig1234.com/api/game/transaction/sub/query?agent_id=agent001&sub_agent_id=sub001&start_time=1732589000000&end_time=1732600000000&start_index=0&page_size=100&timestamp=1734417699302&sign=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json'

请求范例（所有直接子商户）

curl --location 'https://staging.aig1234.com/api/game/transaction/sub/query?agent_id=agent001&start_time=1732589000000&end_time=1732600000000&start_index=0&page_size=100&timestamp=1734417699302&sign=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
--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",
                "valid_bet_turnover": "100",
                "currency": "USD",
                "bet_detail": {
                    "Banker": 100
                },
                "win_detail": {
                    "Banker": "200.00"
                },
                "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 查询时间错误

子商户投注记录（按时间段）

1、子商户投注记录（按时间段）​

接口路径​

说明​

查询时间说明​

接口频率说明​

请求参数​

说明​

响应参数​

投注项说明​

牌面说明​

请求范例（指定子商户）​

请求范例（所有直接子商户）​

响应范例​

错误码​

1、子商户投注记录（按时间段）

接口路径

说明

查询时间说明

接口频率说明

请求参数

说明

响应参数

投注项说明

牌面说明

请求范例（指定子商户）

请求范例（所有直接子商户）

响应范例

错误码