Philidor DeFi Vault Risk Analytics

Search and filter DeFi vaults by chain, protocol, asset, risk tier, TVL, and more. Returns a paginated list with risk scores and APR.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search by vault name, symbol, asset, protocol, or curator"
    },
    "chain": {
      "type": "string",
      "description": "Filter by chain name or slug (e.g. Ethereum, Base, Arbitrum, Solana)"
    },
    "protocol": {
      "type": "string",
      "description": "Filter by protocol ID: aave, morpho, spark, compound, yearn, beefy, uniswap, nest, maple, kamino. Aave V4 is protocol=aave plus protocolVersion=v4 (aave-v4 is accepted as an alias)."
    },
    "protocolVersion": {
      "type": "string",
      "description": "Filter by protocol generation: v3, v4, v3-lido, v3-horizon, klend, kvault. Required to isolate Aave V4 (protocol=aave, protocolVersion=v4). Vaults list this as protocol_version."
    },
    "asset": {
      "type": "string",
      "description": "Filter by asset symbol (e.g. USDC, WETH)"
    },
    "riskTier": {
      "type": "string",
      "description": "Filter by risk tier: Prime, Core, or Edge"
    },
    "minTvl": {
      "type": "number",
      "description": "Minimum TVL in USD"
    },
    "depositable": {
      "type": "boolean",
      "description": "Filter by current ability to accept new deposits. When true, vaults whose depositability is not yet indexed are still included; when false, only vaults whose maxDeposit on-chain is zero (caps reached, paused, or supply queue saturated) are returned."
    },
    "sortBy": {
      "type": "string",
      "description": "Sort field: tvl_usd, apr_net, name, last_synced_at"
    },
    "sortOrder": {
      "type": "string",
      "description": "Sort order: asc or desc"
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 10, max 50)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get detailed information about a specific DeFi vault including risk breakdown, recent events, and historical snapshots. Lookup by ID or by network + address.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Vault ID (e.g. morpho-1-0x...)"
    },
    "network": {
      "type": "string",
      "description": "Network slug from the chain registry (e.g. ethereum, base, arbitrum, solana). /v1/chains lists slugs for chains with active vaults."
    },
    "address": {
      "type": "string",
      "description": "Vault address in the chain's namespace: 0x-hex on EVM chains, base58 (case-sensitive) on Solana"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get a detailed breakdown of a vault's risk vectors: Asset Composition, Platform and Strategy, Control and Governance, and History scores with sub-metrics.

{
  "type": "object",
  "properties": {
    "network": {
      "type": "string",
      "description": "Network slug from the chain registry (e.g. ethereum, base, arbitrum, solana). /v1/chains lists slugs for chains with active vaults."
    },
    "address": {
      "type": "string",
      "description": "Vault address in the chain's namespace: 0x-hex on EVM chains, base58 (case-sensitive) on Solana"
    }
  },
  "required": [
    "network",
    "address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List lending markets: the market a depositor actually picks (Aave/Spark pool, Aave V4 spoke, Compound Comet, Morpho Blue pair, or Kamino K-Lend market). Aave V4 spokes that share a liquidity hub are grouped under a composed parent (aave-v4-1-hub-global-dollar). The API still keys each market on the spoke. NOTE: this is not `get_market_overview`, which returns platform-wide totals across all vaults.

{
  "type": "object",
  "properties": {
    "protocol": {
      "type": "string",
      "description": "Filter by protocol id: aave, spark, compound, morpho, kamino. Aave V4 is protocol=aave plus version=v4 (aave-v4 is accepted as an alias)."
    },
    "version": {
      "type": "string",
      "description": "Filter by protocol version: v3, v4, or klend. Use version=v4 with protocol=aave."
    },
    "chain": {
      "type": [
        "number",
        "string"
      ],
      "description": "Filter by chain: integer chain id (e.g. 1, 8453) or slug (e.g. ethereum, solana)"
    },
    "limit": {
      "type": "number",
      "description": "Results per page (1-100, default 20)"
    },
    "sortBy": {
      "type": "string",
      "enum": [
        "total_supplied_usd",
        "total_borrowed_usd",
        "reserve_count",
        "name"
      ],
      "description": "Sort field (default total_supplied_usd)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get one lending market with every reserve it contains: supplied, supply APR, borrowed, borrow APR, utilization and risk tier per reserve. Spoke ids look like aave-v4-10-etherfi-cash. Aave V4 hub parents (aave-v4-1-hub-global-dollar) are composed from the spokes that share that hub; /v1/markets does not serve those ids.

{
  "type": "object",
  "properties": {
    "marketId": {
      "type": "string",
      "description": "Market id from list_markets. Spoke example: aave-v4-10-etherfi-cash. Hub example: aave-v4-1-hub-global-dollar."
    }
  },
  "required": [
    "marketId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Published risk events for ONE lending market: incidents, bad debt, liquidation cascades (e.g. mass liquidations on a Morpho Blue market). Market ids look like morpho-v1-1-pt-reusd-10dec2026-usdc-91-5. Aave V4 hub ids (aave-v4-1-hub-global-dollar) union the spoke feeds. Not platform stats (get_market_overview) and not the market data itself (get_market).

{
  "type": "object",
  "properties": {
    "marketId": {
      "type": "string",
      "description": "Market id from list_markets. Spoke or composed hub parent (aave-v4-1-hub-global-dollar)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Max events (default 20)"
    }
  },
  "required": [
    "marketId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Underwrite a collateral/debt loop on ONE lending market: score, tier, utilization, borrow APR, deposit status, and recent incidents for both reserves. Does not compute health factor and does not prepare txs. Call this before a protocol MCP preview_action / prepare_action. If you do not have a market id, call list_markets first (Aave V4: protocol=aave, version=v4). Examples: aave-v4-1-main, aave-v4-10-etherfi-cash, aave-v4-1-hub-global-dollar.

{
  "type": "object",
  "properties": {
    "marketId": {
      "type": "string",
      "description": "Market id from list_markets. Spoke example: aave-v4-1-main. Hub example: aave-v4-1-hub-global-dollar."
    },
    "collateral": {
      "type": "string",
      "description": "Collateral asset symbol you will post (e.g. weETH, WETH, cbBTC)."
    },
    "debt": {
      "type": "string",
      "description": "Debt asset symbol you will borrow (e.g. USDC, USDT, GHO)."
    }
  },
  "required": [
    "marketId",
    "collateral",
    "debt"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Compare 2-3 DeFi vaults side-by-side on TVL, APR, risk score, risk tier, audited status, and more.

{
  "type": "object",
  "properties": {
    "vaults": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "network": {
            "type": "string",
            "description": "Network slug from the chain registry (e.g. ethereum, base, arbitrum, solana). /v1/chains lists slugs for chains with active vaults."
          },
          "address": {
            "type": "string",
            "description": "Vault address in the chain's namespace: 0x-hex on EVM chains, base58 (case-sensitive) on Solana"
          }
        },
        "required": [
          "network",
          "address"
        ],
        "additionalProperties": false
      },
      "minItems": 2,
      "maxItems": 3,
      "description": "Array of 2-3 vaults to compare"
    }
  },
  "required": [
    "vaults"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find the highest risk-scored DeFi vaults, optionally filtered by asset, chain, or minimum TVL. Returns the top 10 audited vaults sorted by Philidor risk score (higher = lower assessed risk; scores are not a safety guarantee).

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "description": "Filter by asset symbol (e.g. USDC, WETH)"
    },
    "chain": {
      "type": "string",
      "description": "Filter by chain name or slug (e.g. Ethereum, Base, Arbitrum, Solana)"
    },
    "minTvl": {
      "type": "number",
      "description": "Minimum TVL in USD"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get detailed information about a DeFi protocol including TVL, vault count, versions, auditors, and security incidents.

{
  "type": "object",
  "properties": {
    "protocolId": {
      "type": "string",
      "description": "Protocol ID: aave, morpho, spark, compound, yearn, beefy, uniswap, nest, maple, kamino. Aave V4 is listed under aave (aave-v4 is accepted as an alias)."
    }
  },
  "required": [
    "protocolId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get detailed information about a vault curator including their managed vaults, TVL, chain distribution, and performance.

{
  "type": "object",
  "properties": {
    "curatorId": {
      "type": "string",
      "description": "Curator ID"
    }
  },
  "required": [
    "curatorId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get a high-level overview of the DeFi vault market: total TVL, vault count, risk distribution, and TVL by protocol.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Explain what a Philidor risk score means, including the tier (Prime/Core/Edge), how it is calculated, and what the thresholds are.

{
  "type": "object",
  "properties": {
    "score": {
      "type": "number",
      "minimum": 0,
      "maximum": 10,
      "description": "Risk score (0-10) to explain"
    }
  },
  "required": [
    "score"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List all vaults that had a recent critical incident (last 365 days). Critical = severity Critical or incident_severity major. Results are sorted by TVL descending, then by time since event ascending (most recent first).

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}