Understand partner economics
Connect productive balances to the customer return, protocol fee and partner revenue model.
The business case starts with balances that can participate in Earn and an experience customers choose to use. The reporting model then separates three quantities: the yield generated, the protocol's fee on that yield, and the partner's share of that fee.
Read the calculation
GET /partner/revenue returns the partner's TVL, protocol blend APY, protocol fee rate, partner share and annual/daily estimates. Its calculation is:
annual yield estimate = TVL × protocol blend APY
annual protocol fees = annual yield estimate × protocol fee rate
annual partner revenue = annual protocol fees × partner share
The current implementation uses a protocol fee rate of 0.10. The partner share is an account setting expressed as a fraction from 0 to 1. These describe the API calculation; the commercial agreement defines the terms for a launch.
A worked example
For a model with $1,000,000 of TVL, a 5% annual rate, a 10% protocol fee on yield, and a 20% partner share of that fee:
| Calculation | Annual estimate |
|---|---|
| Yield: $1,000,000 × 0.05 | $50,000 |
| Protocol fees: $50,000 × 0.10 | $5,000 |
| Partner revenue: $5,000 × 0.20 | $1,000 |
This is an explanation of the model. It is not a rate quote or a payout record. In particular, a 20% partner share in this example means 20% of the protocol fee, not 20% of the customer's principal or all gross yield.
Use the model in a product decision
Vary the eligible balance, customer participation and rate assumptions. Keep those assumptions visible to the decision maker. Compare a focused pilot with a broader rollout using the same definitions.
Use reporting to separate estimated revenue from recorded activity, and agree the commercial and operational handoff in the launch review.