{"uid":"cap_xzJh1z7_vC_qO09prYGrb","slug":"orcpin-defi-snapshot-3402f86a","name":"Orcpin DeFi Snapshot","description":"DeFi position and wallet risk snapshot on Base: token balances, account flags, and live Aave v3 collateral, debt, borrowing power, and health factor read directly from the protocol at a specific block, plus derived risk metrics — net equity, LTV utilization, leverage multiplier, health-factor band, and collateral drawdown tolerance (how far collateral can fall before liquidation). For agents assessing portfolio exposure and liquidation risk.","url":"https://orcpin.dev/v1/defi-snapshot?utm_source=zero.xyz","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":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"EVM wallet address to snapshot (0x...)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"data":{"type":"object","properties":{"aave_v3":{"type":"object"}}},"address":{"type":"string"},"sources":{"type":"array","items":{"type":"string"}},"disclaimer":{"type":"string"},"block_number":{"type":"integer"},"schema_version":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"aave_v3":{"pool":"0xA238Dd80C259a72e81d7e4664a9801593F98d1c5","available":true,"total_debt":"500000000","has_position":true,"health_factor":"2.5","total_collateral":"1500000000","available_borrows":"200000000","loan_to_value_bps":8000,"no_outstanding_debt":false,"current_liquidation_threshold_bps":8300},"account":{"is_contract":false,"transaction_count":42},"native_balance":{"wei":"1000000000000000","symbol":"ETH","formatted":"0.001"},"token_balances":[{"raw":"1000000","symbol":"USDC","contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6,"formatted":"1.0"}]},"as_of":"block","chain":"Base","address":"0x0000000000000000000000000000000000000001","sources":["public_rpc","on_chain_read","aave_v3_pool"],"chain_id":8453,"timestamp":"2026-06-18T12:00:00.000Z","disclaimer":"Informational snapshot. See /terms.","block_number":12345678,"schema_version":"1.0.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sS9KJNclXp6sfK_qfv71I","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a block-anchored on-chain snapshot of a Base wallet's native balance, token holdings, and Aave v3 DeFi positions","exampleAgentPrompt":"Can you pull a full on-chain snapshot for Base wallet 0x1234567890abcdef1234567890abcdef12345678 — I want to see its ETH balance, token holdings, and any Aave v3 positions including health factor and debt?","exampleUseCases":null,"resultDescription":"A JSON object containing the block number and timestamp of the snapshot, native ETH balance (wei and formatted), ERC-20 token balances with contract addresses and decimals, Aave v3 pool data (collateral, debt, health factor, LTV bps, liquidation threshold, available borrows), account metadata (is_contract, transaction_count), chain/chain_id, data sources used, and a schema version string.","failureModes":["Invalid or malformed wallet address (not matching ^0x[a-fA-F0-9]{40}$) returns validation error","Wallet has no activity — returns empty token_balances and no Aave position (has_position: false)","RPC or on-chain read failure may result in partial data or service unavailable","Payment not fulfilled via x402 protocol returns 402 Payment Required","Rate limiting or quota exceeded returns error response"],"whenToPreferThis":"Use this endpoint when you need a single, block-anchored, factual snapshot of a Base wallet's complete DeFi state including Aave v3 positions — particularly when health factor, liquidation risk, or collateral/debt ratios matter. Prefer this over generic blockchain explorers when you need structured, agent-ready JSON with DeFi protocol data already decoded.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:36:57.603Z","isFirstParty":false,"canonicalSlug":"orcpin-defi-snapshot-3402f86a"}