defiexec-preview
GET api.agentstools.dev/yield/preview
Why an agent can trust this route.
Sonar evidence is advisory. Paid delivery is shown as verified only when paid probes are available; otherwise route estimates use the unpaid handshake as a clearly labeled proxy.
Observed outcomes
Lightweight yield preview for Base without calldata: give protocol, asset or vault, raw amount and action and get the expected shares or assets and the safety flags (paused/frozen/cap, empty-vault inflation risk). A cheap check before you build the full transaction.
Resource: api.agentstools.dev/yield/preview
Network: eip155:8453 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493
Payment methods: — · Last validation: 2026-09-14 16:34:50.293+00
{
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET",
"HEAD",
"DELETE"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"protocol",
"amount"
],
"properties": {
"asset": {
"type": "string",
"description": "For aave-v3/compound-v3: the asset symbol (USDC, WETH, ...) or a 0x ERC-20 address. Compound III earns only on its base asset."
},
"vault": {
"type": "string",
"description": "For erc4626: the vault 0x address (ANY Base ERC-4626) or a seed slug. Resolved on-chain."
},
"action": {
"enum": [
"deposit",
"redeem"
],
"type": "string",
"description": "deposit (supply) or redeem (withdraw). Default deposit."
},
"amount": {
"type": "string",
"description": "Raw atomic units. deposit: underlying assets. redeem: aave/comet = underlying (or 'max'); erc4626 = shares (or 'max')."
},
"protocol": {
"enum": [
"aave-v3",
"compound-v3",
"erc4626"
],
"type": "string",
"description": "Yield protocol: aave-v3, compound-v3 or erc4626."
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
},
"paymentRequirements": [
{
"raw": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493",
"amount": "10000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493",
"scheme": "exact",
"network": "eip155:8453",
"amountAtomic": "10000"
}
]
}Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.