Quickstart

No API key needed for the endpoints below. The core data API is 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/api/mcp"
    }
  }
}

Or with Claude Code:

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

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

Next steps

Key Concepts to understand the data model
API Reference for all endpoints
MCP Tools for all 10 agent tools
Vault Due Diligence for step-by-step assessment