Create Grid

Before Creating a Grid

1. Ensure the following prerequisites are completed:

• Create a project: Follow the steps to create a new project.

• Add an account: Link your exchange account to the platform.

• Create a bot: Set up a bot with the necessary parameters.

2. Proceed to create a grid:

Once the above steps are completed, click the plus button ("+") to begin configuring the grid.

Creating a Grid: Initial Setup

1. Click the "+" button

After clicking the plus button ("+"), a basic grid configuration will automatically appear, pre-filled with default values.

2. Default settings

• A single buy order will be placed at the last trade price for the current pair and exchange, as determined by the bot's configuration ( ticker()).

• The order size is set to 100 tokens of the base currency (Base).

These pre-filled values provide a quick start, allowing you to adjust further settings as needed.

Mandatory Fields:

1. execute_price:

• Type: Number

• Description: The price levels at which orders will be placed.

• Formula: Prices are calculated based on the parameter order_pos, which determines the relative position of the orders.

  • For Buy Orders: The order_pos parameter takes values in the range [-1,...,-buy_orders_count].

  • For Sell Orders: The order_pos parameter takes values in the range[1,...,sell_order_count].

This parameter ensures the grid accurately places multiple orders at varying price levels, both above and below the market price.

Example:

ticker()

orderbook().bid[0].price

orderbook().ask[0].price* (1 + order_pos * 0.005)

1000.05

1000.05 * (1 + order_pos* 0.005)

1000 if side=='buy' else 1500

2. execute_volume:

• Type: Number

• Description: The trading volume for each order, expressed in the Base token.

• Formula: The volume is calculated based on the order_pos parameter:

  • For Buy Orders: order_pos takes values from [-1,...,-buy_orders_count].

  • For Sell Orders: order_pos takes values from [1,...,sell_order_count].

This parameter determines the amount of the base currency to be traded at each price level, ensuring consistent volume allocation across the grid.

Example:

orderbook().ask[0].amount

orderbook().bid[0].amount* (1 + order_pos * 0.005)

5250.75

5250.75 /execute_price

5250.75 / ticker()

1000.05 + order_pos * 0.005

1000 if side=='buy' else 1500

3. buy_order_count:

• Type: Number

• Description: The number of buy orders (bid) to be placed for the Base token.

• Formula: Defines the total count of buy orders, with prices determined using the order_pos parameter in the range [-1,...,-buy_orders_count].

4. sell_order_count:

• Type: Number

• Description: The number of sell orders (ask) to be placed for the Base token.

• Formula: Defines the total count of sell orders, with prices determined using the order_pos parameter in the range [1,...,sell_order_count].

These parameters ensure that the grid creates the specified number of buy and sell orders at their respective price levels.

Example:

5

5 if ticker() > 0.05 else 0

5 if balance('counter').total < 5000 else 0

5 if group_balance('base').current.total > 10000 else 0

Optional Fields

1. time_between_orders:

• Type: Number

• Description: The time interval (in seconds) between placing successive orders in a single grid.

• Purpose: Reduces the frequency of API requests to the exchange, helping avoid exceeding the exchange's rate limits.

2. sleep_after_seconds:

• Type: Number

• Description: The time interval (in seconds) between grid updates.

• Purpose: Controls how often the grid is refreshed, balancing performance and API usage efficiency.

These fields are not mandatory but can optimize grid operations by managing API request frequency and reducing the likelihood of exceeding exchange limits.

Example:

300

300 * (1 + random())

300 + 150 * random()

Post-Only

• Description: When this option is enabled, users act as market makers.

• Functionality:

  • If the Post-Only option is selected, any limit order you place will never immediately match with an existing order in the order book.

  • Instead, it ensures that your order always enters the order book as a maker order, providing liquidity rather than taking it.

This option is useful for users looking to avoid taker fees or ensure their orders contribute to market liquidity.

Working with the Grid

1. Activating the Grid

• To activate the grid, toggle the Toggle Switch to the enabled state.

This action will initiate the grid and start executing the configured trading strategy.

Adding Additional Parameters

• To create and configure additional parameters for your grid, click the + Add Row button.

This allows you to define custom settings or expand the functionality of your grid configuration as needed.

Configuring Additional Parameters

1. Enter Variable Name and Value

• In the newly added row, input the variable name and its corresponding value.

• You can create auxiliary parameters to be used in formulas for more advanced configurations.

2. Save Changes

• After making any adjustments to the grid, ensure you save the changes to apply the new settings.

This approach enables dynamic and flexible grid customization tailored to specific trading strategies.

Previewing Calculated Orders

• To view the pre-calculated orders based on the logic defined in the grid, click the Research button.

This feature allows you to verify and analyze the orders before activation, ensuring the grid is configured correctly and aligns with your trading strategy.

Custom parameter with floating point (decimal) value

It is possible to create custom parameters with decimal or integer value

Example:

Create custom parameter spread and use it in execute_price

Custom formula

Also, it is possible to create custom formula as parameter’s value and use parameter’s key as alias for it.

1. Define new parameter with some name (ex: spread)

2. Define parameter value with some formula (ex: random() * 2)

An example of using additional parameters to set a grid with a spread of 1% and a step of 2% for subsequent orders.

{
"execute_price": "ticker() * (1 - spread / 2 + order_pos * gap if side=='buy' else 1 + spread / 2 + order_pos * gap)",
"execute_volume": "50 / execute_price",
"buy_orders_count": "3",
"sell_orders_count": "3",
"spread": "0.01",
"gap": "0.02"
}

Editing in JSON Format

1. Switch to JSON Mode

• Click the Turn into JSON button to enable editing the grid in JSON format.

2. Use Cases:

• Quickly insert a previously saved or pre-written grid configuration.

• Copy the current grid settings for reuse or backup.

• Make detailed edits directly in the JSON structure for faster and precise adjustments.

3. Save Changes

• After editing, ensure you save the configuration to apply the updates.

This feature is ideal for users who prefer direct JSON manipulation or need to efficiently manage complex grid setups.

Verifying Variables Before Saving

1. Preview Variables

   • Before saving your changes in JSON format, click the Show Form button.

2. Purpose:

   • This step ensures that all variables and parameters are correctly recorded and properly mapped to the grid's logic.

3. Save Changes

   • Once verified, proceed to save the configuration to finalize the grid setup.

This process helps avoid errors and ensures the grid operates as intended.

---