Silvana Book Agent can run as a long-running liquidity provider, placing grid orders, responding to RFQs, and coordinating DvP settlement. The agent communicates with Silvana through gRPC, while transactions are verified and signed locally.

Liquidity modes

Silvana Book Agent supports two liquidity modes:

Grid orders — place limit orders at configured levels around the current mid price.
RFQ (Request for Quote) — respond to incoming quote requests using configured spreads and size limits.

Both are configured through agent.toml.

Before you start

Complete agent onboarding first to set up your agent, create the required configuration, and confirm that everything is ready to use.

Configure liquidity

Choose the liquidity mode you want to configure. Both modes use agent.toml.

Grid Orders
RFQ

Grid orders place bids and offers at configured levels around the current mid price.

Add a market

Add an enabled market to agent.toml:

[[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 grid is cancelled and rebuilt.

Add bid levels

Bids are placed below the mid price, so delta_percent uses negative 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"

Add offer levels

Offers are placed above the mid price, so delta_percent uses positive 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"

quantity defines the order size at each level.

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

RFQ mode lets the agent respond to incoming quote requests for configured markets.

Configure the liquidity provider

Add the liquidity provider settings to agent.toml:

[liquidity_provider]
name = "My LP"
max_concurrent_rfqs = 10
default_quote_valid_secs = 60

max_concurrent_rfqs limits how many RFQs can be handled at the same time.

Enable RFQ for the market

Add RFQ settings under the relevant market:

[markets.rfq]
enabled = true
min_quantity = "5"
max_quantity = "1000"
bid_spread_percent = 0.5
offer_spread_percent = 0.5
quote_valid_secs = 60
allocate_before_secs = 900
settle_before_secs = 1800

min_quantity and max_quantity define the supported RFQ range.bid_spread_percent and offer_spread_percent control quote pricing around the current mid price.

How RFQ works

Once RFQ is enabled, the agent receives quote requests for the configured market, calculates a price from the current mid price and spread, checks quantity limits and available balance, and returns a quote or rejection.

When an RFQ is rejected

An RFQ can be rejected when:

the market is disabled or not configured;
RFQ is disabled for the market;
the quantity is outside min_quantity or max_quantity;
no mid price is available yet;
the agent has insufficient balance.

RFQ behavior

How RFQ works

When an RFQ is rejected

An RFQ can be rejected when:

the market is disabled or not configured;
RFQ is disabled for the market;
the quantity is outside min_quantity or max_quantity;
no mid price is available yet;
the agent has insufficient balance.

Agent options

Use these flags when you need more control over agent execution:

Flag	Description
`--orders-only`	Place and manage grid orders without settlement
`--settlement-only`	Process settlement without placing grid orders
`--dry-run`	Prepare and verify transactions without signing or executing them
`--confirm`	Ask for confirmation before signing each transaction
`--verbose`	Enable detailed logging
`--config <PATH>`	Use a specific `agent.toml` file

Start with --dry-run when testing new grid levels, spreads, or thresholds.

Operational tips

Keep enough CC available for AGENT_FEE_RESERVE_CC and transaction fees.
Check balances with cloud-agent info balance.
Use price_change_threshold_percent to control how often the grid is refreshed.
Use max_concurrent_rfqs to control parallel RFQ exposure.
Restart the agent after changing agent.toml.

Quickstart

Trading

Agents

How to Provide Liquidity

Liquidity modes

Before you start

Configure liquidity

RFQ behavior

Agent options

Operational tips

​Liquidity modes

​Before you start

​Configure liquidity

​RFQ behavior

​Agent options

​Operational tips

Liquidity modes

Before you start

Configure liquidity

RFQ behavior

Agent options

Operational tips