Game Open API (Seamless 接入) (2.1.0)

Download OpenAPI specification:Download

调用 API 方式

REST API

请求方式：GET / POST，依据各接口规格说明

数据格式：JSON

路径前缀：/gameapi/v2

调用示例：

POST /gameapi/v2/create_player HTTP/1.1
Content-Type: application/json; charset=utf-8
Host: <api server>
Connection: close
Content-Length: 255

请求参数：

{
  "merchant_code": "04e17735ba374dcd898746c6ac8118e4",
  "auth_token": "59ddb8dd71f8494485ff200f78bc4dba",
  "username": "merchant.player2",
  "sign": "20fbee96a0f436a6d8386b192a569a27bcc1c689"
}

返回响应：

{
  "success": true,
  "code": 0,
  "detail": {
    "id": 11216,
    "role": 3,
    "username": "o2p1632998628",
    "company": 11198
  }
}

标准返回结果格式：

success：布尔值，表示此接口操作成功或失败。如果失败，则 message 字段会提供错误信息。
code：返回码，仅用于向后兼容。
message：字符串，操作失败（success: false）时返回具体错误信息，详细内容请见错误列表。
detail：具体业务返回数据，依据各接口规格定义。

游戏列表

根据受欢迎程度每月更新

大厅

游戏代码	游戏名称
lobby	游戏大厅

经典游戏

游戏代码	游戏标签	英文名称	中文名称	RTP	上月排名	发布日期
football	2	Goal Win	够赢	96%	New	2026/04/22
crash2	2	Shadow Rush	暗影突袭	96%	New	2026/03/16
road	1	Ice Hop	冰川跳跃	95% ~ 97%	New	2025/11/10
crash	1	Crash	暴力弹	98.99%	1	2022/6/30
baccarat	1	Baccarat	百家乐	98.99%	2	2024/12/26
triple	1	Triple	三联爆	96.5%	3	2022/6/30
plinko	1	Plinko	叮咚球	92.3% ~ 96.6%	4	2022/6/30
mine	1	Mine	挖矿弹	96.96%	5	2022/6/30
coin	1	Goal	点球	97%	6	2022/6/30
dice	1	Lucky Beer	幸运啤酒	98%	-	2022/6/30
limbo	1	Limbo	凌波弹	94% ~ 95%	-	2022/6/30
space-max	2	Space Max	星际探险	98.99%	-	2023/5/15
double	1	Double	轮盘	95%	-	2022/6/30
keno	1	Keno	基诺球	92%	-	2022/6/30
crypto	1	Crypto	宝石	97%	-	2022/6/30
hilo	1	Hilo	西洛	98%	-	2022/6/30
tower	1	Tower	爬塔	96%	-	2022/6/30
bingo	1	Bingo	宾果	92%	-	2023/3/1
poker	1	Video Poker	电子扑克	98.37%	-	2023/4/1
wheel	1	Wheel	转盘	96% ~ 97%	-	2023/6/30
nine	1	Nine	拆弹专家	92%	-	2023/10/4
color	1	Color	颜色	95%	-	2024/1/3
racing	1	Racing	赛车	95%	-	2024/1/26
space	1	Space	星际迷航	95%	-	2024/8/8

怪兽系列

游戏代码	游戏标签	英文名称	中文名称	RTP	上月排名	发布日期
m-mine	3	Monster Mine	怪兽扫雷	96.96%	1	2023/9/1
m-plinko	3	Rock Plinko	怪兽弹珠	92.3% ~ 96.6%	2	2023/9/1
m-tower	3	Monster Tower	怪兽爬塔	96%	3	2023/9/1
m-fight	3	Monster Fight	怪兽斗争	97%	4	2023/9/1
m-crypto	3	Monster Crypto	怪兽宝石	97%	-	2023/9/1
m-triple	3	Monster Triple	怪兽三联	96.5%	-	2023/9/1
m-hilo	3	Monster HiLo	怪兽西洛	98%	-	2024/3/1
m-dice	3	Monster Dice	怪兽骰宝	98%	-	2024/3/1
m-crash	3	Monster Crash	怪兽飞船	98.99%	-	2024/4/9

刮刮乐

游戏代码	游戏标签	英文名称	中文名称	RTP	发布日期
3001	10	Happy Farm	快乐农场	95%	2024/1/25
3002	10	Opportunity 10	机会 10	92%	2024/1/25
3003	10	Ultra 777	超级 777	93%	2024/1/25
3004	10	Gem Bomb	宝石炸弹	92%	2024/1/25
3005	10	Mad Scientist	疯狂科学家	93%	2024/1/25
3006	10	Beach NiuNiu	海滩牛牛	92%	2024/1/25

老虎机

游戏代码	游戏标签	英文名称	中文名称	RTP	发布日期
7001	30	Molten Dragon	熔火幼龙	94.04%	2024/9/12
7002	30	Magic Girl	小魔女	92% ~ 95%	2024/9/12
7003	30	Jungle Travel	丛林旅行	92% ~ 95%	2024/9/12
7005	30	Hash Tiger	哈希老虎	92% ~ 95%	2026/6/18
7007	30	Hash Rabbit	哈希兔兔	92% ~ 95%	2026/6/18
7008	30	Pyramid Paws	神殿萌爪	92% ~ 95%	2026/9/3
7009	30	Wild Fox	荒野狐狸	92% ~ 95%	2026/9/3

彩票

游戏代码	游戏标签	英文名称	中文名称	RTP	发布日期
lottery_lobby	20	Lottery Lobby	彩票大厅	95%	2025/12/15
5001	20	Lotinha	Lotinha	95%	2025/12/15
5002	20	Quininha	Quininha	95%	2025/12/15
5003	20	Seninha	Seninha	95%	2025/12/15
5011	20	60s 5D	1分时时彩	95%	2025/12/15
5012	20	300s 5D	5分时时彩	95%	2025/12/15
5013	20	600s 5D	10分时时彩	95%	2025/12/15
5016	20	60s PK10	1分赛车	95%	2025/12/15
5017	20	300s PK10	5分赛车	95%	2025/12/15
5018	20	600s PK10	10分赛车	95%	2025/12/15
5021	20	60s K3	1分快3	95%	2025/12/15
5022	20	300s K3	5分快3	95%	2025/12/15
5023	20	600s K3	10分快3	95%	2025/12/15
5036	20	60s HK6	1分六合彩	95%	2025/12/15
5037	20	300s HK6	5分六合彩	95%	2025/12/15
5038	20	600s HK6	10分六合彩	95%	2025/12/15
5041	20	60s WinGo	1分WinGo	95%	2025/12/15
5042	20	300s WinGo	5分WinGo	95%	2025/12/15
5043	20	600s WinGo	10分WinGo	95%	2025/12/15
5046	20	Hash28 60s	1分哈希28	95%	2025/12/15
5047	20	Hash28 300s	5分哈希28	95%	2025/12/15
5048	20	Hash28 600s	10分哈希28	95%	2025/12/15
5051	20	VN North 60s	越南北部1分彩	95%	2025/12/15
5052	20	VN North 300s	越南北部5分彩	95%	2025/12/15
5053	20	VN North 600s	越南北部10分彩	95%	2025/12/15
5056	20	VN Central 60s	越南中部1分彩	95%	2025/12/15
5057	20	VN Central 300s	越南中部5分彩	95%	2025/12/15
5058	20	VN Central 600s	越南中部10分彩	95%	2025/12/15
5061	20	VN South 60s	越南南部1分彩	95%	2025/12/15
5062	20	VN South 300s	越南南部5分彩	95%	2025/12/15
5063	20	VN South 600s	越南南部10分彩	95%	2025/12/15
5066	20	SicBo 60s	1分骰宝	95%	2025/12/15
5067	20	SicBo 300s	5分骰宝	95%	2025/12/15
5068	20	SicBo 600s	10分骰宝	95%	2025/12/15

错误列表

代码	错误信息 (Message)	说明
1	InvalidSignature	无效的签名
2	InvalidMerchantCode	无效的商户号
3	InvalidSecureKey	无效的安全密钥
4	InvalidAuthToken	无效的授权书识别符
5	InvalidGamePlatformId	无效的游戏平台识别码
6	InvalidUsername	无效的用户名
7	InvalidPassword	无效的密码
8	DuplicateUsername	用户名重复
9	InvalidExtraInfo	无效的额外信息
10	InvalidGamePlatformSettings	无效的游戏平台配置
11	InvalidBetLimit	无效的限注配置
12	InvalidActionType	无效的动作类型
13	InvalidAmount	无效的金额
14	DuplicateExternalTransId	外部交易识别码重复
15	NoEnoughBalance	余额不足
16	InvalidFromDateTime	无效的开始时间
17	InvalidToDateTime	无效的结束时间
18	InvalidExternalTransId	无效的外部交易识别码
19	SecureKeyNotAllowed	不允许此安全密钥
20	BonusRequired	需要奖金组
21	InvalidBonus	无效的奖金组
22	InvalidRebate	无效的返点比例
23	AccountDuplicated	账号用户名重复
24	SubAccountNotFound	未找到指定子账号
25	InvalidParent	无效的上级代理
26	RequestDataRequired	需要请求资料
27	RequestTooFast	请求频率过快
28	TransactionIdRequired	请传入交易号或外部交易号
29	PlayerNotFound	未找到指定玩家
30	InvalidGameCode	游戏代码无效
31	BetNotFound	未找到注单

安全模式

服务器域名或 IP

隐藏对外服务器域名或 IP，请勿直接暴露给玩家。

IP 白名单

服务器上需设置 IP 白名单。

测试环境需在管理后台增加访问游戏前端的 IP 白名单。

商户号与安全密钥

均为 32 位字符（字母与数字），由邮件发送提供。

测试密钥：dd35aPO0bd186dc6ace6We2e0fb48s70

签名密钥

均为 32 位字符（字母与数字），由邮件发送提供。

测试密钥：dd35aPO0bd186dc6ace6We2e0fb48s70

参数签名规则

所有参数默认编码为 UTF-8。
忽略参数名为 sign 的字段、值为空或类型为 object 的字段。
所有有效参数名按字母升序排序。
将排序后的所有非空参数值（不含 key）依次拼接成一个字符串，在末尾拼接上签名密钥，最后使用 SHA1 加密算法生成签名。

签名示例：

假设商户的签名密钥为 SIGN_KEY_EXAMPLE，需要对以下参数对象进行签名：

{
  "b": 1.1,
  "a": 1,
  "d": "some string",
  "e": "",
  "c": true,
  "sign": "abcdefg",
  "g": {
    "x": 1,
    "y": 2
  },
  "f": null
}

计算签名步骤如下：

忽略值为空、类型为 object 及 key 为 sign 的字段，得到：

{
  "b": 1.1,
  "a": 1,
  "d": "some string",
  "c": true
}

将 key 按字母升序排序，得到：

{
  "a": 1,
  "b": 1.1,
  "c": true,
  "d": "some string"
}

将 value（不需 key）依次拼接，并在末尾拼接签名密钥，得到签名之前的字符串：
```
11.1truesome stringSIGN_KEY_EXAMPLE
```
对该字符串进行 SHA1 加密，得到最终签名值：
```
91bef33b208ba98ac2d889b9c4e996651ca58146
```

身份认证

使用 merchant_code（商户号）和 secure_key（安全密钥）调用登录接口获取 auth_token。
每次调用业务 API 时，均需在请求参数中带上此 auth_token。

商户 Webhook 回调

若接入方希望使用区块链游戏的单钱包（Seamless）模式，接入方必须依据下列规格实现 Webhook，并向我方提供商户的 host_url。

签名算法与安全模式章节说明完全一致。

重复请求与去重（重要）

同一笔投注、派彩或退款，我方可能发送不止一次，接入方必须自行去重，否则会重复扣款、重复派彩或重复退款：

派彩（payout）与退款（refund）在网络错误、超时或接入方返回非 2xx 时，会自动重试，最多再发送 2 次，每次间隔约 1 小时
此前从未成功的派彩或退款回调，可在后台手动重新发送（投注回调不会重送），每笔回调只能手动重送一次，重送后不可再次重送，自动重试也随之停止
因此同一笔派彩或退款最多可能收到 4 次请求（首次 + 自动重试 2 次 + 手动重送 1 次）
每次发送的 unique_id 都不同，unique_id 仅用于识别单次调用，不可用于判断是否为同一笔交易

去重方式：以「回调类型（/bet、/payout、/refund）+ game_code + bet_id」作为同一笔交易的唯一键。同一张注单的投注、派彩、退款是不同的交易，需分别处理。

不可只用 bet_id：小游戏、老虎机、彩票、刮刮乐的 bet_id 各自独立编号，不同产品之间会出现相同的 bet_id
不可使用 round_id：部分游戏（例如 crash）的局号由同一局的所有玩家共用
收到已处理过的请求时，请勿再次变更余额，直接返回 is_success: true 与玩家当前余额，我方即会停止重试

查询玩家信息

查询接入方商户侧的玩家信息。

接口地址：/{host_url}/player_summary

请求方式：POST

请求体 (Body)

参数名称	类型	说明
unique_id	string	独立识别每次调用接口的唯一 ID
timestamp	number	当前时间戳（Unix 秒）
merchant_code	string	商户号
username	string	玩家用户名
sign	string	参数签名

{
  "unique_id": "sampleId",
  "timestamp": 1654752446,
  "merchant_code": "testMerchant",
  "username": "testPlayer",
  "sign": "testSign"
}

返回响应 (Response)

参数名称	类型	说明
is_success	boolean	操作是否成功，不传默认为 true（成功）
err_msg	string	操作失败时的错误说明
username	string	玩家用户名
balance	number	玩家余额
currency	string	玩家货币

{
  "is_success": true,
  "err_msg": "",
  "username": "test",
  "balance": 100,
  "currency": "test"
}

投注 (Bet)

扣除玩家余额进行投注。

接口地址：/{host_url}/bet

请求方式：POST

请求体 (Body)

参数名称	类型	说明
unique_id	string	独立识别每次调用接口的唯一 ID
timestamp	number	当前时间戳（Unix 秒）
merchant_code	string	商户号
username	string	玩家用户名
amount	number	投注金额
currency	string	玩家货币
game_code	string	游戏代码
bet_id	number	投注注单 ID
round_id	string or number	局号（目前仅 double 轮盘游戏为 string 格式）
number	string	投注内容
sign	string	参数签名

number 字段详情

游戏	类型	示例与说明
crash	string	示例：`1000`
double	string	示例：`1`；0 黄色，1 绿色，2 蓝色
plinko	string	示例：`{"layer":8,"level":0}`；level：0 蓝色，1 绿色，2 红色
keno	string	示例：`{"number":"[1,2,3]","level":0}`；level（风险）：0 低，1 中，2 高
dice	string	示例：`{"point":90,"game_type":1}`；type 1 小于，2 大于
triple	string	示例：`{"position":[10,2,3],"level":0}`；level（风险）：0 低，1 中，2 高
bingo	string	示例：`{"card":"[44,53,63,9,64,30,13,57,17,24,36,71,1,58,35,61,7,48,75,45,40,18,69,16]","count":45}`；card：发给玩家的牌组；count：玩家选择翻开的卡牌数
limbo	string	示例：`{"point":2}`；point：目标倍数
crypto	string	示例：`{}`；固定值
coin	string	示例：单次点球 `{"position":"[1]","type":1}`，多次点球 `{"type":2}`；position：1 人头，2 字；type：1 单次，2 多次
mine	string	示例：一般投注 `{"count":1}`，即时投注 `{"count":1,"position":"[0]"}`；count：地雷数；position：玩家选择的位置
tower	string	示例：一般投注 `{"count":1}`，即时投注 `{"count":1,"position":"[0]"}`；count：每层炸弹数；position：每层玩家选择
hilo	string	示例：`{}`；固定值
poker	string	示例：`{"poker_init":"[49,18,31,7,11]"}` 初始手牌，0~51 ♠♥♣♦
wheel	string	示例：`{"level":1,"segments":20}`；level：难度；segments：玩家选择的区段数
nine	string	示例：一般投注 `{}`，即时投注 `{"position":"[0]"}`；position：玩家剪断的引线
3001	string	示例：`{"content":[49,49,20,"顺",15,51,22,9,49,44,3,46,4],"lucky_draw":[6,8,16,18,66,68,88,"顺","发"]}`；刮刮乐内容与中奖符号
3002	string	示例：`{"content":[15,28,24,51,77,47,75,12,29,59,36,91,6,9,88,22,41,12,26,73,90,33,55,94,94,64,48,86,55,95,85,14,66,13,89,72,69,12,95,66,16,58,90,96,14,24,74,62,41,62,30,38],"lucky_draw":46}`；刮刮乐内容与中奖数字
3003	string	示例：`{"content":[220,158,398,519,638,514,893,238,602,215,830,126,780,524,66,758,350,809,396,192,894,667,107,694,234,535,159,226,917,912,85,194,344,740,506,378,327,707,410,684,466,246,147,840,605,0,24,717,722],"lucky_draw":[0,7,77,777]}`；刮刮乐内容与中奖号码
3004	string	示例：`{"content":[2,7,1,8,5,4,0,4,7],"lucky_draw":[]}`；刮刮乐内容，仅 7 计为中奖图形；lucky_draw 固定为空数组
3005	string	示例：`{"content":[1,0,0,0,0,0,0,0,0,0,0,0],"lucky_draw":[1]}`；刮刮乐内容，1 表示中奖；lucky_draw 固定为包含元素 1 的数组

{
  "unique_id": "testId",
  "timestamp": 1654752446,
  "merchant_code": "testMerchant",
  "username": "testPlayer",
  "amount": 30,
  "currency": "USD",
  "game_code": "double",
  "bet_id": 99,
  "round_id": "testRound",
  "number": "white",
  "sign": "testSign"
}

返回响应 (Response)

参数名称	类型	说明
is_success	boolean	投注是否成功，不传默认为 true（成功）
err_msg	string	操作失败时的错误说明
balance	number	玩家余额
currency	string	玩家货币
need_refund	boolean	此失败注单是否需要退款，不传默认为需要退款

退款控制

接入方如果返回投注失败，可以增加返回一个字段 need_refund, 不传的时候默认为 true，具体情形如下
- 当need_refund值为false的时候，我们不会再调用refund webhook
- 当need_refund值为true的时候，我们会调用refund webhook 退回玩家投注金额
- 如果接入方没有返回need_refund字段，我们会调用refund webhook 退回玩家投注金额，跟目前的行为一致
如果投注成功，则不需要返回need_refund这个字段

{
  "is_success": true,
  "err_msg": "",
  "balance": 100,
  "currency": "test"
}

派彩 (Payout)

当注单结算时，无论输赢，均会调用此接口。

接口地址：/{host_url}/payout

请求方式：POST

请求体 (Body)

参数名称	类型	说明
unique_id	string	独立识别每次调用接口的唯一 ID
timestamp	number	当前时间戳（Unix 秒）
merchant_code	string	商户号
username	string	玩家用户名
amount	number	派彩金额
currency	string	玩家货币
game_code	string	游戏代码
bet_id	number	投注注单 ID
round_id	string or number	局号（目前仅 double 轮盘游戏为 string 格式）
number	string	更新后的投注内容
is_free_spin	boolean	（选填）仅在免费旋转促销注单派彩时传送且值为 `true`；正常注单绝不包含此字段。
sign	string	参数签名

【重要说明】关于 is_free_spin 字段：

正常注单：常规真钱注单与购买免费游戏（Buy Feature）的派彩请求中绝对不会包含该字段（连 key 都不存在），确保 100% 保持向后兼容，不影响现有接入方的任何既有逻辑。

Free Spin 促销注单：仅在免费旋转促销活动产生的注单派彩时，请求体中才会额外带上 "is_free_spin": true。接入方可根据此字段自行决定将奖金发放到现金钱包还是需要打码的红利（Bonus）钱包。

number 字段详情

游戏	类型	示例与说明
crash	string	示例：`1.2`
double	string	示例：`1`；0 黄色，1 绿色，2 蓝色
plinko	string	示例：`{"layer":8,"level":0}`；level：0 蓝色，1 绿色，2 红色
keno	string	示例：`{"number":[1,2,3],"level":0}`；level（风险）：0 低，1 中，2 高
dice	string	示例：`90`
triple	string	示例：`{"position":[10,2,3],"level":0}`；level（风险）：0 低，1 中，2 高
bingo	string	示例：`[58,22,65,39,5,17,68,18,29,38,47,46,45,48,11,41,74,64,20,51,73,63,21,57]`
limbo	string	示例：`2`
crypto	string	固定为空字符串
coin	string	示例：`1` 或 `"[1,1]"`（单次或多次）；1 人头，2 字
mine	string	示例：`[0]`
tower	string	示例：`[0]`
hilo	string	示例：`[0,2,3]`；0 跳过，1 相等，2 小于，3 大于
poker	string	示例：`[ 32, 44, 26, 39, 2 ]`
wheel	string	固定为空字符串
nine	string	示例：`[0]`
3001	string	示例：`{"content":[49,49,20,"顺",15,51,22,9,49,44,3,46,4],"lucky_draw":[6,8,16,18,66,68,88,"顺","发"]}`；刮刮乐内容与中奖符号
3002	string	示例：`{"content":[15,28,24,51,77,47,75,12,29,59,36,91,6,9,88,22,41,12,26,73,90,33,55,94,94,64,48,86,55,95,85,14,66,13,89,72,69,12,95,66,16,58,90,96,14,24,74,62,41,62,30,38],"lucky_draw":46}`；刮刮乐内容与中奖数字
3003	string	示例：`{"content":[220,158,398,519,638,514,893,238,602,215,830,126,780,524,66,758,350,809,396,192,894,667,107,694,234,535,159,226,917,912,85,194,344,740,506,378,327,707,410,684,466,246,147,840,605,0,24,717,722],"lucky_draw":[0,7,77,777]}`；刮刮乐内容与中奖号码
3004	string	示例：`{"content":[2,7,1,8,5,4,0,4,7],"lucky_draw":[]}`；刮刮乐内容，仅 7 计为中奖图形；lucky_draw 固定为空数组
3005	string	示例：`{"content":[1,0,0,0,0,0,0,0,0,0,0,0],"lucky_draw":[1]}`；刮刮乐内容，1 表示中奖；lucky_draw 固定为包含元素 1 的数组

{
  "unique_id": "testId",
  "timestamp": 1654752446,
  "merchant_code": "testMerchant",
  "username": "testPlayer",
  "amount": 60,
  "currency": "USD",
  "game_code": "double",
  "bet_id": 99,
  "round_id": "testRound",
  "number": "white",
  "sign": "testSign"
}

返回响应 (Response)

参数名称	类型	说明
is_success	boolean	投注是否成功，不传默认为 true（成功）
err_msg	string	操作失败时的错误说明
balance	number	玩家余额
currency	string	玩家货币

{
  "is_success": true,
  "err_msg": "",
  "balance": 100,
  "currency": "test"
}

注单退款 (Refund)

接入方需核对 bet_id、局号 round_id，以及退回金额 amount 是否与原投注时一致。

重要注意事项：

针对所有投注失败的注单，我方均会调用退款接口。接入方需判断该局此前是否已扣除余额；若此前未扣除余额，则接入方在 refund webhook 的实现中无需加回余额。

接口地址：/{host_url}/refund

请求方式：POST

请求体 (Body)

参数名称	类型	说明
unique_id	string	独立识别每次调用接口的唯一 ID
timestamp	number	当前时间戳（Unix 秒）
merchant_code	string	商户号
username	string	玩家用户名
amount	number	退回金额
currency	string	玩家货币
game_code	string	游戏代码
bet_id	number	投注注单 ID
round_id	string or number	局号（目前仅 double 轮盘游戏为 string 格式）
type	integer	1: 退款，2: 派彩失败，3: 局取消
sign	string	参数签名

{
  "unique_id": "testId",
  "timestamp": 1654752446,
  "merchant_code": "testMerchant",
  "username": "testPlayer",
  "amount": 30,
  "currency": "USD",
  "game_code": "double",
  "bet_id": 99,
  "round_id": "testRound",
  "type": 1,
  "sign": "testSign"
}

返回响应 (Response)

参数名称	类型	说明
is_success	boolean	投注是否成功，不传默认为 true（成功）
err_msg	string	操作失败时的错误说明
balance	number	玩家余额
currency	string	玩家货币

{
  "is_success": true,
  "err_msg": "",
  "balance": 100,
  "currency": "test"
}

身份验证

生成 Token

使用商户号和安全秘钥生成 token

timeout在600之内时，会生成返回新的auth token，并刷新过期时间

Request Body schema: application/json

merchant_code required	string
secure_key required	string
sign required	string 参数签名，依据安全模式的签名规则

Responses

Request samples

Payload

Content type

application/json

{"merchant_code": "string",
"secure_key": "string",
"sign": "string"
}

Response samples

Content type

application/json

{"success": true,
"code": 0,
"detail": {"auth_token": "8f5a3598a8c44f46b41d0a5a8fc3cee0",
"timeout": 7198
}
}

玩家

创建玩家账号

创建玩家游戏账号

Request Body schema: application/json

auth_token required	string 32 characters 来自身份认证 API
merchant_code required	string
username required	string [ 6 .. 100 ] characters 玩家用户名
sign required	string 参数签名，依据安全模式的签名规则

Responses

Request samples

Payload

Content type

application/json

{"auth_token": "stringstringstringstringstringst",
"merchant_code": "string",
"username": "string",
"sign": "string"
}

Response samples

Content type

application/json

{"success": true,
"code": 0,
"detail": {"id": 11354,
"role": 3,
"username": "o2p1633071566",
"company": 11336
}
}

查询玩家信息

query Parameters

auth_token required	string 32 characters 来自身份认证 API
merchant_code required	string
username required	string [ 6 .. 100 ] characters 玩家用户名
sign required	string 参数签名，依据安全模式的签名规则

Responses

Response samples

Content type

application/json

{"success": true,
"code": 0,
"detail": {"id": 11354,
"role": 3,
"username": "o2p1633071566",
"company": 11336
}
}

踢出玩家

剔除玩家

Request Body schema: application/json

auth_token required	string 32 characters 来自身份认证 API
merchant_code required	string
username required	string [ 6 .. 100 ] characters 玩家用户名
sign required	string 参数签名，依据安全模式的签名规则

Responses

Request samples

Payload

Content type

application/json

{"auth_token": "stringstringstringstringstringst",
"merchant_code": "string",
"username": "string",
"sign": "string"
}

Response samples

Content type

application/json

{"success": true,
"code": 0,
"detail": "ok"
}

禁用玩家

Request Body schema: application/json

auth_token required	string 32 characters 来自身份认证 API
merchant_code required	string
username required	string [ 6 .. 100 ] characters 玩家用户名
sign required	string 参数签名，依据安全模式的签名规则

Responses

Request samples

Payload

Content type

application/json

{"auth_token": "stringstringstringstringstringst",
"merchant_code": "string",
"username": "string",
"sign": "string"
}

Response samples

Content type

application/json

{"success": true,
"code": 0,
"detail": {"blocked": true
}
}

启用玩家

Request Body schema: application/json

auth_token required	string 32 characters 来自身份认证 API
merchant_code required	string
username required	string [ 6 .. 100 ] characters 玩家用户名
sign required	string 参数签名，依据安全模式的签名规则

Responses

Request samples

Payload

Content type

application/json

{"auth_token": "stringstringstringstringstringst",
"merchant_code": "string",
"username": "string",
"sign": "string"
}

Response samples

Content type

application/json

{"success": true,
"code": 0,
"detail": {"blocked": false
}
}

区块链游戏

启动游戏

query Parameters

auth_token

required

string 32 characters

来自身份认证 API

merchant_code

required

string

game_code

required

string

参考游戏列表的 Game Code 值

传入 lobby 时启动游戏大厅

username

required

string [ 6 .. 100 ] characters

玩家用户名

language

required

string

Enum: "en" "zh" "vi" "th" "id" "pt" "ar" "de" "es-MX" "es" "fr" "hu" "it" "ro" "ko" "ja" "tr" "ru"

值	语系	mini	刮刮乐	slot	lottery
en	英文	o	o	o	o
zh	简体中文	o	o	o	o
vi	越南文	o		o
th	泰文	o	o (not available to 3001)	o
id	印尼文	o	o (not available to 3001)	o
pt	葡萄牙文	o	o (not available to 3001)	o
ar	阿拉伯语	o		o
de	德语	o		o
es-MX	墨西哥文	o		o
es	西班牙文	o		o
fr	法文	o		o
hu	匈牙利语	o		o
it	意大利语	o		o
ro	罗马尼亚语	o		o
ko	韩文	o	o (not available to 3001)	o
ja	日文	o	o (not available to 3001)	o
tr	土耳其语	o	o (not available to 3001)	o
ru	俄语	o		o

sign

required

string

参数签名，依据安全模式的签名规则

home_link

string

如果传入，则游戏页面会显示一个可以导向此网址的按钮

trial

boolean

是否启动试玩页面

传 true 时会启动试玩页面
不传入、或是传 false 时，启动正常游戏页面
试玩页面的玩家独立于原玩家，有2000试玩金，不可转入和转出，试玩的游戏记录不提供拉取

Responses

Response samples

Content type

application/json

{"success": true,
"code": 0,
"detail": {"game_url": "test"
}
}

查询小游戏历史注单流水

串流查询游戏历史 (建议使用)

两次请求间隔不可低于3s
- 只可请求一个月内游戏数据
- 每次查询最多返回 10000 笔记录
- 返回的游戏记录按照投注时间以递增方式排序，也就是最久远的资料为第 1 笔
- 利用返回游戏记录的最后一笔的 uniqueid 值，传入查询参数的 last_bet_id 栏位时，可以实现下页查询

query Parameters

auth_token required	string 32 characters 来自身份认证 API
merchant_code required	string
from required	string 投注时间范围起始，东八时区的日期时间字串
to required	string 投注时间范围终点，东八时区的日期时间字串
sign required	string 参数签名，依据安全模式的签名规则
game_code	string 参考游戏列表 Classic 系列与 Monster 系列的 Game Code 值
time_type	integer Enum: 1 2 过滤的时间类型，预设 1 1: 投注时间 2: 派彩时间
last_bet_id	string 指定要返回 ID 比这个值更大的记录

Responses

Response samples

Content type

application/json

{"success": true,
"code": 0,
"time": 1708570865824,
"rid": 1923,
"cost": 10,
"detail": {"has_next": false,
"total_rows_current_page": 2,
"game_history": [{"uniqueid": "crash_1000000775",
"username": "o2p1708570800",
"game_code": "crash",
"game_tag": 1,
"bet_time": 1708570803,
"payout_time": 1708570803,
"game_finish_time": 1708570803,
"bet_amount": 100,
"payout_amount": 0,
"status": 5,
"bet_details": {"period": "10516",
"cashout": 999,
"cashout_auto": 1000,
"try_cashout": true
},
"result_details": {"result_point": 3.31,
"result_seed": "c9ac9fe477475e71c119c4db8777acfacb9378da627afc051e7a44c8b029e083"
}
},
{"uniqueid": "crash_1000000811",
"username": "o2p1708570800",
"game_code": "crash",
"game_tag": 1,
"bet_time": 1708570855,
"payout_time": 1708570855,
"game_finish_time": 1708570855,
"bet_amount": 100,
"payout_amount": 120,
"status": 4,
"bet_details": {"period": "10517",
"cashout": 1.2,
"cashout_auto": 1.2,
"try_cashout": false
},
"result_details": {"result_point": 3.89,
"result_seed": "7b8d6cd658b0fcb4c8507184844c6b395c14fa722b408266cc6f717a15826d5c"
}
}
]
}
}

刮刮乐

查询刮刮乐历史注单流水

串流查询游戏历史 (建议使用)

两次请求间隔不可低于3s
- 只可请求一个月内游戏数据
- 每次查询最多返回 10000 笔记录
- 返回的游戏记录按照投注时间以递增方式排序，也就是最久远的资料为第 1 笔
- 利用返回游戏记录的最后一笔的 uniqueid 值，传入查询参数的 last_bet_id 栏位时，可以实现下页查询

query Parameters

auth_token required	string 32 characters 来自身份认证 API
merchant_code required	string
from required	string 投注时间范围起始，东八时区的日期时间字串
to required	string 投注时间范围终点，东八时区的日期时间字串
sign required	string 参数签名，依据安全模式的签名规则
game_code	string 参考游戏列表 Scratch 系列的 Game Code 值
time_type	integer Enum: 1 2 过滤的时间类型，预设 1 1: 投注时间 2: 派彩时间
last_bet_id	string 指定要返回 ID 比这个值更大的记录

Responses

Response samples

Content type

application/json

{"success": true,
"code": 0,
"time": 1708572889906,
"rid": 2173,
"cost": 11,
"detail": {"has_next": false,
"total_rows_current_page": 15,
"game_history": [{"uniqueid": "3001_100943",
"username": "o2p1708572807",
"game_code": "3001",
"game_tag": 10,
"bet_time": 1708572859,
"payout_time": 1708572859,
"game_finish_time": 1708572859,
"bet_amount": 100,
"payout_amount": 0,
"status": 3,
"bet_details": {"content": [38,
71,
68,
58,
4,
39,
57,
32,
33,
80,
70,
7,
7
],
"lucky_draw": [6,
8,
16,
18,
66,
68,
88,
"顺",
"发"
]
},
"result_details": {"award": [[8,
10000,
50000
],
[7,
1000,
5000
],
[6,
100,
500
],
[5,
10,
50
],
[4,
5,
25
],
[3,
3,
3
],
[2,
1.2,
1.2
],
[1,
0,
0
],
[0,
0,
0
]
]
}
},
{"uniqueid": "3001_100944",
"username": "o2p1708572807",
"game_code": "3001",
"game_tag": 10,
"bet_time": 1708572859,
"payout_time": 1708572859,
"game_finish_time": 1708572859,
"bet_amount": 100,
"payout_amount": 120,
"status": 3,
"bet_details": {"content": [66,
58,
78,
24,
20,
65,
9,
34,
74,
26,
21,
16,
7
],
"lucky_draw": [6,
8,
16,
18,
66,
68,
88,
"顺",
"发"
]
},
"result_details": {"award": [[8,
10000,
50000
],
[7,
1000,
5000
],
[6,
100,
500
],
[5,
10,
50
],
[4,
5,
25
],
[3,
3,
3
],
[2,
1.2,
1.2
],
[1,
0,
0
],
[0,
0,
0
]
]
}
},
{"uniqueid": "3001_100945",
"username": "o2p1708572807",
"game_code": "3001",
"game_tag": 10,
"bet_time": 1708572859,
"payout_time": 1708572859,
"game_finish_time": 1708572859,
"bet_amount": 100,
"payout_amount": 0,
"status": 3,
"bet_details": {"content": [50,
"顺",
23,
30,
23,
61,
63,
46,
87,
26,
65,
51,
9
],
"lucky_draw": [6,
8,
16,
18,
66,
68,
88,
"顺",
"发"
]
},
"result_details": {"award": [[8,
10000,
50000
],
[7,
1000,
5000
],
[6,
100,
500
],
[5,
10,
50
],
[4,
5,
25
],
[3,
3,
3
],
[2,
1.2,
1.2
],
[1,
0,
0
],
[0,
0,
0
]
]
}
},
{"uniqueid": "3001_100946",
"username": "o2p1708572807",
"game_code": "3001",
"game_tag": 10,
"bet_time": 1708572859,
"payout_time": 1708572859,
"game_finish_time": 1708572859,
"bet_amount": 100,
"payout_amount": 0,
"status": 3,
"bet_details": {"content": [34,
15,
6,
69,
22,
81,
57,
38,
59,
67,
50,
3,
7
],
"lucky_draw": [6,
8,
16,
18,
66,
68,
88,
"顺",
"发"
]
},
"result_details": {"award": [[8,
10000,
50000
],
[7,
1000,
5000
],
[6,
100,
500
],
[5,
10,
50
],
[4,
5,
25
],
[3,
3,
3
],
[2,
1.2,
1.2
],
[1,
0,
0
],
[0,
0,
0
]
]
}
}
]
}
}

老虎机

查询老虎机历史注单流水

串流查询游戏历史 (建议使用)

两次请求间隔不可低于3s
- 只可请求一个月内游戏数据
- 每次查询最多返回 10000 笔记录
- 返回的游戏记录按照投注时间以递增方式排序，也就是最久远的资料为第 1 笔
- 利用返回游戏记录的最后一笔的 uniqueid 值，传入查询参数的 last_bet_id 栏位时，可以实现下页查询

query Parameters

auth_token required	string 32 characters 来自身份认证 API
merchant_code required	string
from required	string 投注时间范围起始，东八时区的日期时间字串
to required	string 投注时间范围终点，东八时区的日期时间字串
sign required	string 参数签名，依据安全模式的签名规则
game_code	string 参考游戏列表 Slot 系列的 Game Code 值
time_type	integer Enum: 1 2 过滤的时间类型，预设 1 1: 投注时间 2: 派彩时间
last_bet_id	string 指定要返回 ID 比这个值更大的记录

Responses

Response samples

Content type

application/json

{"success": true,
"code": 0,
"time": 1728878471091,
"rid": 7801,
"cost": 33,
"detail": {"has_next": false,
"total_rows_current_page": 4,
"game_history": [{"uniqueid": "7001_100879",
"username": "o2p1728878370",
"game_code": "7001",
"game_tag": 30,
"bet_time": 1728878467,
"payout_time": 1728878467,
"game_finish_time": 1728878467,
"bet_amount": 100,
"payout_amount": 0,
"status": 3,
"bet_details": { },
"result_details": {"odds": 0,
"content": [6,
9,
12
]
}
},
{"uniqueid": "7001_100880",
"username": "o2p1728878370",
"game_code": "7001",
"game_tag": 30,
"bet_time": 1728878467,
"payout_time": 1728878467,
"game_finish_time": 1728878467,
"bet_amount": 100,
"payout_amount": 0,
"status": 3,
"bet_details": { },
"result_details": {"odds": 0,
"content": [1,
6,
5
]
}
},
{"uniqueid": "7001_100881",
"username": "o2p1728878370",
"game_code": "7001",
"game_tag": 30,
"bet_time": 1728878467,
"payout_time": 1728878467,
"game_finish_time": 1728878467,
"bet_amount": 100,
"payout_amount": 0,
"status": 3,
"bet_details": { },
"result_details": {"odds": 0,
"content": [12,
6,
0
]
}
},
{"uniqueid": "7001_100882",
"username": "o2p1728878370",
"game_code": "7001",
"game_tag": 30,
"bet_time": 1728878467,
"payout_time": 1728878467,
"game_finish_time": 1728878467,
"bet_amount": 100,
"payout_amount": 0,
"status": 3,
"bet_details": { },
"result_details": {"odds": 0,
"content": [9,
3,
1
]
}
}
]
}
}

查询老虎机注单详情（回放链接）

查询老虎机注单开奖结果重播网址

传入带游戏代码前缀的 bet_id (对应 query_history_stream 返回的 uniqueid，例如 7001_1234567) 查询老虎机注单开奖结果重播网址
- 返回的网址包含带时效的 Token (10 分钟内有效)，可供独立重播站点展示

query Parameters

auth_token required	string 32 characters 来自身份认证 API
merchant_code required	string
bet_id required	string Example: bet_id=7001_1234567 注单唯一标识（需带有游戏代码前缀，对应 query_history_stream 返回的 uniqueid，例如 7001_1234567）
sign required	string 参数签名，依据安全模式的签名规则

Responses

Response samples

Content type

application/json

{"success": true,
"code": 0,
"time": 1728878471091,
"rid": 7801,
"cost": 15,
"detail": {"game_result": "https://replay.yourdomain.com/slot?code=a1b2c3d4e5f6"
}
}

彩票

查询彩票历史注单流水

串流查询游戏历史 (建议使用)

两次请求间隔不可低于3s
- 只可请求一个月内游戏数据
- 每次查询最多返回 10000 笔记录
- 返回的游戏记录按照投注时间以递增方式排序，也就是最久远的资料为第 1 笔
- 利用返回游戏记录的最后一笔的 uniqueid 值，传入查询参数的 last_bet_id 栏位时，可以实现下页查询

query Parameters

auth_token required	string 32 characters 来自身份认证 API
merchant_code required	string
from required	string 投注时间范围起始，东八时区的日期时间字串
to required	string 投注时间范围终点，东八时区的日期时间字串
sign required	string 参数签名，依据安全模式的签名规则
game_code	string 参考游戏列表 Lottery 系列的 Game Code 值
time_type	integer Enum: 1 2 过滤的时间类型，预设 1 1: 投注时间 2: 派彩时间
last_bet_id	string 指定要返回 ID 比这个值更大的记录

Responses

Response samples

Content type

application/json

{"success": true,
"code": 0,
"time": 1779773819053,
"rid": 439,
"cost": 31,
"detail": {"has_next": false,
"total_rows_current_page": 9,
"game_history": [{"uniqueid": "5026_1000726",
"username": "o2p1779773790",
"game_code": "5026",
"game_tag": 20,
"bet_time": 1779773815,
"payout_time": 1779773815,
"game_finish_time": 1779773815,
"bet_amount": 1,
"payout_amount": 0,
"status": 3,
"bet_details": {"odds_rule": {"$": 1.9
},
"number": "大",
"period": "202605260817"
},
"result_details": {"opencode": "01|02|03|04|05",
"bet_shot": null
}
},
{"uniqueid": "5026_1000727",
"username": "o2p1779773790",
"game_code": "5026",
"game_tag": 20,
"bet_time": 1779773815,
"payout_time": 1779773815,
"game_finish_time": 1779773815,
"bet_amount": 1,
"payout_amount": 1.9,
"status": 3,
"bet_details": {"odds_rule": {"$": 1.9
},
"number": "小",
"period": "202605260817"
},
"result_details": {"opencode": "01|02|03|04|05",
"bet_shot": "$"
}
},
{"uniqueid": "5026_1000728",
"username": "o2p1779773790",
"game_code": "5026",
"game_tag": 20,
"bet_time": 1779773815,
"payout_time": 1779773815,
"game_finish_time": 1779773815,
"bet_amount": 1,
"payout_amount": 1.9,
"status": 3,
"bet_details": {"odds_rule": {"$": 1.9
},
"number": "单",
"period": "202605260817"
},
"result_details": {"opencode": "01|02|03|04|05",
"bet_shot": "$"
}
},
{"uniqueid": "5026_1000729",
"username": "o2p1779773790",
"game_code": "5026",
"game_tag": 20,
"bet_time": 1779773815,
"payout_time": 1779773815,
"game_finish_time": 1779773815,
"bet_amount": 1,
"payout_amount": 1.9,
"status": 3,
"bet_details": {"odds_rule": {"$": 1.9
},
"number": "双",
"period": "202605260817"
},
"result_details": {"opencode": "01|02|03|04|05",
"bet_shot": "$"
}
},
{"uniqueid": "5026_1000730",
"username": "o2p1779773790",
"game_code": "5026",
"game_tag": 20,
"bet_time": 1779773815,
"payout_time": 1779773815,
"game_finish_time": 1779773815,
"bet_amount": 1,
"payout_amount": 0,
"status": 3,
"bet_details": {"odds_rule": {"$": 10.45
},
"number": "11",
"period": "202605260817"
},
"result_details": {"opencode": "01|02|03|04|05",
"bet_shot": null
}
},
{"uniqueid": "5026_1000731",
"username": "o2p1779773790",
"game_code": "5026",
"game_tag": 20,
"bet_time": 1779773815,
"payout_time": 1779773815,
"game_finish_time": 1779773815,
"bet_amount": 1,
"payout_amount": 0,
"status": 3,
"bet_details": {"odds_rule": {"$": 1.9
},
"number": "大",
"period": "202605260817"
},
"result_details": {"opencode": "01|02|03|04|05",
"bet_shot": null
}
},
{"uniqueid": "5026_1000732",
"username": "o2p1779773790",
"game_code": "5026",
"game_tag": 20,
"bet_time": 1779773815,
"payout_time": 1779773815,
"game_finish_time": 1779773815,
"bet_amount": 1,
"payout_amount": 0,
"status": 3,
"bet_details": {"odds_rule": {"$": 1.938
},
"number": "双",
"period": "202605260817"
},
"result_details": {"opencode": "01|02|03|04|05",
"bet_shot": null
}
},
{"uniqueid": "5026_1000733",
"username": "o2p1779773790",
"game_code": "5026",
"game_tag": 20,
"bet_time": 1779773815,
"payout_time": 1779773815,
"game_finish_time": 1779773815,
"bet_amount": 1,
"payout_amount": 0,
"status": 3,
"bet_details": {"odds_rule": {"$": 1.9
},
"number": "龙",
"period": "202605260817"
},
"result_details": {"opencode": "01|02|03|04|05",
"bet_shot": null
}
},
{"uniqueid": "5026_1000734",
"username": "o2p1779773790",
"game_code": "5026",
"game_tag": 20,
"bet_time": 1779773815,
"payout_time": 1779773815,
"game_finish_time": 1779773815,
"bet_amount": 1,
"payout_amount": 1.9,
"status": 3,
"bet_details": {"odds_rule": {"$": 1.9
},
"number": "虎",
"period": "202605260817"
},
"result_details": {"opencode": "01|02|03|04|05",
"bet_shot": "$"
}
}
]
}
}