{"uid":"cap_7ag7JIZBC7xg__qTiUCqU","slug":"morpho-borrower-position-snapshot-stress-tester-base-d14a9790","name":"Morpho Borrower Position Snapshot & Stress Tester (Base)","description":"Base address -> deterministic Morpho borrower position snapshot and collateral-price stress scenarios. Returns LTV, LLTV, health factor, liquidation headroom, source freshness, and scenario outcomes. Read-only indexed observation; direct RPC verification is required before execution.","url":"https://agents.samedaydesk.com/defi/morpho-position","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"shocks":{"type":"string","description":"Optional comma-separated collateral-price shocks in percent."},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Borrower EVM address on Base mainnet."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","address","chain","positionCount","positions","source","boundary"],"properties":{"ok":{"type":"boolean"},"chain":{"type":"object"},"source":{"type":"object"},"address":{"type":"string"},"boundary":{"type":"string"},"fetchedAt":{"type":"string"},"positions":{"type":"array"},"positionCount":{"type":"integer"},"latestIndexedAt":{"type":"string","nullable":true}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"chain":{"id":8453,"name":"Base mainnet"},"source":{"indexed":"Morpho API","directRpc":"required before execution"},"address":"0x4352Cc849b33a936Ad93bB109aFDec1c89653b4f","boundary":"Read-only indexed observation; verify against direct RPC before execution.","positions":[{"risk":{"healthFactor":1.194,"currentLtvPct":72,"liquidationLtvPct":86,"liquidatableAtIndexedState":false},"marketId":"0x...","scenarios":[{"healthFactor":1.075,"liquidatable":false,"collateralPriceShockPct":-10}]}],"positionCount":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_g0_bb6r8VK45XSOr7nihH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a deterministic snapshot of a Morpho Protocol borrower's position on Base mainnet — including LTV, LLTV, health factor, liquidation headroom, and collateral-price stress scenario outcomes.","exampleAgentPrompt":"What's the current health factor and liquidation headroom for Morpho borrower 0xAbCd1234...5678 on Base, and run collateral price shocks of -10, -20, and -30 percent so I can see the stress scenario outcomes?","exampleUseCases":[{"title":"Pre-execution liquidation risk check","prompt":"Before I add more debt to my Morpho position at 0x1a2b3c4d5e6f7890abcdef1234567890abcdef12 on Base, can you pull the current LTV and health factor and tell me how much room I have before liquidation?"},{"title":"Portfolio stress testing for a DeFi fund","prompt":"Run collateral price shocks of -15, -30, and -50 percent on Morpho borrower 0xDeadBeef00000000000000000000000000001234 on Base so I can see which scenarios would trigger liquidation."},{"title":"Monitoring an at-risk borrower position","prompt":"Check the Morpho health factor and liquidation headroom for address 0xFeedFace000000000000000000000000cafebabe on Base right now — I want to know if this position is dangerously close to being liquidated."}],"resultDescription":"A structured JSON snapshot containing the borrower's current LTV, LLTV, health factor, liquidation headroom, data source freshness timestamp, and — if price shocks were requested — a set of scenario outcomes showing position viability at each specified collateral price decline. All data is read-only and indexed; direct RPC verification is recommended before taking any on-chain action.","failureModes":["Invalid or malformed EVM address returns a validation error","Address has no active Morpho borrower position — returns empty or null position data","Shock parameter malformed (non-numeric or wrong delimiter) causes parsing error","Stale indexed data if the indexer lags behind Base chain tip — check source freshness field","Network or RPC indexer downtime causes 5xx or timeout response"],"whenToPreferThis":"Choose this endpoint when you need a quick, structured, agent-ready risk snapshot of a specific Morpho Protocol borrower position on Base mainnet — especially when you want collateral price stress scenarios computed in a single call without writing RPC queries. It is ideal for pre-trade risk checks, liquidation monitoring, and portfolio health audits. Prefer it over raw RPC calls when you need formatted output with health metrics and scenario outcomes; always verify with direct RPC before executing any on-chain transaction.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:34:34.360Z","isFirstParty":false}