Philidor Docs
API Reference

Vault Detail

Single vault endpoints — risk breakdown, events, markets, strategies.

GET /v1/vault/{network}/{address}

Get full vault details including risk vectors, APR decomposition, audit status, snapshots, events, and rewards.

Path Parameters

ParameterTypeDescription
networkstringNetwork slug: ethereum, base, arbitrum, polygon, optimism, avalanche
addressstringVault contract address (0x...)

Example

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

Response

Includes all fields from the vault list, plus:

  • risk_vectors — individual vector scores (asset, platform, governance)
  • protocol_version, protocol_website, protocol_launch_date
  • audit_status, auditors[], audit_date, audit_report_url
  • is_immutable, timelock_seconds
  • deployment_timestamp
  • snapshots[] — historical TVL and APR data points
  • events[] — curator actions, incidents, parameter changes
  • rewards[] — reward token breakdown (symbol, APR, type)

GET /v1/vault/{network}/{address}/events

Get all events for a vault — incidents, parameter changes, allocation changes, curator actions.

Example

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

Response

{
  "success": true,
  "data": [
    {
      "id": 1234,
      "event_type": "allocation_change",
      "severity": "info",
      "title": "Market allocation updated",
      "description": "Curator adjusted market weights",
      "tx_hash": "0x...",
      "block_number": 19500000,
      "occurred_at": "2026-02-20T10:00:00Z"
    }
  ]
}

GET /v1/vault/{network}/{address}/markets

Get market allocations for Morpho vaults. Returns collateral risk summary per lending market.

Example

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

Only returns data for Morpho protocol vaults. Returns 404 for non-Morpho vaults.


GET /v1/vault/{network}/{address}/strategies

Get strategy details for Yearn vaults. Returns sub-strategy breakdown from ydaemon.

Example

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

Only returns data for Yearn protocol vaults.


GET /v1/vault/{network}/{address}/strategy

Get strategy information for Beefy vaults. Returns processed strategy with yield sources, risk flags, and APY.

Example

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

Only returns data for Beefy protocol vaults.

On this page

Raw