Deep Links

Cove deep links encode the full action inside the Telegram /start payload. They are self-contained, so your app can generate them without storing shared state or calling Cove before the user clicks.

Telegram limits the /start parameter to 64 characters. Cove deep links use fixed-width Base62 segments so payloads stay compact enough for Telegram links.

Quick reference

For token links, encode the token address into Base62 first: 27 chars for EVM tokens, 43 chars for Solana tokens. Use the chain code table below to choose e, b, n, m, s, and other supported networks.

Group buy

Fixed-size buy that can execute immediately for onboarded users.

g_{amount}{chainCode}{base62Token}

https://t.me/cove_trading_bot?start=g_10s<43-char-base62-token>

Group sell

Sells a percentage of the clicker’s own token position.

gs_{percent}{chainCode}{base62Token}

https://t.me/cove_trading_bot?start=gs_50e<27-char-base62-token>

Referral

Share a token link with referral attribution.

ref_{ref}-{tokenAddress}

https://t.me/cove_trading_bot?start=ref_alice-0xf30bf00edd0c22db54c9274b90d2a4c21fc09b07

Need attribution? Append both optional IDs as a 14-character tail:

{base62AffiliateId}{base62GroupId}

Use 0000000 when one of the two values is intentionally empty.

https://t.me/cove_trading_bot?start=g_0d5b<27-char-base62-token><7-char-affiliate>0000000

Link types

Group Buy

g_ links execute a buy for a fixed USD amount.

Market Buy Panel

b_ links open the token buy panel so the user can choose the amount.

Group Sell

gs_ links sell a percentage of the clicker’s own token position.

Referral

ref_ links share a token with referral attribution.

Base URL:

https://t.me/cove_trading_bot?start={payload}

Shared encoding

The g_, b_, and gs_ token-action links use the same chain codes, address encoding, and optional affiliate/group tail.

Chain codes

Code	Chain	Chain ID
`e`	Ethereum	1
`b`	Base	8453
`n`	BNB Chain	56
`m`	MegaETH	4326
`s`	Solana	1399811149
`t`	Tempo	4217
`o`	Monad	143
`y`	Story	1514
`h`	HyperEVM	999
`p`	Plasma	9745

Deep-link codes are not currently published for Arbitrum One, Robinhood Chain, or Stable. Generate payloads only for the chain codes listed above.

Token address width

Chain type	Raw address bytes	Base62 width
EVM	20 bytes	27 chars
Solana	32 bytes	43 chars

For EVM addresses, strip 0x and hex-decode the address bytes before Base62 encoding. For Solana addresses, base58-decode the address into 32 bytes before Base62 encoding.

Optional affiliate and group IDs

Token links can optionally include an affiliate Telegram user ID and a source Telegram group ID.

Segment	Width	Description
`base62AffiliateId`	7 chars	Affiliate Telegram user ID
`base62GroupId`	7 chars	Source Telegram group ID

The affiliate and group segments are either both present (14 chars total) or both absent. Use 0000000 as the sentinel when only one value is needed. Encode Telegram IDs by converting the numeric ID to Base62 and left-padding it to 7 characters. For Telegram group IDs, remove the -100 prefix before encoding. For example, -1002036764921 becomes 2036764921.

Group buy links

Use g_ links when you want a click to buy a token for a fixed USD amount.

g_{amount}{chainCode}{base62Token}[{base62AffiliateId}{base62GroupId}]

Field	Width	Description
`g_`	2 chars	Fixed prefix
`amount`	1-4 chars	USD amount. Use `d` instead of a decimal point, e.g. `10`, `0d5`, `1d5`, `9999`
`chainCode`	1 char	Chain identifier
`base62Token`	27 or 43 chars	Base62-encoded token address
`base62AffiliateId`	7 chars	Optional affiliate Telegram user ID
`base62GroupId`	7 chars	Optional source Telegram group ID

Behavior:

Onboarded users execute the buy immediately.
New users enter onboarding first. If an affiliate is present, Cove can attach it during onboarding, but the buy does not auto-execute.
If affiliate or group metadata is present, Cove records it for attribution and reporting.

Length limits

Chain type	Worst-case length
Solana	`g_` + `9999` + `s` + 43-char token + 14-char tail = 64 chars
EVM	`g_` + `9999` + `b` + 27-char token + 14-char tail = 48 chars

Examples:

https://t.me/cove_trading_bot?start=g_10s<43-char-base62-token>
https://t.me/cove_trading_bot?start=g_0d5b<27-char-base62-token><7-char-affiliate>0000000

Market buy panel links

Use b_ links when you want to open the Cove buy panel for a token and let the user choose the amount.

b_{chainCode}{base62Token}[{base62AffiliateId}{base62GroupId}]

Field	Width	Description
`b_`	2 chars	Fixed prefix
`chainCode`	1 char	Chain identifier
`base62Token`	27 or 43 chars	Base62-encoded token address
`base62AffiliateId`	7 chars	Optional affiliate Telegram user ID
`base62GroupId`	7 chars	Optional source Telegram group ID

Behavior:

Onboarded users open the market panel in buy mode.
The user selects the amount and confirms from inside Cove.
New users enter onboarding first. If an affiliate is present, Cove can attach it during onboarding, then the user starts from the main menu.

Length limits

Chain type	Worst-case length
Solana	`b_` + `s` + 43-char token + 14-char tail = 60 chars
EVM	`b_` + `b` + 27-char token + 14-char tail = 44 chars

Examples:

https://t.me/cove_trading_bot?start=b_s<43-char-base62-token><7-char-affiliate><7-char-group>
https://t.me/cove_trading_bot?start=b_b<27-char-base62-token>

Group sell links

Use gs_ links when you want a click to sell a percentage of the user’s own position in a token. The link does not transfer or sell a shared group wallet position.

gs_{percent}{chainCode}{base62Token}[{base62AffiliateId}{base62GroupId}]

Field	Width	Description
`gs_`	3 chars	Fixed prefix
`percent`	1-3 chars	Integer from `1` to `100`, representing the share of the position to sell
`chainCode`	1 char	Chain identifier
`base62Token`	27 or 43 chars	Base62-encoded token address
`base62AffiliateId`	7 chars	Optional affiliate Telegram user ID
`base62GroupId`	7 chars	Optional source Telegram group ID

Behavior:

Cove sells the selected percentage of the clicker’s own position from a real trading account.
If the user holds the token in one account, Cove can select that account automatically.
If the user holds the token in multiple accounts, Cove shows a wallet picker.
If the user does not hold the token, Cove shows that there is nothing to sell.
New users can be onboarded through the link, but no sell is executed because there is no existing position.

Group sell links are opt-in for users. The first time a user clicks one while group sells are disabled, Cove asks them to enable group sell links. After enabling, future group sell links can execute directly.

Length limit

Worst-case Solana payload:

gs_ + 100 + s + <43-char-base62-token> + <7-char-affiliate> + <7-char-group> = 64 chars

Example:

https://t.me/cove_trading_bot?start=gs_50e<27-char-base62-token>

Referral links

Use ref_ links when you want to share a token link with referral attribution. The ref value goes before the hyphen, and the token address goes after it. Full link format:

https://t.me/cove_trading_bot?start=ref_{ref}-{tokenAddress}

Payload format:

ref_{ref}-{tokenAddress}

Field	Description
`ref`	Your referral name or code, without `@`
`tokenAddress`	Raw token address or mint address

The token address format is the same for EVM and Solana links: replace it with the token address you want the user to open. Example:

https://t.me/cove_trading_bot?start=ref_alice-0xf30bf00edd0c22db54c9274b90d2a4c21fc09b07

In this example, replace alice with your own ref and replace the token address with the token you want to share.

Base62 helpers

Cove uses this alphabet:

0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz

All fixed-width Base62 strings are left-padded with 0.

const ALPHABET = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";

function bytesToBase62(bytes, width) {
  let n = 0n;

  for (const byte of bytes) {
    n = (n << 8n) | BigInt(byte);
  }

  if (n === 0n) {
    return "0".repeat(width);
  }

  let result = "";

  while (n > 0n) {
    result = ALPHABET[Number(n % 62n)] + result;
    n = n / 62n;
  }

  return result.padStart(width, "0");
}

function base62ToBytes(str, byteLength) {
  let n = 0n;

  for (const ch of str) {
    n = n * 62n + BigInt(ALPHABET.indexOf(ch));
  }

  const bytes = new Uint8Array(byteLength);

  for (let i = byteLength - 1; i >= 0; i--) {
    bytes[i] = Number(n & 0xffn);
    n = n >> 8n;
  }

  return bytes;
}

Validate payload length before publishing a link. Invalid optional-tail lengths or payloads above Telegram’s limit will not resolve into a Cove action.

Essentials

Trading Operations

Support

For Groups & Channels

For Builders

Brand Kit

Quick reference

Group buy

Group sell

Referral

Link types

Group Buy

Market Buy Panel

Group Sell

Referral

Shared encoding

Chain codes

Token address width

Optional affiliate and group IDs

Group buy links

Market buy panel links

Group sell links

Referral links

Base62 helpers

​Quick reference

Group buy

Group sell

Referral

​Link types

Group Buy

Market Buy Panel

Group Sell

Referral

​Shared encoding

​Chain codes

​Token address width

​Optional affiliate and group IDs

​Group buy links

​Market buy panel links

​Group sell links

​Referral links

​Base62 helpers

Quick reference

Link types

Shared encoding

Chain codes

Token address width

Optional affiliate and group IDs

Group buy links

Market buy panel links

Group sell links

Referral links

Base62 helpers