Builder Dashboard
The builder dashboard at dashboard.sweepster.xyz is the self-serve home for integrators. Sign up, get an API key, watch your earnings, and rotate your key — all by signing in with your wallet. No admin step.
Self-signup
- Go to dashboard.sweepster.xyz.
- Connect the wallet that will own your payout address. (Your
payoutAddressis this wallet's address; it controls login.) - Sign in with SIWE (Sign-In With Ethereum, EIP-4361) — sign the login message in your wallet. This is off-chain and free.
- If the wallet isn't a builder yet, you'll see a "Create a builder account" form. Pick a display name and submit (one more SIWE signature).
- You receive your API key once — copy and store it now, it won't be shown again — then land in the dashboard.
That's it. No emails, no approval queue. The builder account is created with a deterministic id (bld_<your address>) and is owned by the wallet you signed up with.
Backed by the public
POST /builders/selfendpoint (SIWE-gated). Self-signup is gated by theSELF_SIGNUP_ENABLEDflag on the backend; if signup is closed you'll see a "contact Sweepster" message instead.
Zero commission to start
New builders are created at zero commission: builderBps = 0 and maxBuilderBps = 0. You can integrate, attribute sweeps, and view your dashboard immediately — but you earn a markup only once an admin raises your cap.
To earn a markup, contact Sweepster to request a higher maxBuilderBps. Markup changes are admin-set; the dashboard shows your config read-only (you cannot change builderBps or payoutAddress yourself).
What you can do in the dashboard
View your account
Your name and attribution config — builderBps, maxBuilderBps, and payoutAddress — shown read-only. (Powered by GET /me.)
View earnings
- Payable balances — per-token amounts currently owed to you (not yet paid out).
- Lifetime totals — per-token cumulative earnings.
- Per-sweep activity — a ledger of each attributed sweep (sweep id, token, amount, paid flag, timestamp).
(Powered by GET /me/accruals and GET /me/activity.)
Rotate your API key
Generate a fresh API key from the dashboard. The new key is shown once; the old key is immediately invalidated. Use this if a key is leaked or on a rotation schedule.
(Powered by POST /me/apikey/rotate.)
Sign-in vs. sign-up
- If your connecting wallet is already a builder's payout address, SIWE login drops you straight into the dashboard.
- If it isn't, you get the "Create a builder account" form (self-signup).
Sessions are delivered as an httpOnly, Secure, cross-subdomain cookie — the SPA never reads the token, so it's XSS-safe. All dashboard API calls authenticate via that cookie.
Related
- Builder Program Overview
- Attribution — how sweeps map to your account
- Payouts — how earnings are paid out
- Builder Backend API — the
/builders/self,/auth/*, and/me/*endpoints behind the dashboard