VitalFi API - Solana Vault Indexing Service
============================================

Documentation: https://github.com/credit-markets/vitalfi-backend
Program ID: 146hbPFqGb9a3v3t1BtkmftNeSNqXzoydzVPk95YtJNj

ENDPOINTS
---------

GET  /api/health
     Health check and KV connectivity status
     
     Response: { ok: true, kv: true, timestamp: "..." }

GET  /api/vaults?authority={pubkey}&status={status}&cursor={epoch}&limit={n}
     List vaults by authority with optional status filtering
     
     Parameters:
       - authority (required): Base58 authority pubkey
       - status (optional): Funding | Active | Matured | Canceled
       - cursor (optional): Unix epoch timestamp for pagination
       - limit (optional): Max items (1-100, default 50)
     
     Response: { items: VaultDTO[], nextCursor: number|null, total: number|null }

GET  /api/positions?owner={pubkey}&cursor={epoch}&limit={n}
     List positions by owner wallet
     
     Parameters:
       - owner (required): Base58 wallet pubkey
       - cursor (optional): Unix epoch timestamp for pagination
       - limit (optional): Max items (1-100, default 50)
     
     Response: { items: PositionDTO[], nextCursor: number|null, total: number|null }

GET  /api/activity?(vault|owner)={pubkey}&cursor={epoch}&limit={n}
     Activity feed for vault or owner (reverse chronological)
     
     Parameters:
       - vault OR owner (required): Exactly one of vault PDA or owner pubkey
       - cursor (optional): Unix epoch timestamp for pagination
       - limit (optional): Page size (1-100, default 50)
     
     Response: { items: ActivityDTO[], nextCursor: number|null, total: null }