Onboarding Yield-bearing Assets
This guide outlines the process of onboarding yield-bearing assets to Balancer v2. To fully leverage Balancer's technology, you'll need to complete several key steps including token setup, rate provider implementation, pool creation, and optional gauge setup for BAL rewards.
Step-by-Step Onboarding Process
1. Token Setup
First, ensure your token is properly whitelisted on Balancer. See our token whitelisting guide for detailed instructions.
2. Rate Provider Implementation
Documentation
For detailed information, see our rate provider onboarding FAQ
For yield-bearing asset stable pairs using a stable pool, you must provide a vetted rate provider during pool creation:
Review Timeline
Rate provider reviews typically take 1-2 weeks for Balancer Labs to complete. Monitor the issue board for review status.
3. Pool Creation and Initialization
Use the community pool creator tool to create your pool:
- Select ComposableStable Pool type
- Set
Yield Protocol Fee Exempt
tofalse
- Add your token and approved rate provider
- Add additional tokens (up to 5) with their rate providers
- Create the pool
- Perform an init join to seed initial liquidity
4. APR Data Integration
To ensure accurate yield metrics display:
- Provide an API endpoint for your yield-bearing token
- Format:
api-yourtoken
- Include APR in return values
- Format:
- Register your endpoint in the yield token registry
- This ensures correct APR display across Balancer frontend deployments
5. BAL Rewards Setup (Optional)
If you want to receive BAL rewards, you'll need to set up a gauge and apply through governance.
Gauge Creation
Network-Specific Instructions
Find detailed gauge creation endpoints for different networks in our instructions overview
Governance Application Timeline
- Submit proposal following the instruction set
- Contributor review by Thursday
- Voting period: Thursday 8PM CET to Monday 8PM CET
- On-chain gauge controller transaction by Tuesday evening CET
- Gauge appears on veBAL voting page
Reward Distribution
- Ethereum mainnet: BAL rewards begin after voting round
- L2 networks (Arbitrum, Polygon POS): One week delay before reward streaming