# Integrators program

<figure><img src="https://4022236167-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lw-v0NTae0RVW1spR9R%2Fuploads%2FxkaXX5fifZNhvDLgOH2X%2FIntegrators.png?alt=media&#x26;token=c50f871e-5be8-4162-8aa2-76a0c287bd57" alt=""><figcaption></figcaption></figure>

The **Integrators program** allows DeFi protocols to efficiently integrate the Idle product suite into their services and workflow. Any partners that integrate Idle products can earn up to a <mark style="color:blue;">**50% profit share**</mark> from the contributed TVL originating from dApps, wallets, or payment gateways.

{% hint style="info" %}
We'd love to hear from you if you are interested in partnering with us! \
Please reach out to us by filling out the [Integrator program form](https://idlefinance.typeform.com/to/PUC7nO).
{% endhint %}

### Programs details

Best Yield vaults and Yield Tranches are deployed on the Ethereum and the Polygon chain. The program is then available on both chains.&#x20;

The [Treasury League](https://docs.idle.finance/governance/idle-dao/idle-leagues/treasury-league) periodically executes reward transfers, which an automated on-chain fee-sharing mechanism will then replace.

{% tabs %}
{% tab title="Tiers" %}
These tiers of fee sharing apply to all the active Integrators partner programs.

<table><thead><tr><th data-type="number">Tier</th><th align="right">Partner's TVL</th><th align="right">Fee share</th></tr></thead><tbody><tr><td>1</td><td align="right">$1 - 5m</td><td align="right">10%</td></tr><tr><td>2</td><td align="right">$5 - 10m</td><td align="right">15%</td></tr><tr><td>3</td><td align="right">$10 - 50m</td><td align="right">20%</td></tr><tr><td>4</td><td align="right">$50 - 100m</td><td align="right">25%</td></tr><tr><td>5</td><td align="right">$100 - 200m</td><td align="right">30%</td></tr><tr><td>6</td><td align="right">$200 - 400m</td><td align="right">35%</td></tr><tr><td>7</td><td align="right">$400 - 700m</td><td align="right">40%</td></tr><tr><td>8</td><td align="right">$700m - 1b</td><td align="right">45%</td></tr><tr><td>9</td><td align="right">> $1b</td><td align="right">50%</td></tr></tbody></table>
{% endtab %}

{% tab title="Ethereum" %}
The Ethereum program distributes the rewards on a monthly basis through a [vesting contract](https://legacy.idle.finance/#/tools/b2b-vesting-contract) available under the [Tool section of the legacy app](https://legacy.idle.finance/#/tools/b2b-vesting-contract). Tokens are vested on a linear basis over a 3-month period.&#x20;

The minimum threshold to distribute the rewards is 500 IDLE.

* Product: Best Yield vaults and Yield Tranches
* Rewards: IDLE
* Frequency: monthly
* Distribution: [vesting contract](https://legacy.idle.finance/#/tools/b2b-vesting-contract) with a 3-month length

Integrators can use the following Dune dashboards to track the program's rewards.

{% embed url="<https://dune.com/idle.finance/ipp-ethereum>" %}
{% endtab %}

{% tab title="Polygon" %}
The Polygon *zkEVM* program distributes rewards on a weekly basis to the partner's wallet address.

The minimum threshold to distribute the rewards is 100 MATIC.

* Product: Yield Tranches
* Rewards: MATIC
* Frequency: weekly
* Distribution: direct transfer to partner's wallet

Integrators can use the following Dune dashboards to track the program's rewards.

{% embed url="<https://dune.com/idle.finance/integration-partners-program-polygon>" %}
{% endtab %}

{% tab title="Optimism" %}
The *Optimism* program distributes rewards on a weekly basis to the partner's wallet address.

The minimum threshold to distribute the rewards is 100 MATIC.

* Product: Yield Tranches
* Rewards: OP
* Frequency: weekly
* Distribution: direct transfer to partner's wallet
  {% endtab %}
  {% endtabs %}

<details>

<summary>How to integrate</summary>

As an integrator partner, the methods you should look for are

#### **Best Yield**

* [<mark style="color:blue;">`mintIdleToken`</mark>](https://docs.idle.finance/developers/best-yield/methods/mintidletoken) method, where you should add the Ethereum or Polygon <mark style="color:blue;">`_referral`</mark> address

#### **Yield Tranches**

* [`depositAARef`](https://docs.idle.finance/developers/yield-tranches/methods/depositaaref) or [`depositBBRef`](https://docs.idle.finance/developers/yield-tranches/methods/depositbbref) methods depending on which side of the tranche you want to integrate, Senior (AA) or Junior (BB).&#x20;

The [Best Yield](https://docs.idle.finance/developers/best-yield) and the [Yield Tranches](https://docs.idle.finance/developers/yield-tranches) sections under the Developers chapter provide more technical and detailed information regarding the strategies.

</details>

<details>

<summary>Benefits</summary>

Idle is a battle-tested protocol since 2019 with a strong focus on protocol safety and the continuous development of its products suite. Starting a partnership with Idle would bring to the partner value, a solid reputation from the DeFi industry and would open the door to effortless financial autonomy opportunities.

**Best Yield**

* Get access to a seamless yield generation from multiple underlying sources with just one integration
* Optimize capital allocation in the best-performing strategies
* Deposit single-sided assets, with no impermanent loss
* Save money, with Idle subsidizing rebalance's fees
* Save time, with Idle taking care of underlying codebase upgrades

**Yield Tranches**

* Get access to risk-adjusted profiles to accommodate a wider audience, introducing coverage features and yield boosts
* Simplify integration, as Idle strategies are compatible with the ERC-4626 standard
* Increase returns thanks to periodic compounding
* Do not lock your users' funds, as YTs have no locking periods or epochs

</details>

<details>

<summary>Current integrators</summary>

Multiple partners have integrated either the Best Yield strategies or the Yield Tranches. \
A list of current on-top integrators follows.

**Best Yield**

* [ShapeShift](https://shapeshift.com/)
* [Spool](https://www.spool.fi/)
* [Enzyme](https://enzyme.finance/)
* [Yearn](https://yearn.finance/)
* [Harvest](https://harvest.finance/)
* [Balancer](https://balancer.fi/)

**Yield Tranches**

* [ShapeShift](https://shapeshift.com/)
* [Swissborg](https://swissborg.com/)
* [Spool](https://www.spool.fi/)
* [Harvest](https://harvest.finance/)
* [Sense](https://sense.finance/)
* [Clearpool](https://clearpool.finance/)
* [Popcorn](https://pop.network/)

</details>

<details>

<summary>FAQs</summary>

* **How do I earn fees?**\
  Include your wallet address as part of the deposit transaction data. More information regarding the input parameters of the deposit method can be found in the BY and YTs methods sections in the [Developers](https://docs.idle.finance/developers) chapter.
* **When do you share fees?**\
  Leagues process the IDLE distribution towards the vesting contracts on a monthly basis on Ethereum. The MATIC distribution on Polygon is done on a weekly basis.
* **Should I claim the tokens?**\
  The Ethereum fees should be claimed in the [vesting contract](https://legacy.idle.finance/#/tools/b2b-vesting-contract). The Polygon fees instead are sent to the referral address attached to deposits, no need to claim it.
* **Do I lose the rewards if I do not reach the minimum threshold?**\
  Accrued fees that do not reach the minimum threshold are recorded in Dune's dashboards. Once rewards reach the distribution threshold, the fee-sharing payments are executed.
* **How is the fee sharing calculated?**\
  Let's see a practical example.\
  For the first 30 days, the Partner's TVL deposited is $90m, enabling him to receive a 25% fee-share. Ten days after the first sharing event, its TVL is worth $200m and holds the same value for the remaining 20 days of the second month. The time-weighted TVL for this 30-day timeframe would be worth $163M, letting him access Tier 5, i.e. 30% fee-share.&#x20;

</details>


---

# 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.idle.finance/products/get-involved/integrators-program.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.
