Launch an incentive campaign from the Client Portal in a few steps.
This page walks through launching a stream end to end. There are two ways to do it. The no-code path runs entirely through the Client Portal and is the focus here. If you would rather create streams from your own backend, the API path covers the same flow programmatically.Before you start, confirm your organization is approved and has the streams-create permission, and (for token streams) that the creating wallet already holds enough reward token to cover the total plus the creation fee. See Before you start.
Choosing a reward model
Decide the reward type and mechanic before you configure rates.
Create from the API
Build the request, get the signed transaction params, and broadcast it yourself.
Go to dashboard.turtle.xyz and connect the wallet you will create the stream from. For token streams this wallet pays the reward token and the creation fee, so connect the one that holds the funds on the right chain.
Reward token selection is currently supported on Ethereum, Base, Avalanche, BSC, and Sepolia. Make sure your wallet is on one of these chains before you continue.
2
Start a new stream
From the Streams area, select New Stream to open the creation flow. The Streams overview page also shows every existing stream with its type, cost per $1k of TVL per day, distributed and remaining balance, and health.
The Streams overview — start a new stream from the top right.
3
Choose your reward base and reward type
A stream pays either a reward token or points, never both — and pays for either value held, deposit commitment, or a one-off list.
Tokens: pays a real ERC-20 on-chain. Budgets and rates read in dollars. The token must be an allowlisted reward token on a supported chain.
Points: pays units of a points program — amounts read in points and can convert to tokens at a future TGE. Point streams are created instantly, with no on-chain transaction, no funding, and no creation fee.
Then pick the reward type: TVL-Based (holders earn continuously against their balance), Deposit-Based (reward how long depositors commit, through duration tiers), or Airdrop (a one-time distribution defined by a recipient list).
Reward base and reward type — the first two choices of every stream.
Choosing points removes the later approval and signing steps, since there is no on-chain creation transaction, and narrows the mechanics to those that need no token price (Fixed Rate, Daily Budget, Airdrop). See Get tokens and Get points for what is available.
4
Select a mechanic
The mechanic determines which rate field you fill in next. For TVL-based streams: Fixed APR, Fixed Rate, or Daily Budget under Standard Rewards, and Target APR or Reference APR under Gap-Fill Rates. For deposit-based streams you pick the deposit dimension (Duration — tiers by holding period; Size is coming soon) and how tier rates read (Fixed APR or Fixed Rate).For the tradeoffs and how to pick, read Choosing a reward model.
Mechanic selection for a deposit-based stream: the deposit dimension, then how tier rates read.
5
Select the target and the reward asset
Pick the target — the opportunity or token whose on-chain balance is tracked to measure each wallet’s contribution. Search by chain, by opportunity (with native APR and active TVL shown), by receipt token, or paste a contract address directly.
The target picker: browse opportunities by chain, or paste a contract address.
Then pick the reward asset — the allowlisted ERC-20 you pay out (or the points program for point streams). The target and the reward asset are independent and usually different.
The reward asset picker: allowlisted tokens by chain, with prices.
6
Configure the rate, budget, and duration
The configuration screen depends on your mechanic. For Target APR you drag the target line above the native APY curve and pay only the gap; for deposit-based streams you build the duration tiers. All configurations share the same core inputs:
Rate: the headline number for your mechanic — an APR, tokens per $1k per day, a daily budget, a target APR, or per-tier rates.
Estimated TVL: the TVL you expect to incentivise. Derived figures — the estimated stream cost and the implied reward APR — are computed from it and marked as estimates.
Duration: how long the stream runs. Start and end dates are set on the review step.
Configuring a Target APR stream: the rate, estimated TVL, duration, and the estimated stream cost.
The Est. Stream Cost panel shows the projected total in dollars and reward tokens, the distribution rate, the stream fee, and the maximum duration your budget supports. Streams are required to distribute a minimum of $33.33 per day, so the maximum duration is your budget divided by that floor — the end date fills in from it automatically, and you can shorten it but not extend it past what the budget covers. For deposit-based streams, the estimated cost assumes every deposit completes all tiers.
7
Review: schedule, eligibility, restrictions, and bonuses
The review screen sets the start and end dates and the audience controls:
Eligibility: who can earn, by deposit route — All Deposits, Turtle Only (deposits made through the Turtle UI or any Turtle distributor), or Select Distributors (only deposits routed through distributors you choose).
Whitelist: restrict to tagged wallets, or upload a CSV list. Setting a whitelist takes precedence — the blacklist is disabled while whitelist tags are set, and the flow shows that it is.
Blacklist:OFAC Sanctioned Wallets (flagged by the Chainalysis Sanctions Oracle) are excluded by default; add Blocked Tags or upload a CSV list to exclude more.
Bonuses: percentage boosts on top of the earned rate — linked X account, linked Telegram account, Referral, and Asset-Holding Bonus.
Reward Forwarding (Advanced): redirect the stream’s earned rewards to another address — for example, forwarding rewards earned by a vault address through to the vault’s underlying LPs.
Spend Caps: an optional Max Budget (a hard cap on total rewards — the stream ends early once fully spent) and, for TVL-based streams, an optional Daily Cap (daily spend never exceeds it, even if TVL grows past the estimate).
The final configuration: schedule, eligibility, restrictions, bonuses, spend caps, and the stream summary.
Check everything before you fund: for token streams, the creating wallet must already hold the full total amount plus the creation fee, and for gap-fill mechanics the configuration is locked at creation. A stream’s total amount and duration cannot be increased after launch.
8
Fund the stream
Select Fund Stream. For token streams, approve the reward token spend, then sign the createStream transaction — the Turtle backend issues a signature and your wallet submits the transaction to the StreamFactory. Funding and launching are a single action; streams are fully collateralized at creation, with all funds to be distributed added upfront. Point streams skip the on-chain step and are created immediately.
9
Confirmation
The stream is live. The indexer begins tracking target token balances, and the first reward snapshot lands within about 12 hours. Track participants and accrued rewards from the Streams overview and the Distribution Dashboard. Once the first Merkle root is committed, LPs can start claiming; see Claiming rewards for the three ways to offer that.
Rewards accrue from creation, but the first claimable balance appears only once the first on-chain Merkle root is committed, roughly every 12 hours. For deposit-based streams, rewards become claimable at each cliff.
If the creating wallet is a Safe, create the stream through the API rather than signing in the browser. Call Create a stream to obtain the signed txParams, then submit the reward token approval and the createStream call from the Safe Transaction Builder to the StreamFactory for your chain.The submitting Safe must match the expected sender encoded in the signed params, or the transaction will revert. Contract addresses and the full broadcast walkthrough are in Create a stream.
