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 streaming your own secondary 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 Exempttofalse - 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. Secondary Rewards Setup (Optional)
If you want to stream your own reward tokens to LPs (BAL emissions to gauges are halted per BIP-919), set up a gauge and configure secondary rewards. See the Gauge Onboarding Guide and Incentive Management Guide for full instructions.