# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kolibrio.xyz/kolibrio-orderflow-service/ethereum/advanced/tenant-+-user-revenue-flow.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.