DeBox App Deep Links

DeBox supports links that take users directly to a specific destination in the app. This page covers the token market custom scheme and the HTTPS share links for groups and user profiles.

1. Token market and trading page

Use the following format to open a token's market and trading page in DeBox:

debox://rn/trade/token?tokenId={tokenAddress}-{chainIdentifier}

tokenId consists of the token address, a hyphen, and a DeBox-supported chain identifier. The currently confirmed identifiers are eth and bsc.

1.1 Non-native token

For a non-native token, use its contract address on the selected chain:

debox://rn/trade/token?tokenId={tokenContractAddress}-bsc
debox://rn/trade/token?tokenId={tokenContractAddress}-eth

1.2 Native token

For a chain's native token, use this fixed address in place of a contract address:

0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE

Examples:

debox://rn/trade/token?tokenId=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE-bsc
debox://rn/trade/token?tokenId=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE-eth

Opening the Deep Link takes the user to the selected token's market and trading page in DeBox. The page shows price data, charts, transaction history, holder information, and liquidity data, and it provides Buy and Sell actions. The user can enter the corresponding trade flow from the page and must still confirm the final transaction. Opening the Deep Link does not complete a trade by itself.

Token market and trading page opened from a Deep Link

Choose the appropriate integration

Use a market Deep Link when you want to reuse DeBox's existing token market and trading page. If your product needs a custom contract call, form, or business flow, use an IM blockchain button or an H5/DApp flow.

2. Group share link and gid

A DeBox group share link uses this base format:

https://m.debox.pro/group?id={gid}

The id query value is the group gid used by DeBox OpenAPI. A copied share link may contain additional parameters such as code; read id when extracting the target group's gid.

To copy a group share link in the DeBox App:

Step 1: Open the group settings.

Step 2: Tap the Share button.

Step 3: Tap Copy Link.

3. User profile share link and user_id

A DeBox user profile share link can use either of these formats:

https://m.debox.pro/card?id={target_user_id}
https://m.debox.pro/card?id={target_user_id}&invite_code={invite_code}

The same DeBox user identifier appears under different field names depending on where it is used:

Where it appears	Field	Meaning
DApp debox_getUserInfo response	uid	Current user's DeBox identifier
OpenAPI	user_id	The same user's DeBox identifier
User invitation code	invite_code	The same value as that user's uid
User profile share URL	id	The user_id of the target profile
Private Bot message	chat_id	The target user's user_id when chat_type=private

These fields may carry the same identifier value, but their names and purposes are not interchangeable. Use the field name required by each API or URL. In a user profile link, id selects the target profile; invite_code is an optional invitation/source parameter. Always read id when identifying the target profile.

To copy a user profile share link in the DeBox App:

Step 1: Open the profile Share panel.

Step 2: Tap Copy Link.

4. Usage notes

• Keep the query key tokenId exactly as shown.
• Use only chain identifiers supported by the current DeBox client. The examples on this page cover the confirmed eth and bsc identifiers.
• Validate token addresses, chain identifiers, gid, and user_id before constructing links from external input.
• Open the debox:// scheme on a device where DeBox can handle it.
• HTTPS share links and the debox:// token route have different purposes: share links identify a group or profile, while the token route opens DeBox's market and trading page.