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:

  1. Review existing rate providers in our registryopen in new window
  2. If needed, submit your rate provider for review hereopen in new window

Review Timeline

Rate provider reviews typically take 1-2 weeks for Balancer Labs to complete. Monitor the issue boardopen in new window for review status.

3. Pool Creation and Initialization

Use the community pool creator toolopen in new window to create your pool:

  1. Select ComposableStable Pool type
  2. Set Yield Protocol Fee Exempt to false
  3. Add your token and approved rate provider
  4. Add additional tokens (up to 5) with their rate providers
  5. Create the pool
  6. Perform an init join to seed initial liquidity

4. APR Data Integration

To ensure accurate yield metrics display:

  1. Provide an API endpoint for your yield-bearing token
    • Format: api-yourtoken
    • Include APR in return values
  2. Register your endpoint in the yield token registryopen in new window
  3. 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-919open in new window), set up a gauge and configure secondary rewards. See the Gauge Onboarding Guide and Incentive Management Guide for full instructions.

Additional Resources