Message layout

Every buy post — the default layout and any custom body — is built from {PLACEHOLDER} tokens inside header, body and row runs. Twenty tokens resolve to text; eleven of them can also serve as a run's own link target.

Text placeholders

Note

Quantity fields — {AMOUNT}, {TOKENS}, {HOLDS} — share one formatter (_fmt_qty): comma-grouped with 0 decimals at 1,000 or over; 2 decimals with trailing zeros stripped from 1 up to 1,000; 4 decimals with trailing zeros stripped below 1.

Note

{TOKEN}, {token}, {NATIVE} and {EMOJIS} are the four identity placeholders (IDENTITY_PH). The code's own comment on that set: "always filled; never decide a line drop."

Case matters: {token} vs {TOKEN}

Note

Placeholder case is meaningful. {TOKEN} (uppercase) renders the token's symbol. {token} (lowercase) renders the token's name — the long name. token/TOKEN is the only placeholder that exists in both cases; every other placeholder is uppercase-only.

Case rule, rendered

URL-slot tokens

11 of the 20 placeholders can also fill a run's own link target directly.

Note

An unset site-link slot renders as plain text, never a dead link — the run keeps its label, it just isn't wrapped in a link.

The default layout (no custom body)

With no custom body set, the bot renders a fixed structure instead of running the line-drop rule at all: a header, the emoji row, a blank line, six body rows in a fixed order, then a blank line and a tail of links.

1. Header — the owner's headerParts if set, else <Name> Buy!, the name linked to the chart when one resolves.
2. The emoji row ({EMOJIS}).
3. A blank line.
4. Six rows, in this fixed order (ROW_KEYS): spent, tokens, price, marketCap, wallet, position. position is skipped only when its value is empty (the pre-buy balance couldn't be read); any other row that renders empty is skipped the same way.
5. A blank line, then a tail of links on one line, joined with |: Tx, Chart, the owner's extraLinks (max 4), then whichever site-link slots are set.

Default row templates, each with its default icon

Default tokens row, rendered

Bold markup omitted above; on Telegram “1,000 NOT” renders bold.

The line-drop rule

Applies only once the buy bot has a custom body set. The default layout above is never subject to it.

1. The body is split into lines on the newlines inside its text runs (_split_lines) — that is the unit the rule works on.
2. For each line, its placeholders are collected, excluding the four identity placeholders.
3. A line is dropped when it has at least one non-identity placeholder, every one of them renders empty, and the rendered line contains no <a anchor.
4. A blank line directly after a dropped line is swallowed too, so a drop never leaves a double gap.

Line-drop rule, rendered

{HOLDERS} has no value on this market, so the whole first line — including its literal Holders: text — is dropped. {TOKEN} is an identity placeholder, so the second line is never a drop candidate.

Note

Only 10 of the 20 placeholders can ever render empty in practice: {POSITION}, {TX}, {CHART}, {CA}, {DEX}, {HOLDS}, {LIQ}, {VOL24}, {BUYS24}, {HOLDERS}. The other six non-identity placeholders — {AMOUNT}, {USD}, {TOKENS}, {PRICE}, {MCAP}, {WALLET} — are built from formatters that always return text, so a line built only from one of those six is never dropped.

Size-emoji scaling

Size row (buybot_helper.py)

n = max(1, min(maxEmojis, ceil(usd / usdPerEmoji)))

n is how many times the size emoji (sizeEmoji, falling back to 🟢) repeats inside {EMOJIS}. usdPerEmoji == 0 forces n = 1.

The dashboard's "Emojis per $10" field writes usdPerEmoji = 10 ÷ n for whatever number the owner enters there.

Caption fitting

Note

A 50-emoji size row costs 100 units to Telegram, not the length of the raw tg-emoji markup.

Lines that don't fit are dropped whole from the end, never cut inside a tag. If even the first line doesn't fit on its own, it is truncated character by character instead, surrogate-pair aware.

• Buy bot setup — the dashboard's layout editor
• Forking a layout and paste-to-import