Quick Start

Quick Start

This guide will walk you through creating your first trading flow in GrailHub.

Step 1: Create a New Flow

1. Log in to GrailHub at http://localhost:3000
2. Click the “New Flow” button
3. Give your flow a name, e.g., “My First Trading Bot”
4. Click “Create”

Step 2: Add Components

Let’s build a simple flow that monitors Bitcoin price and sends a notification when it crosses a threshold.

Add a Ticker Component

1. Open the Components panel on the left
2. Search for “Ticker”
3. Drag the Binance Ticker component onto the canvas
4. Configure it:
   • Symbol: BTCUSDT
   • Interval: 1s

Add a Condition Component

1. Search for “Condition”
2. Drag the Condition component onto the canvas
3. Configure it:
   • Operator: greater_than
   • Threshold: 50000

Add a Notification Component

1. Search for “Notification”
2. Drag the Telegram Notification component onto the canvas
3. Configure it:
   • Bot Token: Your Telegram bot token
   • Chat ID: Your Telegram chat ID
   • Message: Bitcoin price is above $50,000!

Step 3: Connect Components

1. Click on the output handle of the Ticker component (the small circle on the right)
2. Drag to the input handle of the Condition component
3. Click on the true output of the Condition component
4. Drag to the input handle of the Notification component

Your flow should look like this:

[Binance Ticker] → [Condition] → [Telegram Notification]
                        ↓
                    (if false, do nothing)

Step 4: Save and Run

1. Click the “Save” button in the top right
2. Click the “Run” button to start your flow
3. The flow will now monitor Bitcoin price and send you a notification when it goes above $50,000

Step 5: Monitor Execution

1. Click on the “Logs” tab to see execution logs
2. You’ll see each component’s output and any errors
3. Click on individual nodes to see their state and data

Understanding the Flow

Let’s break down what’s happening:

1. Binance Ticker fetches the current Bitcoin price every second
2. Condition checks if the price is greater than $50,000
3. If true, Telegram Notification sends you a message
4. If false, nothing happens and the flow continues

Next Steps

Now that you’ve created your first flow, explore more:

• Learn about Flows
• Explore Components
• Build Complex Strategies
• Schedule Your Flows

Tips

• Use the Debug Mode: Click the bug icon to see data flowing through your flow in real-time
• Save Often: GrailHub auto-saves, but it’s good practice to save manually after major changes
• Test with Small Amounts: When building trading strategies, always test with small amounts first
• Use Conditions: Add conditions to prevent unwanted trades or notifications