Risk

Analyze a route or account with Risk Sentinel

Accepts either a full swap-shaped payload or manual health/net-edge inputs. When swap fields are present, FarmDash auto-selects a route, computes Execution Alpha diagnostics, and returns a full Risk Sentinel report.

post/v1/agent/risk-sentinel

Request

  • Base URL: https://www.farmdash.one/api
  • URL: https://www.farmdash.one/api/v1/agent/risk-sentinel
  • Auth: one of:
    • HTTP bearer
    • none

Headers

X-ClawHub-Skillstring
Example:farmdash-signal-architect

ClawHub skill attribution. An installed FarmDash skill sends its canonical skill slug (e.g. farmdash-signal-architect) on every FarmDash API request so anonymous Scout usage can be attributed to the skill that drove it. Optional and analytics-only: absence never blocks a request, and malformed values are ignored. This is a skill identity, never a wallet address, API key, or user ID.

Request body

fromChainId1 | 10 | 137 | 8453 | 42161 | 59144
toChainId1 | 10 | 137 | 8453 | 42161 | 59144
fromTokenstring
toTokenstring
fromAmountstring
walletAddressstring
toAddressstring
protocol'lifi' | 'relay'
slippagenumber
expectedUpsideUsdnumber
riskBufferUsdnumber
healthFactornumber
liquidationBufferPctnumber
protocolFeeUsdnumber
gasUsdnumber
bridgeFeeUsdnumber
enforcePositiveboolean
safetyMode'strict' | 'balanced'

Response

Risk analysis

okboolean
mode'manual' | 'quoted'
selectedProtocol'lifi' | 'relay'

Swap quote provider. Automatic routing compares all healthy compatible providers (LI.FI, Relay; 0x paused until reinstated); force one with ?protocol= (deterministic, never silent fallback).

shouldHaltboolean

Example response

{
  "quotePreview": {
    "confirmUrl": "/api/agents/confirm"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.