Skip to content
Skip to content

Your First Bot

This guide walks you through creating your first Balchemy trading bot using Studio. By the end, you will have a working bot that can respond to messages, execute trades on Solana or Base, and receive commands from Telegram.

Prerequisites

Before you start, make sure you have:

  1. Signed in to Balchemy at app.balchemy.ai — use your Solana or EVM wallet to authenticate
  2. Your wallet connected (the wallet used to sign in is automatically your primary wallet)
  3. A linked Telegram account — the wizard will prompt you if it is missing, and you will need it to interact with your bot

Tip: You can link your Telegram account from Studio settings at any time. However, linking it before you create your first bot means the wizard will not interrupt you mid-flow.

Two creation paths

Balchemy gives you two ways to create a bot:

PathBest forTime
Create with AIFirst-time users, fast setup, natural language description~2 minutes
Set up manuallyExperienced users, precise configuration, corporate bots5–10 minutes

Both paths produce the same type of bot. The AI wizard uses a conversational interface to extract your preferences and generate the configuration. The manual wizard exposes every field directly as a step-by-step form. You can switch between them at any time before creation — there is a "Switch to manual setup" link at the bottom of the AI wizard, and both options are always visible on the creation landing page.

Tip: Start with the AI wizard. You can always refine any setting from the Config tab after the bot is created. There is no irreversible decision in the wizard.

Path 1 — Create with AI (recommended)

The AI wizard is a conversational interface. You describe what you want your bot to do, and the AI asks clarifying questions, builds the configuration, and shows you a review card before creating anything.

Steps

  1. Go to Studio → Create New Bot. The button is in the top-right corner of the Studio dashboard.

  2. On the creation page, click "Create with AI." You will see a text area where you can type your prompt before clicking. This is optional — you can also just click through and type in the chat.

  3. Describe your bot. Type a plain-language description of what you want. Examples:

    • "A Solana meme coin sniper that monitors PumpFun for new launches, auto-buys trending tokens with 0.1 SOL, sets take-profit at 2x and stop-loss at -30%"
    • "A DCA bot that buys 0.5 SOL worth of tokens every day"
    • "A portfolio monitoring bot that tracks my positions and sends PnL alerts on Telegram"
    • "A general-purpose trading assistant I can talk to about what to buy and sell"
    • You can also select a pre-built template from the Quick Start Templates section on the creation page

  4. Answer the AI's follow-up questions. The wizard works through key configuration areas. It will ask about:

    • Bot name and type (individual vs. corporate)
    • AI model (GPT-5 Mini or GPT-5 Nano)
    • Trading preferences and strategy
    • Platforms you want to connect (Telegram, Discord)
    • Response style (detailed, concise, or technical)
    • For each question, the AI may offer option chips — click one to answer quickly, or type your own response

  5. Review the configuration card. When the AI has gathered enough information, it shows a review card with all collected settings: Name, Type, AI Model, Expertise, Personality, Trading, Response Mode, and Platforms. Each field has an Edit button. Click any Edit button to ask the AI to change that specific field.

  6. Click "Launch Bot." The bot is created and you are redirected to the bot cockpit at /studio/bots/[botId].

Note: The AI wizard saves your progress to session storage as you go. If you accidentally close the browser, your draft will be restored when you return to the same page.

Warning: The wizard sets defaults for fields you do not explicitly configure (for example, temperature defaults to 0.7 and max tokens default to 4096). Review the configuration card carefully before launching if you have specific requirements.

Path 2 — Set up manually

The manual wizard is a step-by-step form with a visual progress bar. Each step focuses on one area of configuration. Your draft is saved to session storage after every change.

Individual bot (6 steps)

  1. Bot Identity — Bot name (required, max 60 chars), description (optional), expertise area, and bot type (Individual or Corporate)
  2. AI Personality — LLM model (GPT-5 Mini or GPT-5 Nano), temperature (0–2 slider), max tokens (2048–16384), response mode (Detailed / Concise / Technical), and personality prompt
  3. Trading — Enable or disable trading, choose a strategy type (DCA, Limit Order, Scalping, Swing, or Manual)
  4. Risk — Maximum drawdown %, position size %, stop-loss threshold, take-profit threshold, trailing stop toggle
  5. Platforms — Connect Telegram (with access mode: Private, Public, or Whitelist) and/or Discord (with guild ID)
  6. Review — Summary of all steps with Edit links back to any section; click "Create Bot" to launch

Note: Step 4 (Risk) is automatically skipped if you disabled trading in Step 3.

Corporate bot (8 steps)

Corporate bots have two extra steps:

  • Widget (after Risk) — Enable an embeddable chat widget for your website. Configure allowed domains, brand name, brand logo URL, welcome message, widget position (bottom-right/left, top-right/left), wallet connect toggle, and up to 8 quick-prompt buttons.
  • Knowledge Base (after Platforms) — Paste training text (up to 20,000 words) directly into the wizard. Document uploads (PDF, TXT, MD) are available from the bot's Knowledge tab after creation.

Corporate bots also have extended Telegram configuration (owner username and per-channel policies) and extended Discord configuration (log channel, allowed channels, required roles, fee share in basis points).

Tip: If you are not sure whether you need a corporate bot, start with Individual. You can always create a corporate bot later. The main practical differences are the embeddable widget and the extended Telegram/Discord channel policy controls.

What happens after creation

After you create your bot — by either path — you land on the bot cockpit at /studio/bots/[botId]. This is the central hub for everything related to this specific bot.

The cockpit overview tab

The Overview tab is the default view. It shows:

  • Four KPI cards: Total Trades, Win Rate, Avg PnL, and Uptime (Active/Inactive)
  • Current Positions table: Token, chain, amount, entry price, current price, and PnL for each open position
  • Open Orders panel: All pending orders with type, status, and age
  • Bot Info panel: Name, status, description, and connected platforms — with a link to full trade history

All cockpit tabs

Navigate between tabs using the tab bar at the top of the cockpit. The full set of tabs is:

TabWhat you configure or view
OverviewKPIs, open positions, open orders, bot info summary
StrategyActive strategy type, strategy parameters, DCA schedule
RiskMax drawdown, position sizing, stop-loss, take-profit, trailing stop
AutomationTrigger conditions, scheduled actions, rule-based automation
HistoryFull trade and activity log
KnowledgeKnowledge base entries, uploaded documents, Q&A pairs
PlatformsTelegram and Discord connection status and settings
ConfigCore bot settings — name, description, AI model, temperature, personality prompt, response mode
AnalyticsPerformance charts, PnL over time, win rate trends
MCPMCP connection details and API key for connecting this bot to external AI systems
TrainingTraining data management and model fine-tuning options
WidgetWidget embed code, allowed domains, branding, quick prompts (corporate bots)

First actions after creation

Here are the three most impactful things to do immediately after your bot is created:

1. Test via chat

Go to Studio → Chat or click the chat link from the bot cockpit. Send your bot a message to confirm it is responsive. Try:

  • "What tokens are trending on Solana right now?"
  • "What is my current portfolio balance?"
  • "Buy 0.01 SOL worth of [token]" (only if you are ready to execute a real trade)

You can also use the AI Copilot panel from the Studio dashboard. Click the "Copilot" button in the top-right, select your bot from the dropdown, and start a conversation. The copilot is connected directly to your bot's AI model and context.

2. Connect Telegram

Go to the Platforms tab in the bot cockpit. If Telegram is not yet connected, follow the prompt to link it. Once linked:

  1. Open Telegram and find your bot (it uses Balchemy's central adapter infrastructure — you do not create a separate bot token)
  2. Send /start to begin the conversation
  3. Test a command like "show me my positions" or "what is the price of SOL?"

See the Telegram Integration guide for detailed setup including access mode, whitelist management, and channel policies.

3. Add knowledge

Go to the Knowledge tab. Add context your bot should know about:

  • Your preferred trading strategies and rules
  • Tokens you focus on
  • Risk tolerance and personal guidelines
  • Any custom terminology or abbreviations you use

This knowledge is injected into the bot's context window on every request, making answers far more relevant and personalized.

Tip: Even a short paragraph of context makes a significant difference. Try adding: "I trade Solana meme coins with a 0.1 SOL max position size. I prefer to take profit at 2x and always use a -30% stop-loss."

Expected outcome

After completing the steps above, you should have:

  • A named bot visible in your Studio dashboard under Active Bots
  • A bot that responds to natural language messages in the Studio chat interface
  • A bot connected to your Telegram account (if you completed step 2 above)
  • A bot that knows your preferred context (if you added knowledge)
  • A bot with trading enabled and ready to execute on Solana and/or Base when you give it instructions

Your Studio dashboard will update to show the bot in the Active Bots count. Once your bot executes its first trade, the PnL chart and Recent Activity feed will populate.

Tips

Tip: Do not enable aggressive trading settings immediately. Start with trading disabled or with manual strategy mode — where the bot suggests trades and asks for confirmation — before enabling fully automated execution.

Tip: The Config tab is your post-creation control panel. Everything from the wizard is editable there: name, description, personality prompt, AI model, temperature, response mode, expertise area. You never have to delete and recreate a bot to change these settings.

Tip: Use the Risk tab to set a maximum drawdown percentage before enabling automated strategies. A maximum drawdown of 10% means the bot will pause automated trading if the portfolio drops more than 10% from its high watermark.

Warning: The bot executes trades through Balchemy's custodial wallet. Fund this wallet from the Wallets section of Studio before expecting trading to work. A bot with no funded custodial wallet cannot execute any on-chain trades.

Warning: Test on small amounts first. Even a well-configured bot can encounter unexpected market conditions. Start with the minimum position size you are comfortable losing, verify the behavior over several trades, then scale up.

Previous

Introduction

Next

Explorer

Edit this page on GitHub
Connection lost. Retrying...