什么是PeerBerry SDK
PeerBerry SDK 是一个专为 P2P 借贷投资者设计的 Python 工具包，作为 PeerBerry 投资平台 API 的高层封装，旨在简化自动化投资流程、投资组合监控与数据分析。该 SDK 允许用户通过编程方式访问 PeerBerry 平台上的贷款市场、账户概览和交易记录，支持从基础信息查询到实际投资操作的全流程控制。其设计核心在于将复杂的金融数据交互转化为简洁、安全的 Python 调用，帮助个人投资者高效管理另类投资组合。 SDK 强调安全实践与风险控制，所有涉及资金的操作默认启用‘试运行’模式（DRY_RUN），并要求开发者设置最大订单数限制（MAX_ORDERS）。它推荐使用 Decimal 类型处理金额和利率，避免浮点数精度问题。此外，SDK 提供了丰富的过滤参数，如最低利率、国家或贷款类型筛选，以便用户精准定位符合策略的标的。对于新手用户，SDK 也内置了教育性指引，解释 P2P 借贷基本概念及平台运作机制，确保使用者在理解业务逻辑的基础上进行技术操作。 该工具适用于希望将手动投资行为转化为自动化脚本的开发者，尤其适合那些希望通过量化策略筛选贷款、定期执行分散化投资的用户。无论是构建个人投资组合仪表盘，还是开发自动投标机器人，PeerBerry SDK 都提供了稳定且可扩展的技术接口。项目托管于 GitHub，配套文档详尽，涵盖快速入门、API 参考和安全最佳实践，便于持续集成与维护。
核心功能特点
- 提供对 PeerBerry 投资者账户的完全编程访问，支持登录认证与令牌生命周期管理
- 支持只读操作与真实投资动作分离，默认启用 DRY_RUN 模式防止误操作
- 内置 Decimal 类型处理财务数据，确保利率和金额的精确计算
- 支持多维度贷款筛选，包括最低利率、国家来源、贷款类型及已投状态排除
- 提供投资组合概览、持仓查询、交易流水导出等财务管理功能
- 兼容两步验证（TOTP），可通过 pip install ‘peerberry-sdk[otp]’ 安装扩展支持
适用场景
PeerBerry SDK 最典型的应用场景是个人投资者希望实现 P2P 借贷投资的自动化。例如，一个刚接触 PeerBerry 平台的用户可以通过 SDK 编写脚本，每日自动获取最新发布的贷款列表，并根据预设条件（如年化收益率不低于9.5%、仅选择特定国家的借款人）进行初步筛选。这种自动化不仅节省时间，还能确保投资策略的一致性，避免情绪化决策影响收益。 另一个常见场景是投资组合监控与分析。开发者可利用 SDK 的 get_overview、get_investments 和 get_transactions 方法，定期拉取账户资产状况和现金流数据，结合外部图表库生成可视化报表。这对于需要实时掌握本金回收进度、利息到账频率以及整体风险敞口的投资者尤为有用。 对于进阶用户，SDK 还支持构建智能投资机器人。在 DRY_RUN 模式下模拟多次运行后，系统可逐步过渡到真实交易环境，每次仅购买固定面额（如10欧元）的小额贷款以分散风险。同时，SDK 会检查可用余额是否充足，并在遇到 InsufficientFunds 异常时及时停止，有效规避资金不足导致的订单失败或信用损失。