Managing a Stream

Once a stream is live, rewards begin accruing and LPs can claim. From there you can watch participation, add funds, change the pace, or close the campaign out. This page covers the post-launch lifecycle and points to the dashboard and endpoints for each action. Which of these actions you do in the Client Portal versus the API is being confirmed, so each section below flags what still needs checking against the live product.

​

Monitor performance

Track a live stream from two places: the Distribution Dashboard for a visual read on participation and accrued rewards, and the wallets endpoint for the underlying per-wallet data. The Distribution Dashboard shows participants, recent snapshots, and accrued rewards over the life of the stream. See Distribution Dashboard for the full view. The Distribution Dashboard for a live stream. For programmatic monitoring, GET /v1/streams/{id}/wallets returns each participating wallet, its TVL contribution, and its accrued reward balance. See Get Wallets.

​

Top up or extend

You can add funds to a live stream without redeploying its contract. A top up extends how long the stream can keep paying at its configured rate, or raises the budget if you want to keep it running longer. For token streams a top up moves more of the reward token into the existing Stream contract, so the wallet still needs to hold enough of that token plus any applicable fee. See Create a Stream for the on-chain mechanics that also apply here.

​

Pause or resume

Pausing halts reward accrual. While a stream is paused, no new rewards are computed for the time it sits paused, so that window does not count toward any wallet’s balance. Resuming starts accrual again from the resume point. Pausing does not touch rewards that already accrued. Anything committed on-chain before the pause stays claimable, and LPs can still claim during a pause.

​

End a stream early

Ending a stream early stops accrual immediately. No further snapshots add to wallet balances after the end point. LPs keep access to rewards that were already committed on-chain. Ending early closes the campaign without taking anything away from depositors who earned during the active window. They can claim before or after you end it.

​

Recover unclaimed funds

After a stream ends, any reward tokens that LPs never claimed can be recovered by an authorized role. This returns leftover funds rather than leaving them stranded in the Stream contract.

​

How LPs claim

LPs claim on their own schedule. The backend commits a Merkle root of the latest snapshot on-chain (roughly every 12 hours), and a wallet submits a Merkle proof to receive its rewards. Claims are cumulative, so a single claim transaction always pays the full outstanding balance. Where that claim happens is up to you: on Turtle’s app, embedded on your own front end, or claimed automatically on the LP’s behalf. Claiming rewards compares the three paths. For the underlying proof endpoint and contract calls, see Get Merkle Proofs and Claim Rewards.

​

Next steps