API
Base URL: https://dustjar-production.up.railway.app. The read endpoints below need no key, because they expose only what is already public on chain and rate-limiting an address lookup protects nobody. A machine-readable description is at /v1/openapi.json.
What is live now
| Endpoint | What it answers |
|---|---|
| GET /v1/rent/minimums | Today's rent-exempt minimums by account size, and the surplus a token account made before September 2026 is holding. Read this rather than hardcoding: SIMD-0437 lowers it in phases. |
| GET /v1/wallet/{address}/reclaimable | What one wallet can reclaim: empty accounts, rent surplus, withdrawable stake, abandoned program buffers, as one total plus its parts. |
| GET /v1/leaderboard | Wallets ranked by SOL returned to their owners, with all-time totals. |
| GET /v1/wallet/{address}/claims | One wallet's claim history, each row naming a signature anyone can check. |
| POST /v1/sweep/plan | Unsigned, already-simulated transactions for the owner to sign. The server never signs. |
| POST /v1/sweep/send | Relay a signed transaction and wait for it to confirm. |
For agents
An MCP server is served at /mcp, speaking the JSON-RPC subset MCP clients need. It offers three tools: scan_wallet, rent_minimums and leaderboard.
Every MCP tool is read-only, deliberately. An agent can find out what a wallet is owed and report it. It cannot build, sign or send anything, because an agent that moves money on someone behalf is a different product with a different risk. Claiming always happens at dustjar.xyz, where the owner approves in their own wallet.
Still to come
- A single multi-chain endpoint returning every position across Solana and six EVM chains with a verdict for each.
- Self-serve keys and published rate limits. Their keys come from a Discord ticket; ours should take two minutes.
- Partner fee and referral parameters, so an integrator can take their own cut or pay a referrer.
What it will never do
- Accept a private key or a seed phrase, under any circumstance.
- Sign anything. The server holds no keys, which is why it can be safely embedded.
- Hold funds at any point.
The intended users are wallets, portfolio trackers and trading platforms that want cleanup built into their own product. If that is you, tell us what you need before we finish designing it.