Skip to main content
Grid Bots provide a configurable automated trading strategy that places a series of buy and sell orders across a predefined price range, enabling continuous “buy-low / sell-high” execution within volatile or sideways markets. This bot algorithm automatically executes trades according to grid parameters rather than price direction, aiming to capture market oscillations and generate incremental profit through repeated cycles. Grid Bots are fully programmable via API, allowing developers to create, configure, activate, monitor, and manage grid-based trading automation across supported exchanges and connectors.

​
Key Concepts

​
API Capabilities

Grid Bots expose four primary API capability groups:
  1. Lifecycle Management APIs
  2. Strategy configuration APIs
  3. Execution & Order Handling APIs
  4. Monitoring, Insight & Analytics APIs

​
Entity Model

{
  "id": 1,
  "account_id": 1,
  "account_name": "My Binance",
  "is_enabled": true,
  "grids_quantity": "81",
  "created_at": "2025-10-03T19:53:35.530Z",
  "updated_at": "2025-10-04T13:57:55.547Z",
  "strategy_type": "manual",
  "upper_stop_loss_enabled": false,
  "lower_stop_loss_enabled": false,
  "note": null,
  "editable": true,
  "lower_price": "0.016352",
  "lower_stop_loss_price": null,
  "lower_stop_loss_action": "stop_bot",
  "upper_price": "0.022503",
  "upper_stop_loss_price": null,
  "upper_stop_loss_action": "stop_bot",
  "quantity_per_grid": "20.0",
  "leverage_type": "cross",
  "leverage_custom_value": "10.0",
  "name": "VETUSDT/BNFCR",
  "pair": "BNFCR_VETUSDT",
  "start_price": "0.022395",
  "grid_price_step": "1.00399920581210916146041542739112586575949572812639182",
  "current_profit": "1.9739482002440976",
  "current_profit_usd": "1.9739482002440976",
  "total_profits_count": "17",
  "bought_volume": "0.0",
  "sold_volume": "0.0",
  "profit_percentage": "0.1234688657622554423137524222839342",
  "current_price": "0.022394",
  "max_active_buy_lines": "81",
  "max_active_sell_lines": "81",
  "order_currency_type": "quote",
  "profit_currency_type": "quote",
  "trailing_up_enabled": "true",
  "grid_type": "geometric",
  "investment_base_currency": "0.0",
  "investment_quote_currency": "0.0",
  "unrealized_profit_loss": "0.0",
  "current_profit_loss": null,
  "current_profit_loss_percent": null,
  "orderbook_price_currency": "BNFCR",
  "expansion_down_enabled": "false",
  "expansion_down_stop_price": null,
  "grid_lines": [
    {
      "id": 256427680,
      "price": "0.022414",
      "side": null,
      "order_placed": false
    },
    {
      "id": 256427679,
      "price": "0.022325",
      "side": "buy",
      "order_placed": false
    }
  ],
  "mode": null
}