Alkanex Trading Bot Docs

Trade links

Turn your token into a one-tap "Trade on Alkanex" link so your community can buy it straight from Telegram.

A trade link opens your token's buy card directly inside Alkanex. Anyone who taps it lands on the card, chart and market data, with the $25 / $50 / $100 / Custom buy presets ready. No AlkaneId to paste, no app to install. It is the fastest way to send someone from your site, your post, or your chat straight to buying your token.

If you run a token, a project, or a community, this page is for you. Make the link once, put it everywhere your people are, and every tap is two taps from a position.

The format

https://t.me/AlkanexBot?start=trade_<block>_<tx>
  • trade_ opens the buy card (the same card you get by pasting the AlkaneId).
  • <block>_<tx> is your token's AlkaneId with the colon replaced by an underscore.

So a token with AlkaneId 2:0 becomes:

https://t.me/AlkanexBot?start=trade_2_0
Why the underscore? A Telegram ?start= link only allows letters, digits, _ and - (max 64 characters). A colon is not allowed, so 2:0 is written 2_0, and a token like 891:42 is written 891_42. Use the raw digits, and never URL-encode the payload.

Build yours in 10 seconds

  1. Find your token's AlkaneId, the block:tx you paste to open its card (for example 2:0).
  2. Replace the colon with an underscore: 2:0 becomes 2_0.
  3. Put it after trade_:
https://t.me/AlkanexBot?start=trade_2_0

That is your link. Tap it yourself to check it opens the right buy card.

AlkaneIdTrade link
2:0https://t.me/AlkanexBot?start=trade_2_0
891:42https://t.me/AlkanexBot?start=trade_891_42

Put it everywhere your community is

Add a Buy on Alkanex button or link wherever people find you:

  • Your website or landing page, as a button
  • Your X bio and posts
  • Your Telegram group description or a pinned message
  • Discord, link-in-bio, anywhere a link lives

Every tap drops the person on your token's buy card in Telegram. If they do not have a wallet yet, the bot walks them through it: a short terms screen, a wallet created in a couple of taps, then they buy. Two taps to a position, from a cold start.

For builders: generate them in code

You do not need any code to make a trade link. Writing the URL by hand (see above) is all most people need. This part is only for developers who generate many links automatically, for example a website or a bot that builds one link per token.

If that is you, this is the exact logic the Alkanex bot uses, as a drop-in JavaScript / TypeScript helper. It does nothing magic: it just returns the URL string (adds trade_, swaps the colon for _, and checks the parts are digits).

function buildTradeDeeplink(
  botUsername: string,               // 'AlkanexBot' (no @)
  alkane: { block: string; tx: string },
): string {
  if (!/^\d+$/.test(alkane.block)) throw new Error('invalid block');
  if (!/^\d+$/.test(alkane.tx)) throw new Error('invalid tx');
  return `https://t.me/${botUsername}?start=trade_${alkane.block}_${alkane.tx}`;
}

Keep block and tx as raw digit strings. Anything with a colon, dot, or slash in the payload is invalid and drops the user to the plain menu.

Good to know

  • Share the base trade_<block>_<tx> form. The link works for any token that has a live buy card on Alkanex. A token with no pool still opens its card, but has no buy presets yet.
  • trade_ is the one to use. token_ also opens the buy card and pos_ opens the position card, but trade_ is the canonical kind.
  • The _bb and _tc suffixes you may see are reserved for the official Alkanex BuyBot and trading channel (they carry attribution). A link with any other suffix is treated as invalid, so leave the suffix off for your own links.
Want a buy-alert bot for your group that posts every buy with a built-in Trade on Alkanex button? That is what the Alkanex BuyBot does. Reach out on the channel.

On this page