> For the complete documentation index, see [llms.txt](https://docs.kolibrio.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kolibrio.xyz/kolibrio-orderflow-service/ethereum/advanced/tenant-+-user-revenue-flow.md).

# Tenant + User Revenue Flow

### Summary

Kolibrio ETH RPC now supports **referral-based user tracking and automated cashback payouts**. Each transaction can attribute a percentage of eligible revenue to a referred user, while the remaining share is accumulated on the Tenant account. User rewards are distributed hourly once the minimum payout threshold of 0.01 ETH is reached.\
\
**Base endpoint (example):**

```
https://eth-rpc.kolibr.io
?api_key={api_key}
&allow_reverts={true/false}
&mode={dynamic | balanced | maxprofit}
&user_address={0x...}
&user_percent=50
```

<table><thead><tr><th width="160.45703125">Name</th><th width="162.328125">Type</th><th>Example</th></tr></thead><tbody><tr><td>user_address</td><td><code>string</code> <br>(0x EVM address)</td><td>0x6ce70e85bEa007B66fc4f9E26C6591C4ccBccdb1</td></tr><tr><td>user_percent</td><td><code>integer</code> <br>(only integers. no floating point)</td><td><code>10</code>, <code>25</code>, <code>50</code>   <br><br></td></tr><tr><td>allow_reverts</td><td><code>boolean</code><br>(true by default)</td><td><code>true</code>, <code>false</code></td></tr><tr><td>mode</td><td>enum</td><td><code>dynamic</code>, <code>balanced</code>, <code>maxprofit</code></td></tr></tbody></table>

### Revenue & Settlement

**Tenant revenue**

* Revenue attributable to a **Tenant** is collected on the Tenant account.
* Tenant revenue is calculated as the **difference between total transaction revenue and the allocated `user_percent` share**.
* This remaining portion is **accumulated on the Tenant profile** for later claiming.
* The **tenant owner** can **claim at any time** directly in the app.

**User (referrer) revenue**

* The `user_address` accrues revenue **proportional to `user_percent`**.
* Payouts are **processed hourly** via cron when the accumulated amount **exceeds 0.01 ETH**.
* If the accrued amount is **≤ 0.01 ETH**, it continues to accumulate until it crosses the minimum payment threshold, then the next hourly cycle distributes it.