Quickstart

No API key needed. All endpoints are public read.

Step 1: Check platform stats

curl https://api.philidor.io/v1/stats

Returns total vaults, TVL, protocol count, chain count, and risk distribution.

Step 2: Search vaults

curl "https://api.philidor.io/v1/vaults?riskTier=prime&sortBy=apr_net&order=desc&limit=5"

Returns the top 5 Prime-tier vaults sorted by APR.

Step 3: Get a vault risk breakdown

curl https://api.philidor.io/v1/vault/ethereum/0x8eB67A509616cd6A7c1B3c8C21D48FF57df3d458

Returns full vault detail including risk vectors, APR decomposition, audit status, and events.

TypeScript

const res = await fetch('https://api.philidor.io/v1/vaults?riskTier=prime&limit=5');
const { data } = await res.json();

for (const vault of data) {
  console.log(`${vault.name}: score=${vault.total_score}, apr=${vault.apr_net}`);
}

Python

import requests

res = requests.get('https://api.philidor.io/v1/vaults', params={
    'riskTier': 'prime',
    'sortBy': 'apr_net',
    'order': 'desc',
    'limit': 5
})
data = res.json()['data']

for vault in data:
    print(f"{vault['name']}: score={vault['total_score']}, apr={vault['apr_net']}")

MCP Server (AI Agents)

Add Philidor to Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "philidor": {
      "url": "https://mcp.philidor.io"
    }
  }
}

Or with Claude Code:

claude mcp add philidor --transport http https://mcp.philidor.io

Then ask: "What are the safest USDC vaults on Ethereum?"

Next steps

Key Concepts — understand the data model
API Reference — all endpoints
MCP Tools — all 9 agent tools
Vault Due Diligence — step-by-step assessment guide