How to Trade in Grid Mode

Grid mode places limit orders at configured levels around the current mid price. The agent manages the grid automatically and rebuilds it when the market moves beyond the configured threshold.

Bids are placed below the mid price using negative offsets, while offers are placed above it using positive offsets.

Before you start

Complete agent onboarding first. It covers installing cloud-agent, setting up your agent identity, and creating the initial .env and agent.toml files.

Configure grid mode

Set the agent configuration

Open the agent.toml created during onboarding and check the main agent settings:

role = "trader"
auto_settle = true
poll_interval_secs = 7
rfq_v2_only = false

Keep rfq_v2_only = false when using grid orders.

Add a market

Add the market where you want the agent to place grid orders:

[[markets]]
market_id = "CC-USDC"
enabled = true
price_change_threshold_percent = 0.1

price_change_threshold_percent defines how far the mid price must move before the current grid is canceled and rebuilt at updated levels.

Add bid levels

Configure bids below the current mid price using negative delta_percent values:

[[markets.bid_levels]]
delta_percent = -0.015
quantity = "10"

[[markets.bid_levels]]
delta_percent = -0.2
quantity = "10"

[[markets.bid_levels]]
delta_percent = -0.3
quantity = "10"

Each quantity defines the order size for that level.

Add offer levels

Configure offers above the current mid price using positive delta_percent values:

[[markets.offer_levels]]
delta_percent = 0.015
quantity = "10"

[[markets.offer_levels]]
delta_percent = 0.2
quantity = "10"

[[markets.offer_levels]]
delta_percent = 0.3
quantity = "10"

Once the market and levels are configured, the grid is ready to run.

Run the grid

Choose how you want the agent to operate:

Grid only
Full agent

Run only the grid-order workflow:

cloud-agent agent --orders-only

This mode places and manages grid orders without processing settlement.

Run the complete long-running agent:

cloud-agent agent

The agent manages grid orders together with settlement and any RFQ workflows configured in agent.toml.

Grid orders are not placed when rfq_v2_only = true. The --orders-only option also conflicts with this setting.

Test your configuration

Use --dry-run to prepare and verify transactions without signing or executing them:

cloud-agent agent --orders-only --dry-run

Once the configuration behaves as expected, start the agent without --dry-run.

Useful options

Flag	Description
`--orders-only`	Place and manage grid orders without settlement
`--dry-run`	Prepare and verify transactions without signing or executing
`--verbose`	Enable detailed logging
`--config <PATH>`	Use a specific `agent.toml` file

How the grid refreshes

Each grid level is defined by:

delta_percent — percentage offset from the current mid price
quantity — order size at that level

When the mid price moves by more than price_change_threshold_percent, the agent cancels the existing grid orders and places them again at updated price levels.

For more advanced configuration, CLI options, and implementation details, see the Silvana Book Agent README.

Quickstart

Trading

Agents

How to Trade in Grid Mode

Before you start

Configure grid mode

Run the grid

Test your configuration

Useful options

​Before you start

​Configure grid mode

​Run the grid

​Test your configuration

​Useful options

Before you start

Configure grid mode

Run the grid

Test your configuration

Useful options