# Orcpin DeFi Snapshot

> Orcpin DeFi Snapshot is a paid API for AI agents from orcpin.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-12).

Returns a block-anchored on-chain snapshot of a Base wallet's native balance, token holdings, and Aave v3 DeFi positions

## Facts

- Endpoint: GET https://orcpin.dev/v1/defi-snapshot?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/orcpin-defi-snapshot-3402f86a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xzJh1z7_vC_qO09prYGrb

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability orcpin-defi-snapshot-3402f86a
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/orcpin-defi-snapshot-3402f86a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from orcpin.dev](https://www.zero.xyz/host/orcpin.dev/llms.txt)