# 核对Velora集成费用：容量套餐、分成与待领取余额

整理：链小知（AI 辅助）
资料核对日期：2026-10-14
引用地址：https://lianxiaozhi.com/tools/guides/velora-api-capacity-partner-fees-claim-ledger
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

按当前官方资料，把请求容量与交易分成拆开，再核Market/Delta的费用合约、历史累计和领取失败；只形成可审阅的费用核对表。

## 使用工具
- [Velora（原ParaSwap）](https://lianxiaozhi.com/tools/velora) · [官方入口](https://www.velora.xyz/)

## 前置条件
- 准备所用模式、链和已有脱敏配置或费用记录；无记录时只按文档列待核项
- 确认本人/组织资格与商业条款；本教程不开户、订阅、签名或操作资产

## 1. 先区分容量套餐、交易模式和商业资格

将材料分成API容量与交易经济两张表。免费partner只是请求中的应用标识，默认1 RPS和每日5000次；付费套餐提高速率、日配额与支持。按持续RPS、burst、每日请求分别核需求，不能用套餐名或日配额代替峰值速率，也不能按交易次数直接计算API调用量。

当前Basic每月500美元、10 RPS、burst 20、每日5万次；Pro每月700美元、20 RPS、每日12万次。只是核对日的标价，订阅与定制商业条款另确认。Market和Delta按所用模式和链分列，Gnosis/Avalanche的当前静态表只列Market。官网条款的资格与限制同样适用于API；本教程只核已有材料。

核对结果：容量单位、模式/链与资格分列；免费标识或付费套餐均未写成已开通交易分成或本人可交易。
依据：[Velora Pro API accounts](https://www.velora.xyz/docs/overview/pro-api-accounts)
依据：[Velora free-tier rate limits](https://www.velora.xyz/docs/integrate/rate-limits)
依据：[Velora chains and contracts](https://www.velora.xyz/docs/resources/chains-and-contracts)
依据：[Velora terms of use, April 1 2025](https://www.velora.xyz/terms/terms-of-use)

## 2. 只选择一种交易变现模型并核报价净额

partnerFeeBps表示基点，文档例200为2%；应在报价阶段传入，使报价包含该费用。takeSurplus选择盈余分享，两者互斥；若同时提供，partnerFeeBps优先。旧positiveSlippageToUser已弃用，当前isSurplusToUser要求takeSurplus为true。

逐项记录partner、partnerAddress、partnerFeeBps或takeSurplus、isSurplusToUser和模式。partner字符串用于标识集成，不能把任意字符串当已获分成许可。前段规定无partner默认anon的1 bps，末段却概括费用/盈余需partner；在配置核清前保留差异，不能据末段当匿名零费。

核对结果：基点、互斥优先级、报价是否含费及匿名默认已记录；未重复扣费，缺商业配置仍标待核。
依据：[Velora Monetization](https://www.velora.xyz/docs/overview/monetization)
依据：[Velora Pro API accounts](https://www.velora.xyz/docs/overview/pro-api-accounts)

## 3. 按执行路径拆合作方收入与用户盈余

默认partner fee分成中，Delta为100%合作方，Market为85%合作方/15%Velora；盈余分享两者均为50%/50%，可有定制条款。假设已完成交易对应可分配partner fee为100个单位，Market默认合作方85、平台15；这只是分成算例，不是按输入资产总额直接乘，也不是实际收益。

isSurplusToUser把合作方的盈余份额转给终端用户，不是把双方全部盈余都给用户；它在兑换交易中结算，没有额外领取步骤。API容量月费与这张分成表独立，不能付了套餐就删除交易分成或把报价盈余当固定收入。

核对结果：模式、费用资产与分成基数对应；容量账单、合作方收入及用户盈余已分开，算例未当实收。
依据：[Velora Monetization](https://www.velora.xyz/docs/overview/monetization)
依据：[Velora Pro API accounts](https://www.velora.xyz/docs/overview/pro-api-accounts)

## 4. 核费用落在哪个合约、是否仍需领取

Market默认把合作方费累积到Fee Claimer；Delta累积在Delta主合约。两者使用同一个Fee Claimer界面但各自领取、各链分别处理，不能把UI合并当一次全链领取。Market的isDirectFeeTransfer可逐笔直接转给partnerAddress，绕过归集但用户每次多付转费gas；Delta不支持该开关。

在已有脱敏材料中逐项列模式、chainId、fee token、partnerAddress、合约角色和归集/直接转费。领取由匹配partnerAddress的钱包签名，并由领取方付gas；无领取回执就不能标已到账。旧Augustus v6之前费用属于Legacy Claimer，不能套当前余额或合约。

核对结果：链/币种/partnerAddress与Market或Delta合约对应；直接支付、归集和已领取状态没有混用。
依据：[Velora Monetization](https://www.velora.xyz/docs/overview/monetization)
依据：[Velora chains and contracts](https://www.velora.xyz/docs/resources/chains-and-contracts)

## 5. 将历史累计与待领取余额分开

文档的费用token统计端点列历年累计，包含已领取与未领取。它可提示曾经产生费用的币种，不能直接当当前余额。已有材料应另列当前余额字段、读取链与时间；Market示例getBalance(token,partner)，Delta示例getCollectedFees(partner,token)，参数顺序也不同。

当前方法每次可领取一个币种的完整归集余额并指定recipient；合作方地址负责签名，recipient只是接收地址。材料缺余额或领取交易状态时保留未知，不将历史统计与累计报价相加得出可提现收入。此处不运行示例或请求端点。

核对结果：历史累计、当前余额、已领取回执及地址角色分别记录；缺余额未当零或可领总额。
依据：[Velora Monetization](https://www.velora.xyz/docs/overview/monetization)

## 6. 把领取失败定位到币种与整笔范围

文档将代币拒绝转账等情况记为TransferFailed()；多币种一次领取中，一个币转账失败会让整笔回滚。失败余额仍在对应合约，不应标已损失或已领取。界面把部分币种标Unclaimable并可排除；状态与具体币种必须按已有材料核。

程序方法建议发送前逐币模拟，部分RPC不支持eth_simulateV1时用simulateContract逐币核。模拟成功不是已广播或已到账，模拟失败也不总能单凭错误断言代币冻结。本教程产出容量/分成表与费用状态表；未运行RPC、签名或领取。Delta概览的gasless也不能免除领取方gas，native source的存入交易另有流程。

核对结果：失败币种、整笔回滚范围和未知原因保留；模拟、发送与最终到账状态未混作成功。
依据：[Velora Monetization](https://www.velora.xyz/docs/overview/monetization)
依据：[Delta overview](https://www.velora.xyz/docs/delta/overview)

## 常见错误
- 把付费吞吐套餐当免交易分成或已获商业资格。
- 把Market和Delta同一领取界面当同一个归集合约。
- 用历史累计端点计算当前待领取余额。
- 把模拟成功、归集或quote当实际领取到账。

## 完成检查
- 容量和交易费用各有独立单位、模式与限制
- 形成逐链逐币费用状态表，缺项与文档差异明确保留

## 相关知识

## 官方依据
- [Velora Pro API accounts](https://www.velora.xyz/docs/overview/pro-api-accounts)
- [Velora free-tier rate limits](https://www.velora.xyz/docs/integrate/rate-limits)
- [Velora chains and contracts](https://www.velora.xyz/docs/resources/chains-and-contracts)
- [Velora terms of use, April 1 2025](https://www.velora.xyz/terms/terms-of-use)
- [Velora Monetization](https://www.velora.xyz/docs/overview/monetization)
- [Delta overview](https://www.velora.xyz/docs/delta/overview)