"""
AlphaPulse Bot — Card Templates & Visual Helpers
All post formatting lives here. Every post goes through build_card()
for consistent branding.
"""
import random
from config import BASE_HASHTAGS, AFFILIATE_LINKS, PREMIUM_TEASERS
# ─── Visual constants ─────────────────────────────────────────────────────────
HEADER_LINE = "━━━━━━━━━━━━━━━━━━━━"
FOOTER_LINE = "┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈"
BRAND = "⚡ <b>AlphaPulse</b> · @alphapulsexp"
# Post counter for rotation logic
_post_seq = {'count': 0}
# Spark bar characters (index 0 = lowest, 7 = highest)
SPARK_CHARS = "▁▂▃▄▅▆▇█"
def spark_bar(values: list[float]) -> str:
"""Convert a list of floats into a Unicode sparkline bar.
E.g. [1, 3, 5, 2, 4] -> '▂▄█▃▅'
"""
if not values or len(values) < 2:
return ""
mn, mx = min(values), max(values)
spread = mx - mn
if spread == 0:
return SPARK_CHARS[4] * len(values)
return "".join(
SPARK_CHARS[min(int((v - mn) / spread * 7), 7)]
for v in values
)
def progress_bar(value: int, max_val: int = 100, width: int = 10) -> str:
"""Render a progress bar: [████████░░] 78/100
"""
filled = round(value / max_val * width)
filled = max(0, min(width, filled))
empty = width - filled
return f"[{'█' * filled}{'░' * empty}] {value}/{max_val}"
def format_price_line(emoji: str, symbol: str, price: float,
change_24h: float, sparkline: str = '') -> str:
"""Format a single price line with arrow and optional sparkline.
E.g.: ₿ BTC $87,432 ▲ +2.1% ▁▂▃▅▇
"""
arrow = '🟢' if change_24h > 0 else '🔴' if change_24h < 0 else '⚪'
# Format price: no decimals for BTC, 0 decimals for ETH, 2 for SOL
if price >= 1000:
price_str = f"${price:,.0f}"
elif price >= 10:
price_str = f"${price:,.1f}"
else:
price_str = f"${price:,.2f}"
line = f"{emoji} {symbol} <b>{price_str}</b> {arrow} {change_24h:+.1f}%"
if sparkline:
line += f" {sparkline}"
return line
def pick_affiliate() -> dict:
"""Weighted random affiliate link selection."""
weights = [a['weight'] for a in AFFILIATE_LINKS]
return random.choices(AFFILIATE_LINKS, weights=weights, k=1)[0]
def pick_premium_teaser() -> str:
"""Random premium teaser line."""
return random.choice(PREMIUM_TEASERS)
def build_card(header_emoji: str, title: str, body_lines: list[str],
hashtags: str = '', show_brand: bool = True,
show_affiliate: bool = False,
show_premium: bool = False) -> str:
"""Universal card wrapper.
━━━━━━━━━━━━━━━━━━━━
🧠 MARKET ANALYSIS
━━━━━━━━━━━━━━━━━━━━
body lines here...
#hashtags
💼 Trade on Binance (optional affiliate)
🔒 Premium teaser (optional)
┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈┈
⚡ AlphaPulse · @alphapulsexp
"""
_post_seq['count'] += 1
parts = [
HEADER_LINE,
f"{header_emoji} <b>{title}</b>",
HEADER_LINE,
"",
]
parts.extend(body_lines)
if hashtags:
parts += ["", hashtags]
# Affiliate link (weighted rotation)
if show_affiliate:
aff = pick_affiliate()
parts += ["", f"<a href='{aff['url']}'>{aff['cta']}</a>"]
# Premium teaser
if show_premium:
parts += ["", f"<i>{pick_premium_teaser()}</i>"]
if show_brand:
parts += ["", FOOTER_LINE, BRAND]
return "\n".join(parts)
# ─── Specific card builders ───────────────────────────────────────────────────
def card_news(emoji: str, commentary: str, source: str, url: str,
hashtags: str, add_affiliate: bool = False) -> str:
"""News post card with AI commentary."""
body = [commentary]
body.append("")
body.append(f"📰 <i>{source}</i>")
if url:
body.append(f"🔗 <a href='{url}'>Read full article</a>")
return build_card(emoji, "CRYPTO NEWS", body, hashtags,
show_affiliate=add_affiliate)
def card_price_snapshot(prices: dict, fg: dict = None,
dominance: dict = None,
sparklines: dict = None) -> str:
"""Daily price snapshot card."""
sp = sparklines or {}
body = [
format_price_line("₿", "BTC", prices['btc_price'],
prices['btc_change'], sp.get('btc', '')),
format_price_line("⟠", "ETH", prices['eth_price'],
prices['eth_change'], sp.get('eth', '')),
format_price_line("◎", "SOL", prices['sol_price'],
prices.get('sol_change', 0), sp.get('sol', '')),
]
if dominance:
mcap_arrow = '▲' if dominance.get('mcap_change', 0) > 0 else '▼'
body += [
"",
f"🔵 BTC.D: <b>{dominance['btc_dominance']}%</b> │ "
f"ETH.D: {dominance['eth_dominance']}%",
f"📦 MCap: <b>${dominance['total_mcap'] / 1e12:.2f}T</b> "
f"{mcap_arrow} {dominance['mcap_change']:+.1f}%",
]
if fg:
bar = progress_bar(fg['value'])
body += [
"",
f"😱 Fear & Greed: <b>{fg['value']}</b> — {fg['classification']}",
f"<code>{bar}</code>",
]
# Show premium teaser on ~20% of price snapshots
show_prem = random.random() < 0.2
return build_card("💹", "PRICE SNAPSHOT", body, BASE_HASHTAGS,
show_premium=show_prem)
def card_trending(coins: list, date_str: str) -> str:
"""Trending coins card."""
medals = ['🥇', '🥈', '🥉', '4️⃣', '5️⃣', '6️⃣', '7️⃣']
body = [f"<i>{date_str} · CoinGecko</i>", ""]
for i, c in enumerate(coins[:7]):
rank = f"<i>#{c['rank']}</i>" if c['rank'] != '?' else ''
body.append(f"{medals[i]} <b>{c['symbol']}</b> {c['name']} {rank}")
return build_card("🔥", "TRENDING NOW", body, "#crypto #trending #altcoins")
def card_top_movers(gainers: list, losers: list) -> str:
"""Top movers card (gainers + losers)."""
body = []
if gainers:
body.append("🟢 <b>Top Gainers</b>")
for c in gainers[:3]:
sym = c['symbol'].upper()
pct = c['price_change_percentage_24h'] or 0
price = c['current_price']
if price >= 1000:
p = f"${price:,.0f}"
elif price >= 1:
p = f"${price:,.2f}"
else:
p = f"${price:,.4f}"
body.append(f" ▲ {sym} <b>{p}</b> <b>+{pct:.1f}%</b>")
if gainers and losers:
body.append("")
if losers:
body.append("🔴 <b>Top Losers</b>")
for c in losers[:3]:
sym = c['symbol'].upper()
pct = c['price_change_percentage_24h'] or 0
price = c['current_price']
if price >= 1000:
p = f"${price:,.0f}"
elif price >= 1:
p = f"${price:,.2f}"
else:
p = f"${price:,.4f}"
body.append(f" ▼ {sym} <b>{p}</b> <b>{pct:.1f}%</b>")
return build_card("🏆", "24H TOP MOVERS", body, BASE_HASHTAGS)
def card_weekly_digest(prices: dict, fg: dict = None,
gainers: list = None,
week_range: str = '') -> str:
"""Sunday weekly digest card."""
btc_arrow = '▲' if (prices.get('btc_7d') or 0) > 0 else '▼'
eth_arrow = '▲' if (prices.get('eth_7d') or 0) > 0 else '▼'
sol_arrow = '▲' if (prices.get('sol_7d') or 0) > 0 else '▼'
body = [
f"<i>{week_range}</i>",
"",
"📈 <b>7-Day Performance</b>",
f"₿ BTC <b>${prices['btc_price']:,.0f}</b> {btc_arrow} {prices.get('btc_7d', 0):+.1f}%",
f"⟠ ETH <b>${prices['eth_price']:,.0f}</b> {eth_arrow} {prices.get('eth_7d', 0):+.1f}%",
f"◎ SOL <b>${prices['sol_price']:,.2f}</b> {sol_arrow} {prices.get('sol_7d', 0):+.1f}%",
]
if fg:
bar = progress_bar(fg['value'])
body += [
"",
f"😱 Sentiment: <b>{fg['classification']}</b> ({fg['value']})",
f"<code>{bar}</code>",
]
if gainers and len(gainers) >= 3:
body += ["", "🏆 <b>Week's Top Gainers (24h)</b>"]
for c in gainers[:3]:
pct = c['price_change_percentage_24h'] or 0
body.append(f" ▲ {c['symbol'].upper()} <b>+{pct:.1f}%</b>")
body += [
"",
"💬 How was your week? Drop it below 👇",
]
return build_card("📅", "WEEKLY DIGEST", body, BASE_HASHTAGS)
def card_fear_greed(value: int, classification: str, comment: str) -> str:
"""Standalone Fear & Greed card."""
bar = progress_bar(value)
# Emoji based on level
if value <= 25:
level_emoji = "😱"
elif value <= 45:
level_emoji = "😰"
elif value <= 55:
level_emoji = "😐"
elif value <= 75:
level_emoji = "🤑"
else:
level_emoji = "🚀"
body = [
f"{level_emoji} <b>{classification}</b>",
"",
f"<code>{bar}</code>",
"",
comment,
]
return build_card("🎚️", "FEAR & GREED INDEX", body, BASE_HASHTAGS)
def card_funding_rates(rates: list) -> str:
"""Funding rates card — shows market long/short bias."""
body = [
"<i>Binance Futures · 8h Rate</i>",
"",
]
# Split into positive (longs pay) and negative (shorts pay)
longs_pay = [r for r in rates if r['rate'] > 0][:5]
shorts_pay = [r for r in rates if r['rate'] < 0][:5]
if longs_pay:
body.append("🟢 <b>Longs Pay (bullish crowd)</b>")
for r in longs_pay:
body.append(f" {r['symbol']} <b>{r['rate_pct']:+.4f}%</b>")
if longs_pay and shorts_pay:
body.append("")
if shorts_pay:
body.append("🔴 <b>Shorts Pay (bearish crowd)</b>")
for r in shorts_pay:
body.append(f" {r['symbol']} <b>{r['rate_pct']:+.4f}%</b>")
# Summary line
total_positive = len([r for r in rates if r['rate'] > 0])
total_negative = len([r for r in rates if r['rate'] < 0])
if total_positive + total_negative > 0:
bias = "Longs dominant 🐂" if total_positive > total_negative else "Shorts dominant 🐻"
body += ["", f"📊 Market bias: <b>{bias}</b>"]
return build_card("📊", "FUNDING RATES", body,
"#crypto #futures #trading #BTC #funding",
show_affiliate=True)
def card_watchlist(coins: list, ai_commentary: str,
date_str: str) -> str:
"""Monday watchlist card — coins to watch this week."""
body = [
f"<i>Week of {date_str}</i>",
"",
]
for i, coin in enumerate(coins[:5], 1):
emoji = ['1️⃣', '2️⃣', '3️⃣', '4️⃣', '5️⃣'][i - 1]
sym = coin.get('symbol', '').upper()
reason = coin.get('reason', '')
body.append(f"{emoji} <b>{sym}</b> — {reason}")
if ai_commentary:
body += ["", f"💡 <i>{ai_commentary}</i>"]
return build_card("🎯", "WEEKLY WATCHLIST", body,
"#crypto #watchlist #trading #altcoins")
def card_history(events: list, date_str: str, ai_reflection: str = '') -> str:
"""'This Day in Crypto' historical card."""
body = [
f"<i>{date_str}</i>",
"",
]
for e in events:
year = e['year']
icon = e.get('icon', '📅')
text = e['event']
nearby = e.get('_nearby', False)
prefix = "~" if nearby else ""
body.append(f"{icon} <b>{prefix}{year}</b> — {text}")
if ai_reflection:
body += ["", f"💭 <i>{ai_reflection}</i>"]
body += ["", "♻️ History doesn't repeat, but it rhymes"]
return build_card("🕰️", "THIS DAY IN CRYPTO", body,
"#crypto #history #bitcoin #OnThisDay")
def card_long_short(positions: list) -> str:
"""Market positioning card — Long/Short ratios for top coins."""
# Count overall bias
bulls = sum(1 for p in positions if p['ratio'] > 1.2)
bears = sum(1 for p in positions if p['ratio'] < 0.8)
if bulls > bears + 2:
verdict = "🐂 Market heavily long — watch for squeeze"
elif bears > bulls + 2:
verdict = "🐻 Market heavily short — squeeze risk high"
else:
verdict = "⚖️ Mixed positioning"
body = [
"<i>Binance Futures · Account Ratios</i>",
"",
]
for p in positions:
long_pct = p['long_pct'] * 100
short_pct = p['short_pct'] * 100
# Visual bar: 10 chars total
long_blocks = round(long_pct / 10)
long_blocks = max(0, min(10, long_blocks))
short_blocks = 10 - long_blocks
bar = f"🟢{'█' * long_blocks}{'░' * short_blocks}🔴"
sym = f"{p['symbol']:>5}"
body.append(f"<code>{sym}</code> {bar} L:{long_pct:.0f}% S:{short_pct:.0f}%")
body += ["", f"📊 <i>{verdict}</i>"]
return build_card("📐", "MARKET POSITIONING", body,
"#crypto #futures #longshort #trading",
show_affiliate=True, show_premium=True)
def card_whale_alerts(alerts: list) -> str:
"""Whale alert card — large BTC transactions."""
body = [
"<i>Blockchair · Largest BTC Transactions (24h)</i>",
"",
]
for a in alerts:
btc = a['amount_btc']
usd_approx = "" # would need BTC price
body.append(f"🐋 <b>{btc:,.1f} BTC</b> tx: <code>{a['hash']}</code>")
body += [
"",
"🔍 <i>Large moves often precede volatility</i>",
]
return build_card("🐳", "WHALE WATCH", body,
"#crypto #bitcoin #whales #onchain")
📜 Git History
a09f02fchore: initial commit — version control setup5 weeks ago
Show last diff
Loading...