Returns the instance’s liquidation bots, newest first, with each bot’s state read from the chain. It also returns the instance’s deployed markets, which are the markets a bot can be connected to. Archived bots are left out unless includeArchived is set.A liquidation bot is a contract the operator deploys and owns, which holds LIQUIDATOR_ROLE on the markets it is connected to so that any caller can trigger a liquidation through it. The owner wallet signs every change to a bot. Trusset holds no key to it and never calls it. Deploy Liquidation Bot explains what it does and who calls it.Chain reads are cached for up to 15 seconds. A read that fails is marked readFailed, never reported as a disconnected market.
Query Parameters
boolean
default:"false"
true or 1 includes archived bots. Any other value counts as false.
Response Fields
object
Show child attributes
array
Bot records ordered by createdAt, newest first.
Show child attributes
string
Bot ID.
string
Instance that recorded the bot.
string
The bot contract’s address.
string
The wallet that deployed the bot, recorded at confirmation.
string | null
Display label.
boolean
Whether the bot is hidden from the default list.
string
Hash of the deployment transaction.
string
When the deployment was confirmed.
string
Last change to the record.
object | null
The bot’s live state, or null for a record without a contract address. When even the owner cannot be read, this is only { "readFailed": true, "isOnChain": null }.
Show child attributes
boolean
true when the contract answered.
boolean
false when the contract answered.
string
The contract’s current owner. It differs from ownerWallet only if ownership was transferred on-chain outside this API.
boolean | null
Whether the owner paused every trigger.
string | null
Most wei refunded to one caller within one block. 0 disables refunds.
string | null
Gas price ceiling for refunds, in wei. 0 means no ceiling.
string | null
The bot’s float, in the network’s native coin, as a decimal string.
array
One entry per deployed, active market of the instance, whether connected or not.
Show child attributes
string
Market ID.
string
Market contract address.
string | null
Collateral token name.
string | null
Collateral token symbol.
string | null
Borrow asset symbol.
boolean | null
Whether the owner enabled this market on the bot.
boolean | null
Whether the market granted the bot LIQUIDATOR_ROLE.
boolean
true only when both enabled and roleGranted are true. Either alone leaves the bot unable to liquidate on this market.
boolean | null
Whether the bot’s recorded owner holds DEFAULT_ADMIN_ROLE on the market, so it can sign both halves of a connection. null when it could not be read or the chain reports another owner.
boolean
Present and true when either read failed. connected is then false without being a verdict.
boolean | null
true when a liquidation through the bot on this market sells the seized collateral to the sale recipient in the same transaction, and reverts when the sale recipient cannot buy. See Atomic sale. false when it takes the two-step or auction path, null when that could not be read.
object | null
The reads behind settlesAtomically, or null when the market’s liquidation router could not be resolved. A field is null when its read failed.
Show child attributes
boolean | null
true: the router carries the atomic sale.
boolean | null
true: the market carries the atomic sale.
integer | null
The router’s atomic mode: 1 atomic, 0 two-step.
boolean | null
Whether the market opens Dutch auctions, which take precedence over the atomic sale.
boolean | null
true only when mode is 1 and Dutch auctions are off.
array
The instance’s deployed, active markets, newest first. Each has id, marketAddress, collateralTokenName, collateralTokenSymbol, borrowAssetSymbol and liquidationRouterAddress.