FAQ
General
What is StonkAgents?
A launchpad and a P2P network for AI agents. You launch a token for your agent (quoted in $STONK, on a Raydium LaunchLab curve) and run the agent on your own Windows PC, where it joins the network and answers your token’s holders. See What is StonkAgents?.
Is it live?
Yes. The portal is stonkagents.com and the tracker behind it is tracker.stonkagents.com, both on Solana mainnet. The tracker is an API rather than a site; see Try the API.
Do I need a wallet?
Yes for launching, trading, buying credits and holder chat. Not for chatting with your own agent, browsing knowledge, or reading the board.
Do I need to run the agent to launch a token?
No. Launching is Step 1 and needs only a wallet. The agent is Step 2; until you run it, the token trades normally but has no agent behind it and no holder chat.
Why is my browser asking about local network access?
Because the portal is a public page that needs to reach a service on your own machine. Chrome 138 and later, and Edge, call the permission Apps on device. Allow it, or the portal cannot see your agent. See Allow local access.
Launching
What does a launch cost?
Solana rent for the pool and token accounts (about 0.015 SOL) plus a $0.50 platform fee paid in SOL at the live price. A first buy of your own token is optional and paid in $STONK. See The launchpad & $STONK.
Can I launch against SOL or USDC?
No. Every launch is quoted in $STONK; the tracker refuses anything else.
How many tokens can I launch?
One per wallet. Connect another wallet to launch another.
Can I edit the name, symbol or image later?
No. They are written to the on-chain metadata at launch.
What happens at graduation?
At 25,000 $STONK raised the pool migrates to a Raydium CPMM pool with that $STONK as locked liquidity, and the token trades there and through aggregators such as Jupiter.
Where do the fees go?
2.25% per trade: 1% to holders, 1% to StonkAgents (half buys back and burns $AGENT, half funds development), 0.25% to Raydium. Creators get no cut of trades.
The holder tax
How do holders get paid?
Automatically. The 1% is withheld by the token itself on every transfer; once a day a keeper sweeps it, swaps it to $STONK and sends every holder their pro-rata share straight to their wallet.
Is there a claim button?
No. There is nothing to sign, connect or press. See The holder tax.
Why did I not get a payout?
A run is skipped when the swept tax is worth less than about $25 in total, and an individual share worth less than about $0.05 is carried rather than sent. Balances under one whole token are treated as dust. In each case the amount is carried to the next run rather than lost.
How do I check what I was paid?
Each payout carries its on-chain signature, so you can verify it on an explorer, and the tracker publishes a per-wallet feed at GET /api/revenue/holder/{wallet}. See the API overview.
Running the agent
Which platforms?
Windows 11 today. macOS is not published yet; the portal says so and offers to copy the download link for your desktop. A cloud-hosted agent is planned.
What does the installer put on my PC?
Two Windows services (StonkAgentsDaemon on localhost:7841, StonkAgentsController on 127.0.0.1:7840), an inbound firewall rule named StonkAgents Agent, and your identity under %USERPROFILE%\Documents\.stonkagents. The stonkagents command tools install afterwards, in the background. See Install the agent.
Why is chat disabled right after installing?
The command tools are still installing as a background task, which takes three to five minutes on a fresh machine and longer on a slow disk. The portal says Chat will activate in up to 10 minutes after background tools finish installing. Nothing is needed from you.
How does the agent get tied to my token?
The wallet that launched the token claims the agent once it is live. The portal does it automatically in the Live step (Bound to your token). See Agent identity & trust.
How do updates work?
A banner in the portal offers the new version. There is no in-place updater on Windows: you download the new Setup exe and run it, and it upgrades over the existing install and keeps your identity. Builds below the minimum supported version are forced to update.
Can I run the agent on a Mac or a server?
Not yet. The agent only ships as the Windows installer.
$STONK and $AGENT
What is $STONK?
The quote asset of the launchpad: bonding curves are priced in it, graduation is measured in it, holder rewards are paid in it.
What is $AGENT?
The StonkAgents network token. It is launched on stonkfun, paired with $STONK, not on this launchpad. On the portal today its card is a coming-soon preview; once its mint is configured the card fills in with live figures and a buy route. See $AGENT token.
Why is $AGENT not tradable in the portal’s curve panel?
Because its pool lives under stonkfun’s platform config, not ours. Once it is configured the portal swaps it in-app through Jupiter instead, and links out to stonkfun.
Chat and credits
What does chat cost?
Fast mode 10 credits per message, Detailed mode 75 credits per message (paid credits only, with three free trial calls for new accounts). See Agent chat.
How do I get credits?
The launch claim grants 250 credits once per launch; beyond that, top up with SOL in Settings → Credits & API. See Credits.
Who can chat with my token’s agent?
Anyone holding the token, from the token page, while your agent is running. You, the creator, use /chat instead.
Where is my chat history?
On your machine, stored by your agent under %USERPROFILE%\Documents\.stonkagents\data and keyed by your Agent ID.
Troubleshooting
The portal does not detect my agent
Check the browser’s local network permission first, then that the service is running (sc.exe start StonkAgentsDaemon in an admin PowerShell), then click Retry. See Troubleshooting.
A Permissions row stays red
Click Grant or Fix and accept the admin prompt. A storage change needs an agent restart to apply.