Builder Program Overview

Third-party integrators — wallets, exchanges, DeFi apps, payroll providers — can embed Sweepster and earn revenue on every sweep they facilitate.

Get started — self-serve

Sign up yourself at dashboard.sweepster.xyz — no admin step:

1. Sign up — connect the wallet that will own your payout address, sign in with SIWE, and create a builder account (pick a name). You receive your API key once and land in the dashboard. Your payoutAddress is the connecting wallet's address.
2. Embed — pass your API key in the POST /quote request body (apiKey field), or sign the builder/builderFee fields on-chain.
3. Earn — the builderFee is skimmed atomically at settlement, exactly alongside the protocol fee. You keep 100% of your markup.

New builders start at zero commission (builderBps = 0). You can integrate and watch your dashboard immediately, but you earn a markup only once an admin raises your cap — contact Sweepster to request a markup. Self-service bps changes are not available.

See the Builder Dashboard guide for signup, earnings, and API-key rotation.

Key numbers

Setting	Description	Your control
builderBps	Your markup in basis points (1 bps = 0.01%)	Starts at 0; raised by Sweepster admin
maxBuilderBps	Hard cap on your markup	Set by Sweepster admin (0 at signup)
payoutAddress	Where accruals are paid out	The wallet you sign up with

Attribution modes

There are two ways to attribute a sweep to your builder account:

Mode	How	When to use
Off-chain API key	Pass apiKey in POST /quote body	API integrations, server-side orchestration
On-chain signed fields	Embed builder address + builderFee amount in the SweepOrder that the user signs	Maximum trustlessness; the fee is signed into the order

See Attribution for full details.

Payout modes

Mode	How	Settlement
On-chain atomic split	Builder fee is skimmed alongside protocol fee in the same tx	Instant; goes to payoutAddress
Off-chain accrual ledger	Fee is recorded by the orchestrator/watcher in the builder-backend ledger	Batch payout; builder claims via the payout flow

See Payouts for full details.

Example revenue

A builder with builderBps = 30 (0.30%) on a 1,000 USDC sweep:

amountIn:     1,000 USDC
Protocol fee:    5 USDC  (0.5% example)
Builder fee:     3 USDC  (0.30%)
Total skim:      8 USDC
User receives:  992 USDC at destination
Builder earns:   3 USDC

Getting started

• Builder Dashboard — self-serve signup, earnings, key rotation
• Quickstart — get an API key, first quote
• Attribution — on-chain vs off-chain
• Payouts — on-chain split vs accrual ledger
• Builder Backend API — /builders/self, /me/*, /attribute, /accruals