DeBox App 深链接
DeBox 支持通过链接直接进入 App 内的指定页面。本页介绍代币行情和 Swap 自定义协议链接、分佣渠道归因，以及群主页和个人主页使用的 HTTPS 分享链接。
1. 代币行情交易页
使用以下格式打开 DeBox 中指定代币的行情交易页：
debox://rn/trade/token?tokenId={代币地址}-{链标识}
tokenId 由代币地址、连字符和 DeBox 支持的链标识组成。目前确认可用的链标识为 eth 和 bsc。
1.1 非原生代币
非原生代币填写该代币在对应链上的合约地址：
debox://rn/trade/token?tokenId={代币合约地址}-bsc
debox://rn/trade/token?tokenId={代币合约地址}-eth
1.2 原生代币
查看某条链的原生代币时，使用以下固定地址代替合约地址：
0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE
示例：
debox://rn/trade/token?tokenId=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE-bsc
debox://rn/trade/token?tokenId=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE-eth
打开 Deep Link 后，用户会进入 DeBox 中对应代币的行情交易页。页面会展示价格、行情图表、交易记录、持仓地址和资金池等信息，并提供买入、卖出入口。用户可以在页面中主动进入相应的买卖流程，最终交易仍需由用户确认。Deep Link 本身只负责打开目标代币页面，不会在点击链接时自动完成交易。
2. Swap 交易弹窗深链接
开发者可以使用以下 Deep Link 打开 DeBox 内置 Swap 弹窗，并预填交易链、卖出代币和买入代币：
debox://rn/trade/swap/modal?chainId={chainId}&fromTokenAddress={fromTokenAddress}&toTokenAddress={toTokenAddress}&display=modal
如果需要预填卖出数量，可以增加 amount：
debox://rn/trade/swap/modal?chainId={chainId}&fromTokenAddress={fromTokenAddress}&toTokenAddress={toTokenAddress}&amount={amount}&display=modal
2.1 参数说明
| 参数 | 说明 |
|---|---|
chainId | 初始交易链；缺省为 BSC（56）。 |
fromTokenAddress | 预填卖出代币的合约地址。 |
toTokenAddress | 预填买入代币的合约地址。 |
amount | 可选，预填卖出数量。 |
display | 填写 modal 时，以弹窗形式打开 Swap。 |
refGid | 可选，填写 DeBox 群 gid，将交易归因到该群渠道；符合条件的群渠道收益归属于该群群主。 |
动态生成链接时，应对参数值进行 URL 编码。
2.2 分佣渠道归因
仅设置群渠道归因：
debox://rn/trade/swap/modal?chainId={chainId}&fromTokenAddress={fromTokenAddress}&toTokenAddress={toTokenAddress}&display=modal&refGid={gid}
refGid 是可选的群渠道归因参数。对于符合条件的交易，群渠道收益归属于指定群的群主。
Swap 弹窗 Deep Link 不会创建、修改或覆盖用户已有的邀请关系。邀请相关收益以用户已有的 DeBox 邀请关系及当前平台规则为准。refUid 不参与 Swap 分佣判定，不应作为 Swap 分佣参数使用。
该 Deep Link 可以放在 Bot 的 URL 按钮或富文本链接中。用户点击后会打开 DeBox 内置 Swap 弹窗，但仍需核对并确认交易，链接本身不会自动完成兑换。
2.3 与 IM 区块链按钮的关系
IM 区块链按钮也可以通过 debox://wallet/request 携带 method: "swap" 的 JSON-RPC 请求，唤起 DeBox 原生 Swap。
需要通过 URL 按钮或富文本链接预填 Swap，或者使用 refGid 设置群渠道分佣归因时，可以使用本节介绍的 Swap 弹窗 Deep Link。钱包请求格式请查看 DeBox 机器人区块链按钮。
3. 群分享链接与 gid
DeBox 群分享链接的基础格式为：
https://m.debox.pro/group?id={gid}
链接中 id 的值就是 DeBox OpenAPI 使用的群 gid。复制出的分享链接可能还会包含 code 等其他参数；需要提取目标群的 gid 时，读取 id 即可。
在 DeBox App 中复制群分享链接：
第一步：打开群设置。
第二步：点击分享按钮。
第三步：点击“复制链接”。
4. 个人主页分享链接与 user_id
DeBox 个人主页分享链接可以使用以下两种格式：
https://m.debox.pro/card?id={target_user_id}
https://m.debox.pro/card?id={target_user_id}&invite_code={invite_code}
同一个 DeBox 用户标识，在不同位置会使用不同的字段名：
| 出现位置 | 字段名 | 含义 |
|---|---|---|
DApp debox_getUserInfo 返回值 | uid | 当前用户的 DeBox 标识 |
| OpenAPI | user_id | 同一个用户的 DeBox 标识 |
| 用户邀请码 | invite_code | 数值与该用户的 uid 相同 |
| 个人主页分享链接 | id | 目标主页用户的 user_id |
| Bot 私聊消息 | chat_id | chat_type=private 时填写目标用户的 user_id |
这些字段可以使用相同的用户标识值，但字段名和用途不能混用，调用时仍应使用接口或链接规定的字段名。个人主页链接中，id 决定打开谁的主页；invite_code 是可选的邀请码/来源参数。识别目标个人主页时，应读取 id，不能用 invite_code 代替。
在 DeBox App 中复制个人主页分享链接：
第一步：打开个人主页分享面板。
第二步：点击“复制链接”。
5. 使用注意事项
tokenId参数名应保持与示例完全一致。- 代币行情链接使用
eth、bsc等受支持的链标识；Swap 弹窗链接使用数值chainId，例如 BSC 为56。两种格式不要混用。 - 如果链接参数来自外部输入，应先校验代币地址、链标识、
chainId、gid、uid和user_id，并对动态查询参数值进行 URL 编码。 debox://链接需要在能够由 DeBox 处理该协议的设备上打开。- HTTPS 分享链接用于定位群或个人主页；
debox://rn/trade/token用于打开代币行情交易页，debox://rn/trade/swap/modal用于打开预填的 Swap 弹窗。