TL;DR
- Build a focused agent that solves one expensive, repetitive task — not a general assistant.
- Publish it to the Swarms Marketplace with
POST /api/add-agent(price it as a paid listing, not free). - Monetize through a sharp listing page — outcome-first copy, before/after examples, monthly pricing.
- Tokenize through
POST /api/token/launchso the agent has a Solana mint and you accrue creator fees. - Promote through three concrete channels (Twitter thread, free public demo, weekly subreddit posts) and pull earnings with
POST /api/product/claimfees.
Why Most Agents Never Earn a Dollar
Most agent builders ship code, not products. They write a great system prompt, get it working on their own data, push the repo, and then wait. There’s no listing page that explains the outcome in 10 seconds, no pricing, no demo a stranger can run without writing Python, and no distribution beyond a tweet at launch. The Swarms Marketplace handles the distribution layer — the discovery surface, the payments rail, the tokenized fee structure — but it can’t write your one-paragraph value prop or your before/after screenshots. That’s the product framing, and it’s what separates the listings that earn from the listings that don’t. The builders on the marketplace pulling real revenue all did the same boring thing: they treated the agent like a SaaS product and the listing page like a landing page.Meet Maya — A Working Example
Maya is a freelance ops consultant. Her clients send her quarterly P&Ls and operational spreadsheets that are uniformly disastrous — merged cells, inconsistent date formats, currency mixed with text, blank columns nobody remembers creating. She used to spend the first 90 minutes of every engagement just cleaning the file. Six months ago she built an agent for herself: feed it a messy CSV, it returns a clean, normalised CSV plus a summary of what it changed. She called it the Spreadsheet Cleaner Agent. A few of her clients saw it run, and three of them asked if they could just send her files directly and pay her to run them. That’s the moment most consultants either say yes (and trade their time for slightly more money) or shrug and move on. Maya wants the third option: turn the agent into recurring revenue without quitting consulting. She wants the agent to be a product strangers can buy, while she keeps the consulting practice running on the side. The rest of this guide walks Maya through exactly that — packaging the agent for the marketplace, publishing it via the Agents API, writing a listing page that actually converts, tokenizing it for ongoing creator fees, and the three marketing motions she’ll run for the next six months.Step 1: Package the Agent
Before anything ships to the marketplace, the agent has to be a clean object: a focused system prompt, an explicit model choice, a documented input shape, and a documented output shape. This is what Maya’s agent looks like as a deployable SwarmsAgent:
- The output format is strict and parseable. A buyer can pipe the result straight into a script. Free-form prose responses are not products.
- The model is
gpt-4.1-mini, notgpt-4.1. At a $19/mo subscription, margin matters. Mini handles structured cleanup well and keeps her unit economics healthy. - The system prompt has a refusal rule — “Never invent data” — which is exactly the kind of trust signal buyers screenshot and share.
Step 2: Publish to the Marketplace via the Agents API
The Swarms Marketplace lives athttps://swarms.world. The agent listing endpoint is POST /api/add-agent, authenticated with a bearer token. Maya’s first publish call looks like this:
category: "finance"— Maya picked the closest existing category. Listings in a known category get filtered traffic; listings innullget nothing.is_free: Falseandprice_usd: 19.00— paid from day one. You can always discount; you cannot easily flip a free agent to paid without losing the “thousands of free users” who never paid you anyway.useCases— three concrete, named scenarios. Buyers don’t read prose, they scan for the use case that matches them.seller_wallet_address— a Solana wallet she controls. Payouts and creator fees route here.
listing_url. Open it in a browser, scroll like a buyer would, and ask: would I pay $19/mo for this based on the page alone? If no, fix the page before you spend a dollar promoting it.
Full reference: Agents API.
Step 3: Write a Listing Page That Converts
The listing page is the one thing every paying user sees and most builders ignore. The conversion math is unforgiving — at a 2% conversion rate, every visitor you waste on a confusing page costs you compounding revenue. Four rules that the highest-earning listings on the marketplace all follow:- Lead with the outcome, not the technology. “Returns a cleaned CSV plus a change log” beats “Uses GPT-4o-mini with a structured output prompt to perform CSV normalisation.” Buyers don’t care what model you used.
- Show three concrete before/after examples. Use the inputs you saved from Step 1. A real screenshot of a messy spreadsheet next to the cleaned output is worth a thousand bullet points. Anonymise the data; keep the realism.
- Price as a monthly subscription, not per-call. Per-call pricing creates buyer anxiety (“will this run cost me $3 or $300?”). A flat monthly subscription anchors the value at the outcome (an ops consultant saves 6 hours per client per month — that’s $19 of obvious value). The marketplace’s subscription tier is launching shortly; price into it from day one.
- Under 200 words of copy. If a buyer can’t decide in 200 words, more words won’t fix it. Headline, three bullets of what you get, three before/after thumbnails, price, button.
Spreadsheet Cleaner Agent Upload any messy financial CSV. Get back a clean one in 30 seconds.Use theBuilt for ops consultants, bookkeepers, and finance teams who spend the first hour of every engagement fixing the file before the work can start. $19/month — unlimited cleanups.
- Normalised — dates in ISO 8601, currency in USD floats, snake_case columns
- Audited — every change is logged so you (or your client) can review it
- Flagged — suspected duplicates and ambiguous values are surfaced, never silently dropped
POST /api/edit-agent endpoint to iterate on the listing without re-creating it. Iterate weekly for the first month.
Step 4: Tokenize for Creator Fees via the Launchpad
The marketplace subscription is one revenue stream. Tokenizing the agent unlocks a second one: creator fees that accrue every time the agent’s token trades on its bonding curve. This is what separates the marketplace from every other agent directory — the agent itself becomes a Solana asset, and you, as the creator, keep a share of trading fees in perpetuity. The fastest path isPOST /api/token/launch, which creates the listing and the token in a single request. Maya already has the listing from Step 2 — for new agents, the Launchpad endpoint does both at once. Here’s the call:
- Token launch costs ~0.04 SOL. Fund the wallet associated with
private_keyfirst. - Creator fees vs. revenue fees are different things. Revenue fees are what the marketplace charges on subscription payments (5–15% depending on tier — see the Monetization Guide). Creator fees are what your agent’s token accrues from on-chain trading on the bonding curve. Both flow to you. You don’t have to choose one.
fee_selection: "frenzy"doubles the trading fees and puts your token on the Frenzy leaderboard, which is its own discovery surface. Use it if you have a marketing push planned for launch day; otherwise stick with"market".- Never put a real private key in source control. Use environment variables or a secret manager. The
private_keyis only used to sign the on-chain transaction.
Step 5: The Three Marketing Motions That Actually Work
The marketplace surfaces discovery; you still have to bring people to the listing. Out of the dozen things builders try, three actually move the needle. Run all three, weekly, for six months.(a) The before/after Twitter thread
Once a week, run the agent on a real (anonymised) file from a friend or a client. Post the input as the first image, the output as the second, the change log as the third. The thread is the proof — strangers see exactly what they’ll get. Pin the best one. The format that converts:(b) A free public demo page
This is the single highest-leverage thing you can build. A one-page web app where anyone can upload a small CSV and see the agent run — calling your marketplace agent under the hood. No login. No pricing wall. Just the agent doing the thing on their data.(c) One subreddit per week, with genuine commentary
Identify the three subreddits where your buyers actually hang out — for Maya, that’sr/bookkeeping, r/fpanda, and r/Accounting. Once a week, find a thread where someone is complaining about exactly the problem your agent solves, and reply with genuine help. Sometimes you mention the agent; sometimes you don’t. The point is to be a real participant, not a promoter. Marketplace listings linked from a comment that opens with “I built this for myself, happy to share how I clean these” convert ~10x better than the same listing linked from a top-level “check out my new tool” post.
Three motions, one hour per week each. The compounding is real but slow — most accounts that hit traction did six months of this before the curve bent.
Step 6: Track Revenue with the Claim Fees API
The marketplace handles subscription payments automatically. The token side — your creator fees from on-chain trading — accrues on-chain and is claimed on demand. ThePOST /api/product/claimfees endpoint returns both the claimed amount and a full breakdown of historical earnings, so you can use it as your dashboard query:
The Math at $10K MRR
Let’s be honest about what $10K MRR looks like from a pure-subscription perspective, before token fees are layered on top. At a $19/month subscription, you need ~526 paying users. That’s a real number, not a vanity number — and the funnel that gets you there is not magic:| Stage | Conversion | Required volume |
|---|---|---|
| Monthly subscribers needed | — | 526 |
| Trial-to-paid conversion | 25% | 2,100 trials/month |
| Listing visitors to trial | 10% | 21,000 visitors/month |
| Top-of-funnel impressions to visitor | ~5% | ~420,000 impressions/month |
| Or: direct visitor-to-paid | 2% | ~26,300 visitors/month |
POST /api/product/claimfees add a non-trivial second stream. The builders treating both streams as serious — subscription + creator fees — are the ones whose numbers get interesting.
$10K MRR in 3 months is unlikely. $10K MRR in 6–9 months for a builder running the playbook seriously is the realistic target.
Common Failure Modes
The list of ways this stops working, in rough order of frequency:- No listing-page polish. Default placeholder image, two-sentence description, no use cases. Buyers bounce in 4 seconds.
- Mispriced. Either listed as free (no one signals value with $0) or listed at $499/mo with no track record. Anchor at $19–49 and raise after you have testimonials.
- No demo video or public demo. Buyers can’t imagine the agent running on their data. They don’t buy.
- No public examples. No tweets, no thread, no screenshots in the wild. Discovery has nothing to grip onto.
- Promoting on the wrong subreddits. Generic AI subreddits drown signal in noise. Find the three subreddits where the buyer hangs out, not the three where other builders hang out.
- Building the agent for everyone. “AI assistant for productivity” never sells. “Cleans messy financial CSVs in 30 seconds” sells.
- Treating tokenization as a side experiment. It’s a second revenue stream. Claim fees weekly, post the lifetime totals, and let the on-chain proof do its own marketing.
Next Steps
- Launchpad: Tokenize Your Agent Tutorial — the four-step Launchpad walkthrough referenced in Step 4.
- Agents API — full reference for create, edit, and query endpoints.
- Tokenization Details — how the bonding curve, fees, and migration work under the hood.
- Marketplace Publishing Quickstart — the SDK-side
publish_to_marketplace=Trueflow if you’d rather publish from inside yourAgentdefinition. - Monetization Guide — eligibility, pricing tiers, and platform-fee math.
- Claim Fees API — the endpoint behind Step 6, with retry and async patterns.