API Reference
Portfolio
Analyze DeFi positions for any Ethereum address.
GET /v1/address/{address}/positions
Get all vault positions for an address across all supported chains. Returns individual vault positions with risk scores and a portfolio-level weighted risk assessment.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| address | string | Ethereum address (0x...) |
Example
curl https://api.philidor.io/v1/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/positionsResponse
{
"success": true,
"data": {
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"positions": [
{
"vault_id": "morpho-ethereum-0x...",
"vault_name": "Gauntlet USDC Core",
"chain_name": "Ethereum",
"protocol_name": "Morpho",
"asset_symbol": "USDC",
"balance_usd": "50000",
"total_score": 8.5,
"risk_tier": "prime",
"apr_net": "0.0523"
}
],
"summary": {
"total_value_usd": "150000",
"weighted_risk_score": 7.8,
"position_count": 3
}
}
}Use Cases
- Portfolio risk monitoring across all DeFi positions
- Concentration analysis (exposure to single protocol/chain/curator)
- Risk-weighted returns calculation
- See Portfolio Risk Analysis for a full walkthrough