PeerBerry SDK_开发编程 skill-PHP中文网

PeerBerry SDK

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

使用此技能来帮助处理FortressQuant的peerberry-sdk，用于PeerBerry投资者自动化、P2P贷款教育以及另类投资入门。

PeerBerry SDK Sk.

功能概述

PeerBerry SDK Sk.是一项面向实际任务的技能，主要用于Skill.TL；DR 快速启动；

核心要点

以只读的电话为首开始( 获取 profile, 获取浏览, 获取贷款 )；
使用十进制来获取金钱和利率, 永远不要浮出水面；
购买贷款作为真实的 mone。

使用与执行

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；

结果检查与注意事项

若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

PeerBerry SDK 技能

TL;DR 快速入门

优先使用只读调用（get_profile、get_overview、get_loans）。
金额与利率一律使用 Decimal 类型，**禁止使用** float。
将 purchase_loan 视为真实资金操作，并通过 DRY_RUN 和 MAX_ORDERS 进行严格管控。
优先使用 SDK 提供的过滤参数（如 min_interest_rate、countries、loan_types），而非在本地进行二次过滤。
捕获具体的认证/资金类异常，再统一回退至 PeerberryException。

只读模式快速启动示例：

from peerberry_sdk import PeerberryClient

with PeerberryClient(email="YOUR_EMAIL", password="YOUR_PASSWORD") as api:
    profile = api.get_profile()
    overview = api.get_overview()
    loans = api.get_loans(quantity=5)

    print(profile.public_id)
    print(overview.data.get("availableMoney", overview.data.get("items", {}).get("availableMoney")))
    print([loan.loan_id for loan in loans])

安全投资模式快速启动示例：

from decimal import Decimal
from peerberry_sdk import PeerberryClient

DRY_RUN = True
MAX_ORDERS = 10
TICKET_SIZE = Decimal("10.00")

with PeerberryClient(email="YOUR_EMAIL", password="YOUR_PASSWORD") as api:
    loans = api.get_loans(quantity=50, min_interest_rate=Decimal("9.5"), exclude_invested_loans=True)

    for idx, loan in enumerate(loans):
        if idx >= MAX_ORDERS or loan.loan_id is None:
            break

        if DRY_RUN:
            print(f"[DRY_RUN] would invest {TICKET_SIZE} in loan {loan.loan_id}")
            continue

        api.purchase_loan(loan_id=loan.loan_id, amount=TICKET_SIZE)

核心目标

peerberry-sdk 是 PeerBerry 投资者 API 的 Python 封装库。在 P2P 借贷中，投资者将资金分散配置于多笔贷款（或贷款份额），随时间逐步收回本金与利息，并通过分散投资与持续监控来管理风险。PeerBerry 为投资者提供接入该类市场流程的渠道，而本 SDK 则将这些流程转化为可编程的 Python 接口，支持分析、自动化及运营控制。

适用范围 / 非目标

在范围内：

以通俗语言解释 PeerBerry 及 P2P 借贷基本概念。
基于 SDK 实际公开方法签名生成并调试 Python 代码。
构建只读监控脚本与受控的投资自动化逻辑。
协助处理筛选、分页、导出及认证/令牌生命周期等常见模式。

不在范围内：

提供金融建议、适配性建议，或承诺收益保障。
保证盈利性、安全性或未来表现。
虚构 SDK 中不存在的方法。

请求分类器

对用户输入请求进行分类，并按匹配类型响应：

educational：用户初次接触 P2P 或 PeerBerry。
- 先讲解基础概念，再提供只读演示代码。
- 加载参考文档：references/p2p-primer.md。
read_only_coding：用户需要组合投资组合或贷款数据分析。
- 提供可直接运行的代码片段，并包含类型化模型处理逻辑。
- 加载参考文档：references/api-quickref.md。
real_money_automation：用户需要实现买入/投资流程。
- 必须加入 DRY_RUN、MAX_ORDERS、可用资金校验，并明确标注风险提示。
- 加载参考文档：references/api-quickref.md 与 references/task-recipes.md。
debugging：用户遇到错误或异常。
- 按优先级排查：认证问题 → 枚举型参数输入 → 过滤元数据 → 请求体结构。
- 加载参考文档：references/api-quickref.md。

前提条件

在 PeerBerry 官方网站（https://peerberry.com/）注册并验证投资者账户。
使用有效的 PeerBerry 凭据（email 与 password）。
若账户启用了 TOTP 两步验证（2FA），需提供 tfa_secret 并安装 otp 扩展依赖。
所有购买操作均应视为真实资金操作，需谨慎对待。

关键概念与对象

主要入口点：

PeerberryClient：用于身份认证、数据获取与购买操作的高层客户端。

核心模型对象：

Profile、Overview、Loan、LoanPage、InvestmentPage、Transaction、AccountSummary、PurchaseOrder。

领域语义说明：

loan：可在市场上投资的贷款标的（列表项）。
investment：已持有的某笔贷款中的投资头寸。
purchase order：已被接受的订单结果，含 order_id（非最终结算确认）。

安装与认证

安装命令：

pip install peerberry-sdk

启用两步验证（2FA）支持的安装命令：

pip install "peerberry-sdk[otp]"

认证示例：

from peerberry_sdk import PeerberryClient

with PeerberryClient(email="YOUR_EMAIL", password="YOUR_PASSWORD") as api:
    print(api.get_profile().public_id)