Prerequisites
An approved organization in the Client Portal
Your organization must be set up and approved in the Client Portal. A master services agreement (MSA) and org setup are required even if you only plan to run streams. See Client Portal setup.
The streams-create permission enabled
Stream creation is gated by a
streams-create permission on your organization. If your org does not have it yet, contact the Turtle team to turn it on.A funded wallet on your target chain (token streams only)
For a token stream, the wallet that creates the stream must sit on the right chain and already hold enough of the reward token to cover the total reward amount plus the creation fee. Point streams have no on-chain step and no funding requirement at creation.
An allowlisted reward token
The reward token must be an allowed reward token. Confirm it is allowlisted on your chain before you commit to a launch. Resolve which tokens are allowed through get-tokens.
A supported chain for reward-token creation
Creating a token stream is currently supported on Ethereum, Base, Avalanche, BSC, and Sepolia (testnet). Target tokens, the tokens whose balances are tracked to measure TVL, span a broader set of chains. See Supported chains below.
Decisions to make before you launch
Have answers to these ready. Each one maps to a field you will set when you create the stream.Reward source: tokens or points
Reward source: tokens or points
A stream pays either a real ERC-20 reward token or off-chain points, never both. Token streams settle on-chain. Point streams are created instantly with no on-chain step and can convert to tokens at a future TGE.Best for tokens: you have a live, allowlisted ERC-20 and want LPs to claim it on-chain now. Best for points: you are pre-TGE or want to track contribution before committing real tokens.See Choosing a reward model for the tradeoff, and create-point for the points path.
Stream type
Stream type
There are five types: Fixed Rate, Fixed APR, Daily Budget, Airdrop, and Yield Match. The right one depends on whether you want to fix cost per unit of TVL, advertise a headline APR, cap daily spend, hand out rewards manually, or top up a vault’s yield.Choosing a reward model walks through each type and when to use it.
Duration
Duration
Decide your start time and, optionally, an end time. Two gotchas to plan around: start and end timestamps must align to 15-minute boundaries in UTC, and an end time, if set, must be at least one hour after the start. Rewards begin accruing after creation, and the first snapshot lands within about 12 hours. Exact formatting rules are in the create-stream reference.
The rate, budget, or APR for your type
The rate, budget, or APR for your type
Each type takes one headline number. Fixed Rate takes a
tokensPerUSD (reward tokens per 1,000 USD of TVL per day). Fixed APR takes an apr. Daily Budget takes a tokensPerDay and computes the total automatically, so you do not specify a total for this type. Yield Match takes a targetApy (gap-fill mode) or an optional apyOffset (mirror mode). Airdrop takes no rate; you upload allocations yourself.Name your number now. The exact format and base-units rules live in the create-stream reference.Boosts or restrictions
Boosts or restrictions
Optionally, you can layer boost plugins on top of base rewards: boost Turtle members, verified X or Telegram accounts, restrict to a whitelist, exclude a blacklist, or forward vault rewards to underlying LPs. These are configured at creation through the
adapters array. See the create-stream reference for the full list and configuration.Supported chains
Streams are live on the chains below. Reward-token creation is limited to this set. Target tokens are supported on a broader range of chains; resolve which tokens are available on a chain through get-tokens.| Chain | Status |
|---|---|
| Ethereum | Live |
| BSC | Live |
| Avalanche | Live |
| Base | Live |
| Sepolia | Testnet |
New chains are added by deploying a StreamFactory and configuring an indexer webhook. If the chain you need is not listed, see the contact path below.
If your token is not allowlisted or your chain is not supported
Reward tokens must be allowlisted, and token-stream creation is currently limited to Ethereum, Base, Avalanche, BSC, and Sepolia. If your token is not yet allowed or your chain is not supported, reach out to the Turtle team through the Client Portal. The team can allowlist a token or scope a new chain deployment.
Next steps
Choose a reward model
Compare the five stream types and pick the one that fits your goal.
Create a stream
Walk through launching a stream from the Client Portal step by step.