Strategy Sentinel Agent API

Overview

The Strategy Sentinel Agent is an autonomous agent that monitors and manages vault strategies. It provides comprehensive tools for reading strategy state, managing risk, rebalancing allocations, and executing administrative operations.

The Strategy Sentinel Agent has ADMIN privileges and can execute privileged operations. Access should be restricted to authorized administrators only.

Agent Responsibilities

Monitor strategy health and vault state
Detect and mitigate liquidation risks
Manage leverage strategy parameters
Rebalance portfolio allocations
Harvest yield from strategies
Make price-based decisions using real market data

Agent Tools

Read & Monitoring Tools

get_vault_state

Reads the vault’s global state including total assets, supply, and managed balance.

string

Total assets in vault (raw 18 decimals)

string

Total share supply (raw 18 decimals)

string

Total managed assets across all strategies (raw 18 decimals)

string

Human-readable total assets

string

Human-readable total supply

string

Human-readable total managed

{
  "raw": {
    "totalAssets": "500000000000000000000",
    "totalSupply": "475000000000000000000",
    "totalManaged": "1000000000000000000000"
  },
  "human": {
    "totalAssets": "500.00",
    "totalSupply": "475.00",
    "totalManaged": "1000.00"
  }
}

get_strategy_states

Fetches strategy addresses, their balances, and target BPS allocations from the Strategy Router.

string

Strategy contract address

string

Strategy balance (raw 18 decimals)

string

Target allocation in basis points (10000 = 100%)

string

Human-readable balance

string

Target allocation as percentage

[
  {
    "strategy": "0xSTRATEGY_LEVERAGE_ADDRESS",
    "raw": {
      "balance": "800000000000000000000",
      "targetBps": "8000"
    },
    "human": {
      "balance": "800.00",
      "targetPercent": "80.00%"
    }
  },
  {
    "strategy": "0xSTRATEGY_AAVE_ADDRESS",
    "raw": {
      "balance": "200000000000000000000",
      "targetBps": "2000"
    },
    "human": {
      "balance": "200.00",
      "targetPercent": "20.00%"
    }
  }
]

get_leverage_strategy_state

Gets comprehensive state of the leverage strategy including deposited amount, borrowed WETH, LTV, and pause status.

string

Total LINK deposited (raw 18 decimals)

string

Total WETH borrowed (raw 18 decimals)

string

Net exposure (raw 18 decimals)

string

Loan-to-value ratio (raw 18 decimals)

boolean

Whether strategy is paused

string

Maximum leverage loop iterations (1-6)

string

Borrow factor in basis points

string

Human-readable deposited amount

string

Human-readable borrowed WETH

string

Human-readable net exposure

number

LTV as decimal (e.g., 0.65 = 65%)

boolean

Pause status

number

Max depth as number

number

Borrow factor as percentage

{
  "raw": {
    "deposited": "800000000000000000000",
    "borrowedWETH": "150000000000000000",
    "netExposure": "650000000000000000000",
    "ltv": "650000000000000000",
    "paused": false,
    "maxDepth": "4",
    "borrowFactor": "6000"
  },
  "human": {
    "deposited": "800.00",
    "borrowedWETH": "0.15",
    "netExposure": "650.00",
    "ltv": 0.65,
    "paused": false,
    "maxDepth": 4,
    "borrowFactor": 60
  }
}

get_token_prices

Fetches real-time LINK and WETH prices from CoinGecko API.

string

LINK price in USD (scaled by 1e18)

string

WETH price in USD (scaled by 1e18)

string

How many LINK equal 1 WETH (scaled by 1e18)

string

Human-readable LINK price

string

Human-readable WETH price

string

Human-readable LINK/WETH ratio

string

24-hour LINK price change

string

24-hour WETH price change

string

Human-readable price ratio interpretation

string

Data source

{
  "raw": {
    "linkPriceUSD": "15000000000000000000",
    "wethPriceUSD": "3000000000000000000000",
    "linkPricePerWETH": "200000000000000000000"
  },
  "human": {
    "linkPriceUSD": "15.00",
    "wethPriceUSD": "3000.00",
    "linkPricePerWETH": "200.000000",
    "link24hChange": "2.50%",
    "weth24hChange": "1.20%",
    "interpretation": "1 WETH = 200.00 LINK"
  },
  "source": "CoinGecko API (real market prices)"
}

get_user_balances

Fetches vault share balance and withdrawable amount for a specific user.

string

required

User wallet address

string

User’s share balance (raw 18 decimals)

string

Withdrawable LINK amount (raw 18 decimals)

string

Human-readable shares

string

Human-readable withdrawable amount

{
  "raw": {
    "shares": "95230000000000000000",
    "withdrawable": "100500000000000000000"
  },
  "human": {
    "shares": "95.23",
    "withdrawable": "100.50"
  }
}

get_vault_apy

Calculates the vault APY based on TVL growth over time.

number

APY as decimal

string

Human-readable APY percentage

number

Current total value locked

number

TVL growth since last measurement

number

Time elapsed in seconds

{
  "apy": 0.1245,
  "readable": "12.45%",
  "tvl": 1000000000000000000000,
  "growth": 0.05,
  "dt": 86400
}

Vault Management Tools

vault_deposit

Deposit LINK into vault (admin operation).

string

required

Amount of LINK to deposit (human-readable)

string

Transaction hash

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

vault_withdraw

Withdraw shares from vault (admin operation).

string

required

Number of shares to withdraw

string

Transaction hash

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

rebalance_vault

Triggers vault rebalance to reallocate funds according to target weights.

string

Transaction hash

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

Rebalancing should be called after updating strategy target weights to execute the allocation changes.

harvest_strategy

Calls harvestAll() to collect yield from all strategies and return it to the vault.

string

Transaction hash

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

Risk Management Tools

check_liquidation_risk

Checks leverage strategy liquidation risk based on current LTV.

number

Current loan-to-value ratio

boolean

Whether LTV is safe (< 70%)

boolean

Whether LTV is in warning range (70-80%)

boolean

Whether LTV is critical (>= 80%)

{
  "ltv": 0.65,
  "safe": true,
  "warning": false,
  "critical": false
}

auto_deleverage

Repay debt to reduce liquidation risk.

string

Transaction hash

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

This operation will reduce leverage by repaying borrowed WETH. Use when LTV is too high or prices are volatile.

Strategy Configuration Tools

update_strategy_target_weights

Updates target allocation weights for strategies in basis points (10000 = 100%).

number

required

Target weight for leverage strategy (0-10000)

number

required

Target weight for Aave strategy (0-10000)

string

Transaction hash

object

New weight configuration

Show properties

number

Leverage strategy weight in BPS

number

Aave strategy weight in BPS

{
  "tx": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "newWeights": {
    "leverage": 7000,
    "aave": 3000
  }
}

The two weights must sum to exactly 10000 (100%). After updating weights, call rebalance_vault to execute the reallocation.

toggle_leverage_strategy_pause

Pauses or unpauses the leverage strategy.

string

Transaction hash

boolean

New pause state

string

Status description (“paused” or “active”)

{
  "tx": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "paused": true,
  "status": "paused"
}

When paused, the leverage strategy cannot invest or deleverage. Use this during high market volatility or when risk is elevated.

update_leverage_params

Updates leverage strategy parameters for fine-tuning risk exposure.

number

required

Maximum leverage loop iterations (1-6)

number

required

Borrow factor in basis points (0-8000, e.g., 6000 = 60%)

string

Transaction hash

object

New parameter configuration

Show properties

number

New max depth value

string

New borrow factor as percentage

{
  "tx": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "newParams": {
    "maxDepth": 3,
    "borrowFactor": "50%"
  }
}

maxDepth: Controls how many times the strategy loops to build leverage. Higher = more leverage, more gas.
borrowFactor: Percentage of collateral to borrow in each loop. Higher = more aggressive leverage.

Reduce these values during volatile market conditions to decrease risk.

Risk Management Strategy

The Strategy Sentinel Agent follows a rule-based risk management approach:

LTV Thresholds

Safe: LTV < 70% - Normal operations
Warning: LTV 70-80% - Monitor closely, consider reducing leverage
Critical: LTV >= 80% - Immediate deleveraging required

Price-Based Decisions

The agent uses real-time price data from CoinGecko to make informed decisions:

Fetch prices

Call get_token_prices to get current LINK/WETH prices

Assess volatility

Check 24h price changes to determine market volatility

Evaluate risk

If price volatility > 10% or prices dropping rapidly:

Pause leverage strategy (toggle_leverage_strategy_pause)
Reduce leverage params (update_leverage_params)
Adjust target weights (update_strategy_target_weights)

Execute changes

Call rebalance_vault to apply allocation changes

Target Weight Management

Default allocation:

Leverage Strategy: 80% (8000 BPS)
Aave Strategy: 20% (2000 BPS)

Adjust weights based on:

Market volatility (reduce leverage allocation during high volatility)
Price trends (shift to safer strategies when prices are declining)
LTV levels (reduce leverage allocation if LTV is consistently high)

Example: Complete Risk Mitigation Flow

// 1. Check current state
const prices = await get_token_prices();
const leverageState = await get_leverage_strategy_state();
const risk = await check_liquidation_risk();

// 2. Assess risk
if (risk.warning || prices.human.link24hChange < -5) {
  // High volatility or price drop detected
  
  // 3. Reduce leverage parameters
  await update_leverage_params({
    maxDepth: 2,  // Reduce from 4 to 2
    borrowFactor: 4000  // Reduce from 6000 to 4000 (60% to 40%)
  });
  
  // 4. Adjust target weights
  await update_strategy_target_weights({
    leverageStrategyBps: 6000,  // Reduce from 80% to 60%
    aaveStrategyBps: 4000  // Increase from 20% to 40%
  });
  
  // 5. Execute rebalance
  await rebalance_vault();
  
  // 6. If still critical, pause leverage strategy
  if (risk.critical) {
    await toggle_leverage_strategy_pause();
  }
}

Best Practices

Always check prices before decisions: Use get_token_prices to inform risk management
Monitor LTV regularly: Call check_liquidation_risk frequently
Gradual adjustments: Make incremental changes to leverage params rather than drastic shifts
Rebalance after weight changes: Always call rebalance_vault after updating target weights
Harvest regularly: Call harvest_strategy periodically to compound returns
Emergency pause: Use toggle_leverage_strategy_pause immediately if LTV exceeds 80%

​Overview

​Agent Responsibilities

​Agent Tools

​Read & Monitoring Tools

​get_vault_state

​get_strategy_states

​get_leverage_strategy_state

​get_token_prices

​get_user_balances

​get_vault_apy

​Vault Management Tools

​vault_deposit

​vault_withdraw

​rebalance_vault

​harvest_strategy

​Risk Management Tools

​check_liquidation_risk

​auto_deleverage

​Strategy Configuration Tools

​update_strategy_target_weights

​toggle_leverage_strategy_pause

​update_leverage_params

​Risk Management Strategy

​LTV Thresholds

​Price-Based Decisions

​Target Weight Management

​Example: Complete Risk Mitigation Flow

​Best Practices

Overview

Agent Responsibilities

Agent Tools

Read & Monitoring Tools

get_vault_state

get_strategy_states

get_leverage_strategy_state

get_token_prices

get_user_balances

get_vault_apy

Vault Management Tools

vault_deposit

vault_withdraw

rebalance_vault

harvest_strategy

Risk Management Tools

check_liquidation_risk

auto_deleverage

Strategy Configuration Tools

update_strategy_target_weights

toggle_leverage_strategy_pause

update_leverage_params

Risk Management Strategy

LTV Thresholds

Price-Based Decisions

Target Weight Management

Example: Complete Risk Mitigation Flow

Best Practices