Guides
Comparing Vaults
How to compare vaults side-by-side using the API and MCP server.
API Approach
Fetch two vaults and compare them programmatically:
const [vault1, vault2] = await Promise.all([
fetch(
'https://api.philidor.io/v1/vault/ethereum/0x8eB67A509616cd6A7c1B3c8C21D48FF57df3d458'
).then((r) => r.json()),
fetch(
'https://api.philidor.io/v1/vault/ethereum/0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB'
).then((r) => r.json()),
]);
const comparison = {
vault1: vault1.data.vault,
vault2: vault2.data.vault,
};
console.table([
{ metric: 'Risk Score', v1: comparison.vault1.total_score, v2: comparison.vault2.total_score },
{ metric: 'Risk Tier', v1: comparison.vault1.risk_tier, v2: comparison.vault2.risk_tier },
{ metric: 'APR', v1: comparison.vault1.apr_net, v2: comparison.vault2.apr_net },
{ metric: 'TVL', v1: comparison.vault1.tvl_usd, v2: comparison.vault2.tvl_usd },
{ metric: 'Strategy', v1: comparison.vault1.strategy_type, v2: comparison.vault2.strategy_type },
{ metric: 'Audited', v1: comparison.vault1.is_audited, v2: comparison.vault2.is_audited },
]);MCP Approach
The compare_vaults tool handles the comparison automatically:
"Compare the Gauntlet USDC vault (0x8eB67A509616cd6A7c1B3c8C21D48FF57df3d458) and the Steakhouse USDC vault (0xBEEF01735c132Ada46AA9aA4c54623cAA92A64CB) on Ethereum"
The tool accepts 2-3 vaults and compares across all dimensions.
Comparison Dimensions
| Dimension | What to compare | Why it matters |
|---|---|---|
| Risk Score | Composite 0-10 | Overall safety assessment |
| Risk Vectors | Asset, Platform, Governance individually | Where the risk lies |
| APR | Net APR and base vs rewards breakdown | Yield sustainability |
| TVL | Total value locked | Liquidity and exit risk |
| Strategy Type | lending vs aggregation vs leverage | Complexity and attack surface |
| Audit Status | Audited, audit count, recency | Code verification |
| Curator | Who manages the vault | Track record and trust |
| Protocol Age | Lindy score | Battle-tested code |
Finding Comparable Vaults
To find vaults for comparison, filter by the same asset:
curl "https://api.philidor.io/v1/vaults?asset=USDC&sortBy=total_score&sortOrder=desc&limit=10"This returns the top 10 USDC vaults by risk score, giving you a natural comparison set.