{"id":29418424,"url":"https://github.com/logarithm-labs/yield-analysis-sdk","last_synced_at":"2025-07-11T23:04:58.906Z","repository":{"id":302558983,"uuid":"1009657380","full_name":"Logarithm-Labs/yield-analysis-sdk","owner":"Logarithm-Labs","description":"A Python SDK for DeFi vault registration and yield analysis services within the Agent Commerce Protocol (ACP) ecosystem.","archived":false,"fork":false,"pushed_at":"2025-07-10T03:42:17.000Z","size":366,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-10T08:19:13.045Z","etag":null,"topics":["acp","defi","erc4626","python","virtuals"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Logarithm-Labs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-27T13:45:40.000Z","updated_at":"2025-07-10T03:42:21.000Z","dependencies_parsed_at":"2025-07-03T03:31:37.235Z","dependency_job_id":"d1179fa8-a318-4703-a964-d677823d8449","html_url":"https://github.com/Logarithm-Labs/yield-analysis-sdk","commit_stats":null,"previous_names":["logarithm-labs/yield-analysis-sdk"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Logarithm-Labs/yield-analysis-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Logarithm-Labs%2Fyield-analysis-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Logarithm-Labs%2Fyield-analysis-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Logarithm-Labs%2Fyield-analysis-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Logarithm-Labs%2Fyield-analysis-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Logarithm-Labs","download_url":"https://codeload.github.com/Logarithm-Labs/yield-analysis-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Logarithm-Labs%2Fyield-analysis-sdk/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264910722,"owners_count":23682124,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["acp","defi","erc4626","python","virtuals"],"created_at":"2025-07-11T23:04:55.936Z","updated_at":"2025-07-11T23:04:58.891Z","avatar_url":"https://github.com/Logarithm-Labs.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Yield Analysis SDK\n\nA Python SDK for DeFi vault registration and yield analysis services within the Agent Commerce Protocol (ACP) ecosystem.\n\n## 🚀 Features\n\n- **ACP Integration**: Built-in support for Virtuals ACP (Agent Commerce Protocol)\n- **Vault Registration**: Complete workflow for registering DeFi vaults in the ACP ecosystem\n- **Yield Analysis Service**: Vault performance analysis and metrics calculation\n- **Multi-chain Support**: Ethereum, Arbitrum, Base, Optimism, Polygon, BSC, and more\n- **Comprehensive Metrics**: APY calculations, volatility analysis, Sharpe ratios, and drawdown tracking\n- **Real-time Data**: Fetch vault performance from blockchain subgraphs\n- **Type Safety**: Full Pydantic validation and type hints\n\n## 📦 Installation\n\n```bash\npip install yield_analysis_sdk\n```\n\n## 🔧 Quick Start\n\nFor detailed usage examples, see the `examples/` directory:\n\n- **`examples/analysis_service.py`**: Analysis service implementation\n  - Note: Do NOT add input/output requirements through the ACP UI when using this SDK setup\n  - Flexible data sources: Uses subgraph for price fetching, but alternative data sources can be configured\n- **`examples/registration.py`**: Vault registration and job management\n\n### Basic Usage\n\n```python\nfrom yield_analysis_sdk import Chain, analyze_yield_with_daily_share_price\n\n# See examples/analysis_service.py for complete implementation\n```\n\n## 🏗️ ACP Ecosystem Integration\n\nThis SDK provides two main services within the ACP ecosystem:\n\n### Vault Registration Service\n- Register new DeFi vaults for analysis\n- Validate vault addresses and chain compatibility\n- Manage registration workflow through ACP jobs\n\n### Yield Analysis Service\n- Provide vault performance analysis as an ACP service\n- Calculate comprehensive yield metrics\n- Deliver analysis results through ACP job completion\n\n## 📊 Supported Metrics\n\n- **APY Calculations**: 7-day, 30-day, 90-day annualized yields\n- **Risk Metrics**: Volatility, maximum drawdown, Sharpe ratio\n- **Vault Info**: Fees, capacity limits\n- **Multi-chain**: Cross-chain vault comparison\n\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests\n5. Submit a pull request\n\n## 📞 Support\n\n- **Email**: dev@logarithm.fi\n- **Issues**: [GitHub Issues](https://github.com/yourusername/yield-analysis-sdk/issues)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flogarithm-labs%2Fyield-analysis-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flogarithm-labs%2Fyield-analysis-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flogarithm-labs%2Fyield-analysis-sdk/lists"}