The API
Everything this site shows is read from the API, and everything it does is a transaction the API prepared and a wallet signed. Reads are open: no key, no signup. A launch or a trade comes back unsigned, for your wallet to sign, so nothing is ever custodied. A bot, a terminal or a script uses the same endpoints and gets the same transactions.
Quickstart
The base URL is https://api-devnet.stoker.markets/v1. Every body is JSON, and every amount a raw integer as a decimal string. The answer below came from the API for this page view.
curl https://api-devnet.stoker.markets/v1/platform
{
"cluster": "devnet",
"rpcUrl": "https://api.devnet.solana.com",
"launchlabProgram": "DRay6fNdQ5J82H7xV6uq2aV3mNrUZ1J4PgSKsWgptcm6",
"platformConfig": "J8wXws7sKpbSEDEQHmJPCS3XSqbDKQR7UPhAmyZ5oPCQ",
"graduationTargetLamports": "85000000000",
"graduationFeeLamports": "15000000",
"platformFeeBps": 100,
"creatorFeeBps": 0,
"poolCreatorFeeBps": 25,
"poolCreatorFeeShareBps": 0,
"raydiumFee": {
"curveBps": 25,
"poolBps": 25,
"poolLpShareBps": 8400
},
"creatorForward": {
"shareBps": 5000,
"curveBps": 50,
"poolBps": 12.5,
"minLamports": "1000000",
"ladder": {
"inForce": {
"version": 1,
"tiers": [
{
"tier": 1,
"activeDays": 0,
"shareBps": 5000
},
{
"tier": 2,
"activeDays": 15,
"shareBps": 6000
},
{
"tier": 3,
"activeDays": 30,
"shareBps": 7000
}
],
"activeDayFloorBps": 100,
"note": "first ladder",
"announcedAt": "2026-11-10T05:46:52.056Z",
"effectiveAt": "2026-11-10T05:46:52.056Z"
},
"upcoming": []
}
},
"budgetTable": {
"inForce": {
"version": 1,
"shares": {
"burn": 6000,
"flywheel": 500,
"rebates": 0,
"referrals": 0,
"integrators": 0,
"treasury": 3500
},
"note": "first table",
"announcedAt": "2026-11-09T11:27:13.568Z",
"effectiveAt": "2026-11-09T11:27:13.568Z"
},
"upcoming": []
},
"referralShareBps": 50,
"solRoute": null,
"solRouteToleranceBps": 30
}Reading, no key needed
Every read is open. Everything the site shows comes from these, in this order: the platform, the assets, the coins, what holders and Creators earn, and the platform's own books.
GET /platform- The cluster, an RPC for browsers, the program and PlatformConfig addresses, the Graduation Target in lamports, and every fee as the chain has it now: the Platform Fee and Creator Fee on the curve (
platformFeeBps,creatorFeeBps, the latter 0 on this platform), the pool's creator fee (poolCreatorFeeBps) with the share of it Raydium keeps at collection (poolCreatorFeeShareBps), Raydium's own fee on each venue (raydiumFee), the share of the pool trade fee its liquidity providers keep (raydiumFee.poolLpShareBps, which reaches the platform through the Fee Key), the referral share rate,creatorForward: the Creator's share of what the platform collects on their coin's trades on the first tier (shareBps), also as basis points of curve and pool volume, with its minimum, andladder, the Creator Ladder in force and any announced for later: threetiers, each with the Active Days that reach it and its share of a pool creator fee collection, andactiveDayFloorBps, the part of a coin's Graduation Target its pool must trade in a UTC day for the day to count; the Graduation Fee in lamports (graduationFeeLamports, ADR 0015), and the route's slippage limit for buys paid with SOL (solRouteToleranceBps). The site's Fees page is drawn from this answer. GET /region- The region gate: the visitor's
countryas the edge read it (null when it could not) and the featureswithheldthere, from a table the operator keeps per feature; empty until a feature is withheld somewhere. The answer is one visitor's own and never cached, so ask it from the browser, not a server. GET /quotesGET /quotes/:mint- The Quote Registry: every Quote Asset with its
categoryand, for a tokenized stock, itsissuer(from the mint's address and authorities and the token list's tags, never a name), its price, Graduation Target, whether it can be launched against, whether a referral share fee applies on it,creatorLockCapBps, the largest Creator Lock a launch paired with it may have in basis points of the supply (2000, a fifth, where Raydium's GlobalConfig leaves room, less where it doesn't, 0 where none is allowed), itsliquidityUsdfrom the token list (null when the list doesn't know the mint; SOL comes first, then what can be launched against, the deepest markets first), and its Quote Risk Labels (labels:kind,severity,title,detail,source; null until the Quote Registry refresh has checked the mint, an empty list when there is nothing to flag). Labels come from the mint's authorities and Token-2022 extensions and from the token list; they inform and never block. Itsmarketis the market behind it as TradingView names it (symbol,venue,ticker: the stock or fund a tokenized stock tracks, from its issuer and ticker, or a coin's own market, from its mint; null when none is known), which the asset's page charts. GET /launches- The board.
sort(new,trending,market_cap,graduation),q(a search: a name or ticker containing it in any case, or a mint address starting with it; up to 64 characters),quote,category(sol,stablecoin,tokenized_stock,rwa,wrapped,defi,leveraged,collectible,meme,community),issuer(xstocks,prestocks,tessera,backpack: the stock issuer of the Quote Asset, finer thancategory=tokenized_stock),status,limit,offset, andfields, extra figures by name:fields=sparklineadds each Launch'ssparkline, its price over the last 24 hours as 24 points an hour apart in the Quote Asset, the latest last and equal to the price now, an empty list for a coin nobody has traded (the board's cards draw it). GET /launches/quotes- The Quote Assets that have Launches, for filters; each with its
category, for a tokenized stock itsissuer, how manylaunchesit has and theirvolume24h. GET /launches/:mint- One Launch: its
supplyin raw units (1 trillion coins at 6 decimals; a coin launched on the earlier 1 billion keeps it), curve progress, Graduation (with itsfee, the Graduation Fee and how much of it has been withheld, andcreatorTier, the coin's place on the Creator Ladder: itstier, itsactiveDays, when the tier was recorded and thenexttier with the Active Days it takes; null in a list), Reward Tax (with itspayoutasset,coinorquote),liquidityTax(a Stoke Launch's Stoke Tax, all of it added to the coin's pool as locked liquidity, with holders paid nothing from it: itsbpsandlocked, the transaction that gave the tax authority up after Graduation, null until then; null for any other coin, and a Stoke Launch'srewardTaxis null),earningsDestination(where its Creator's earnings go, fixed at launch:wallet,holders,burnorliquidity; a coin launched without this API pays the wallet),creatorLock(the Creator Lock as the launch transaction set it:bpsof the supply, theamountin raw units,cliffSecondsandunlockSeconds; null for a coin that locked nothing), market (price,marketCap,volume24h,change24handchange5m, the price change over the day and over five minutes as fractions, null until the first trade, andholders, the wallets whose indexed buys exceed their sells (never the platform's operations wallet, which burns or locks what it buys for a Creator), a floor on the chain's count), Copy Protection (protection.until, andcopyOfwhen the coin took an earlier coin's name, ticker or image). GET /stats- The platform's figures:
since(when the first coin launched),launches,graduated, andvolume24hacross every coin in SOL and USD at the Quote Registry's latest prices. GET /launches/:mint/tradesGET /launches/:mint/candles?interval=GET /launches/:mint/holders- Indexed trades (with any referral fee paid), price candles, and the top holders read from the chain. Candles come newest last, up to
limit(500 at most) of oneinterval(1m,5m,15m,1h,4hor1d); withbefore(Unix seconds) only those that start before it, to page back through a coin's history. GET /launches/:mint/trust- The coin's trust figures, computed from the indexed trades and launches on every request so anyone can recompute them (ADR 0013).
creator: how many coins the Creator launched here and how many graduated, and their First Buy in the launch transaction.snipers, Bundle Radar: every wallet but the Creator and the platform's operations wallet that bought in the Snipe Window (windowSlots, the launch's slot and five after it deployed), largest buy first, each with the slot it landed in after the launch's, what it bought and what it holds by its trades since, and how many others paid exactly the same amount; the totals as shares of the supply, and how many wallets landed in the launch's own slot or matched another's amount. A label informs; none stops a trade. GET /launches/:mint/marks?interval=&from=&to=- The marks on the coin's chart, on the candles of one
intervalthat start fromfromtoto(Unix seconds).trades: one mark per wallet, side and candle, with how many trades it stands for, what they bought or sold and paid, the market cap right after the last of them, and the wallet's picture. By default (trades=key) only the key wallets', each with itsroles: the Creator, the snipers, the ten largest holders by their trades, the wallets known by an X account, and the wallet named inwallet;trades=allmarks every trade andtrades=nonenone, ten at most a candle, the key wallets first.mentions: the posts on X that named the coin, each on the candle it falls in, with its author, its text, a link to it and the market cap when it was posted;mentions=falseleaves them out. Pictures are served from/avatars/on this API. GET /launches/:mint/quote- A trade quote.
side,amount,slippageBps,payWith(quoteorsol),referrer. A buy paid with SOL on a coin paired with another asset carriesroute: the swap takes exactlysolIn, the trade spendsquoteOut(the least the swap may deliver,slippageBps.routeunder the current price), and aboutkeptof the Quote Asset stays in the trader's wallet. GET /launches/:mint/airdrop- An Airdrop's recipients and which are paid.
GET /launches/:mint/lock- A coin's Creator Lock read from the chain: its
terms, thecurve's state,unlockStartsAtandunlockEndsAt(null until the curve sells out, since the clock starts at the buy that sells it out),asOf, the chain's time the figures are counted at, the Creator's share (creatorShare: itsamount, what hasunlocked, what isclaimedand what isclaimablenow, which is 0 before Graduation),stillLocked, and a Reward Launch'srewardTaxBps(or a Stoke Launch's tax, under the same name), which a claim pays like any transfer. 404 for a coin without a lock. GET /launches/:mint/rewardsGET /rewards/rulesGET /rewards/rounds/:idGET /wallets/:address/rewards- Holder Rewards: the Payout Asset, tax waiting, the pot, the rules in force and announced, every round, a wallet's payouts; for a Quote Asset payout also the Reward Sales (
sales: the bounds, totals, and the latest sales with their transactions); the Reward Burn (burn: its share, what it has burned and the latest burns) and the Reward Liquidity (liquidity: its share, the coins and Quote Asset kept for the pool and not added yet, what every addition has added, and the latest additions with their locked positions). Amounts of a pot or payout are in the round'spayoutasset. A round carries itssource:tax, a Reward Launch's Reward Tax, orearnings, a Creator's earnings paid to their coin's holders in its Quote Asset./launches/:mint/rewardslists a Reward Launch's tax rounds only;/rewards/rounds/:idanswers any round, a standard coin's earnings round included, and each of a wallet's payouts names its round'ssource. The Holding Weight: each rules version carries itsholdingWeights, the steps shortest first (afterDaysandweightBps, 10000 being once; empty when every coin counts once), and the rules answerholdingDaySeconds, the length of the day a step counts (86400 on every public deployment). Every payout carriesweightedHoldingbeside itsholding(raw units times basis points), and a round itsweightedTotal, so a payout ispot * weightedHolding / weightedTotal, rounded down;weightedTotalis null for a round from before the Holding Weight, whose payouts are pro rata of their holdings. GET /launches/:mint/liquidity-tax- A Stoke Launch's Stoke Tax:
taxBps; what waits for the coin's pool, read from the chain (waiting:inAccounts, withheld in holders' accounts,inMint, harvested to the mint,kept, withdrawn to the tax's own account, where it waits for Graduation and for enough to be worth a locked position, theirtotal, andquote, the Quote Asset an addition's sale left over for the next);coinsAddedandquoteAdded, what every addition has put into the pool; andrecent, the latest additions, newest first, each with itssignature,coins,quote, lockedpositionandtime. Amounts are raw units. The whole tax goes to the pool, so the coin has no Reward Round, Payout Asset or Reward Sale:/launches/:mint/rewardsanswers 404 for it, and this answers 404 for any other coin. GET /launches/:mint/holdings/:wallet- One wallet's Holding Lots of a coin, as the coin's latest Holding Check left them (
check, with itscheckedAtandslot; null for a coin that can have no Reward Round, which is never checked):lots, oldest first, each anamount, thesinceits coins' age runs from and theweightBpsthey count for now under the rules in force (rulesVersion); what they add up to (held), the wallet'sweightedHoldingand its weight as one figure (weightBps, 10000 with no lots). Balances are read once in a Holding Day, so coins bought since the last check are in no lot yet and count once.flatis true for the treasury, whose coins always count once. The lots are as they are now, never as they were at a past round, whose own page carries the result. GET /launches/:mint/earnings- Where one coin's Creator Earnings go and what has become of them: its
destinationand, in the coin's Quote Asset, what the platform hascollectedfor the Creator on it, the Graduation Feewithheldout of that, what the rule hasapplied(paid out or spent, or committed to) and what iswaitingfor its next run, which comes once that is worthminLamports;waitsForGraduationis true while aliquiditycoin has no pool yet.roundsare the latest ten earnings rounds of aholderscoin, andbuybacksthe latest ten of aburnorliquiditycoin: each with its transaction, itsvenue(curveorpool), itsstatus(sendingorlanded) and, once landed, what itspent, thecoinsit bought and those itburned, or forliquiditywhat went into the pool, the LP tokens locked, the locked position and its Fee Key.totalscount all that has landed. A coin that pays its Creator's wallet has no rule:appliedandwaitingare null and both lists empty. The rule is applied by the platform's Creator Forward job, not by a program, and every action is on the Ledger. GET /creators/:address/earningsGET /creators/:address/forwards- Creator Earnings: per Quote Asset what the Creator's Launches earned (their share of what the platform collected on their trades: half, and more of a graduated coin's pool fees by its tier), what Graduation Fees kept of it (
withheld), what was forwarded to their wallet, what went to the rules of the coins they pointed elsewhere instead (toRule) and what is still pending; per Launch what its curve and pool earned, itsdestinationand, for a coin with a rule, what the rule hasapplied(null for a coin that pays the wallet), itstieron the Creator Ladder with its Active Days, and itsgraduationFeeonce it has graduated (the fee in lamports, what has been withheld toward it in the Quote Asset and its worth, and when it was settled); and every forward with its transaction. Nothing to claim. GET /creators/:address/launch-permissions- What the launch form offers this wallet:
airdropis true only for wallets the operator has allowed. GET /revenueGET /ledger- Platform revenue per asset and per day, with what of it has left for Creators (forwarded to their wallets, or paid out or spent by their coins' rules) and what is still owed them, and the Ledger page by page (
kind,limit,before). Acreator_forwardentry is a payment to a Creator, anarweave_top_upSOL sent to ArDrive Turbo for upload credits, ametadata_uploadwhat one Launch's permanent metadata cost in those credits, in lamports, against its launch transaction, areward_salea Reward Launch's tax sold for its holders: the coins out and the Quote Asset in, two entries of one transaction, aholder_dividenda Creator's share paid to their coin's holders, one entry per payout transaction of an earnings round, acreator_burnor acreator_liquiditya Creator's share spent on a buyback that burns what it buys or adds it to the pool as locked liquidity, two entries of one transaction: the Quote Asset spent, then the coins burned or added, the second with the coin itself as itsasset, and agraduation_feea Graduation Fee (ADR 0015) withheld from a Creator's share in the coin's Quote Asset, keyed by the graduation transaction from event index 1000 up; nothing moves, so it is never added to a total, and each asset'sgraduationFeeonGET /revenueis the sum of them. Arebateis a trader's Volume Rebates paid in SOL from the operations wallet, one entry per wallet a payment transaction paid, and the spending of the Budget Table'srebatesrow. Aburn_liquidityor aflywheel_liquidityis the Burn's or the Flywheel's budget added to a coin's pool as locked liquidity instead of burned, two entries of one transaction: the SOL that went into the pool, then the coins, with the locked position as itsdestination. Areward_liquidityis a Reward Launch's Reward Liquidity added to its pool, up to three entries of one transaction: the coins its sale took into the pool (index 0), then the coins and the Quote Asset that went into the locked position (indexes 1 and 2); the holders' tax, never revenue. A Stoke Launch's additions are recorded the same way: its whole tax, which is the pool's and never revenue. GET /burns- Burn and Flywheel: shares, where each budget's buys go (
destinations,burnorliquidity), rule, budgets, picks, every buy and burn, and the protocol-owned liquidity they added (liquidity). GET /creator-ladder- The Creator Ladder: every version with its three tiers (the Active Days that reach each and its share of a pool creator fee collection, in basis points), the floor of an Active Day and the time the version takes effect, and which is
inForce. A coin's tier is recorded by the Fee Collector before it collects, a collection is shared at the tier the coin held when it landed under the version then in force, and a tier never falls: with the Ledger'spool_feeentries and each coin'screatorTier, enough to redo any Creator's share. GET /budgets- The Budget Table: what the platform keeps after the Creators' share (
netLamports, valued in SOL at the latest prices), every version of the table with its shares in basis points and the time it takes effect, and each row's allotment, spending and remainder. A version's shares apply to what Ledger entries collected while it was in force, so the allotments can be redone from the Ledger and the versions alone. The version in force and any announced for later are also onGET /platformasbudgetTable. GET /rebatesGET /wallets/:address/rebates- Volume Rebates: the Budget Table's
rebatesrow paid back to traders, every amount in lamports.programis how it stands: the row's share in force (shareBps, 0 while it is not running, when no trade earns), the next announced version that changes it (upcoming, with itseffectiveAt), the length of a Rebate Week (weekSeconds: 604800, a UTC week from Monday 00:00), what a wallet's waiting rebates must reach to be paid (minPayoutLamports), everything paid and everything still waiting, andcurrent, the week being traded as it would be settled at this moment (itsstartandend, the Platform Fees paid so far and the pot; an estimate, and null while the row has no share).weeksare the settled weeks, the latest first: each with itscapBps(the largest share the row had in force during it), the budget the row had left, the Platform Fees the week's trades paid, valued in SOL at the settlement's prices, the pot it split (the budget, or the cap's share of the fees where that is less), thetradersgiven a rebate, what they were credited and how much of it has been paid. A week is split in proportion to the fees each wallet's trades paid, on the curve and in the pool, buys and sells; the platform's own wallets earn nothing. A wallet's read lists its rebate for each settled week, with the fees it paid, itsstatus(waitinguntil the wallet's waiting rebates reach the minimum,sendingwhile its payment is in flight,paid) and the payment'ssignature, which several weeks can share, beside what is waiting and paid in all and, undercurrent, the fees its trades have paid this week and what they would earn now. Each payment is arebateentry on the Ledger. GET /announcements- Every announced Platform Fee or Creator Fee change, with the transaction that applied it once it has.
GET /metadata/:mint.jsonGET /metadata/:mint/image- A coin's metadata JSON and image as the platform's own cache serves them. The address on the chain is the Arweave one, where both are posted once the launch is indexed; this copy answers under the platform's domain meanwhile and after.
GET /health- Outside
/v1. Answers only when the deployment's configuration is valid, so a misconfigured deploy never looks ready.
Preparing transactions
Each returns an unsigned transaction (base64) for the user's wallet to sign and send, with its lastValidBlockHeight. Nothing is custodied: the API never holds a key of yours, and a transaction it prepares does only what its endpoint says.
POST /launches/prepare (multipart)POST /launches/:mint/prepare- A launch:
creator,quoteMint,name,symbol,description,website,x,telegram,discord,tiktok,instagram,youtube(each an optional web address over https or http, of up to 200 characters; every one butwebsitemust be on its own site, with or withoutwww.,m.ormobile.before the host:telegramon t.me or telegram.me,xon x.com or twitter.com,discordon discord.gg or discord.com,tiktokon tiktok.com,instagramon instagram.com,youtubeon youtube.com or youtu.be; a link on any other host is refused with 400, its field named by thepathof the one entry indetails),image, and the launch modesfirstBuy,airdrop,rewardTaxand, with it,rewardPayout(coinorquote;coinunless set, refused with 400 withoutrewardTax) andrewardBurn, the Reward Burn (0,1000,2500or5000basis points of every harvested tax, burned instead of paid out;0unless set, refused with 400 withoutrewardTax) andrewardLiquidity, the Reward Liquidity (the same steps, added to the coin's pool as locked liquidity once it graduates;0unless set, refused with 400 withoutrewardTaxand when it andrewardBurnadd up to more than5000), or in place of those fourliquidityTax(100to500basis points in steps of 100, asrewardTax), which makes the coin a Stoke Launch: the whole tax is added to the coin's pool as locked liquidity once it graduates, and holders are paid nothing from it (refused with 400 together withrewardTax,rewardPayout,rewardBurnorrewardLiquidity, a0included, and withearningsDestinationholders), andearningsDestination, where the Creator's earnings on the coin go for good (wallet,holders,burnorliquidity;walletunless set, any coin may take any of them but a Stoke Launch, which may not takeholders, and any other value is refused with 400), and a Creator Lock:lockBps, the share of the supply kept back from the sale for the Creator's wallet (up to the Quote Asset'screatorLockCapBps), withlockCliffSecondsandlockUnlockSeconds, the time after the curve sells out before anything unlocks and the time it then unlocks evenly over (each 0 unless set; together at least 7 days, each at most four years; a schedule withoutlockBps, or a lock past these limits, is refused with 400). Anairdropfrom a wallet the operator has not allowed is refused with 403. The mint address and the coin'smetadataUrion Arweave are fixed at first prepare; the second form rebuilds the same launch for a retry, so a retry never mints a second coin. The image and metadata JSON are uploaded to Arweave once the launch is indexed; until then the URI answers 404. A name, ticker or image that a coin launched inside its Copy Protection window already has is refused with 409 and the verdict (copy), asPOST /launches/checkwould have said. POST /launches/check (multipart)- Copy Protection before the form is sent:
name,symbolandimage, each optional, andcreator, whose own coins never count. Answers a verdict per field sent (free,takenwith the protected coin and the sentence prepare would refuse with, oruncheckedfor an image the API can't read) andprotectionSeconds, the window every launch gets. GET /launch-quote- What a First Buy would get before anything is prepared:
quoteMint,firstBuy, a Reward Launch'srewardTaxor, in its place, a Stoke Launch'sliquidityTax, andlockBpsfor a Creator Lock, whose coins come out of the sale, so the same buy gets fewer and the curve opens higher.rewardBurnandrewardLiquiditymove no price and are refused with 400 as prepare refuses them,liquidityTaxwith any of the three included, so a form can say so first. POST /launches/:mint/airdrop/prepare- The Creator's airdrop payments, however many transactions they take.
POST /launches/:mint/lock/claim- The claim of what has unlocked of a Creator Lock, for the wallet holding the share (
wallet) to sign and pay for; the answer'samountis what it takes out of the lock andreceivedwhat reaches the wallet after a Reward Launch's Reward Tax. Refused with 403 for a wallet with no share, and with 409 before Graduation, while the cliff runs (details.unlockStartsAt) or when nothing new has unlocked. POST /trades/prepare- A buy or sell, on the curve or in the pool:
mint,trader,side,amount,slippageBps,payWith,referrer.amountis in raw units of what is paid: the Quote Asset for a buy (lamports whenpayWithissol), the coin for a sell. POST /transactions/:signature- Reports a confirmed transaction so it shows up at once, without waiting for the webhook.
Sign, send, report
The same three steps for a launch, a trade or an airdrop: deserialize the transaction, sign it with the wallet it was prepared for, send it to the chain, then report its signature so it shows up at once rather than when the webhook delivers it. A launch transaction already carries the new mint's signature; the Creator's wallet signs as fee payer. In a browser a Wallet Standard wallet signs with signTransaction, and the rest is the same.
import { Connection, VersionedTransaction } from "@solana/web3.js";
const api = "https://api.stoker.markets/v1";
const prepared = await (await fetch(`${api}/trades/prepare`, {
method: "POST",
headers: { "content-type": "application/json" },
body: JSON.stringify({ mint, trader: wallet.publicKey.toBase58(), side: "buy", amount: "100000000", slippageBps: 100 }),
})).json();
const tx = VersionedTransaction.deserialize(Buffer.from(prepared.transaction, "base64"));
tx.sign([wallet]);
const connection = new Connection(rpcUrl, "confirmed"); // your own RPC, or rpcUrl from GET /platform
const signature = await connection.sendTransaction(tx);
await connection.confirmTransaction({ signature, blockhash: tx.message.recentBlockhash, lastValidBlockHeight: prepared.lastValidBlockHeight }, "confirmed");
await fetch(`${api}/transactions/${signature}`, { method: "POST" });Referrals
A trade prepared with referrer pays that wallet LaunchLab's share fee, on-chain, in the Quote Asset, at 0.5% (REFERRAL_SHARE_BPS, 50), where the Quote Asset's GlobalConfig allows a share fee (referralShare on GET /quotes; SOL's allows up to 1%, most others, every tokenized stock among them, allow none). The quote says whether it applies and what it pays (referral), the trade records it (referral on each trade), and the referrer's Quote Asset account is opened by the trader if it doesn't exist. A trader can't refer themselves, and a pool trade after Graduation pays no referral fee. The web app takes the referrer from ?ref=<wallet> on a coin page.
API keys and limits
Reads are open, and a caller without a key is bounded per IP address: 300 requests a minute, and 25 prepare requests a minute, answered past the limit with 429 and retry-after. The Helius webhook and the operator's endpoints are not counted. A key identifies an integrator, meters its usage and bounds it: send it in x-api-key on every request. Past the key's per-minute limit (60 unless the operator set another) the API answers 429 with retry-after; an unknown or revoked key is refused with 401. GET /keys/me shows the key's limit and its last hour of usage by minute, and stays reachable past the limit.
Keys are issued by hand: write to info@stoker.markets with what you are building and the rate you need. The operator issues them from the /operator page or directly: POST /operator/api-keys (name, rateLimitPerMinute, 60 by default) answers with the key once and never again; GET /operator/api-keys lists them without the key; DELETE /operator/api-keys/:id revokes one.
Errors
An error answers { "error": "<one sentence>" }, with the status that says what kind it is.
400- The body or query isn't what the contract asks (
detailscarries the validation issues, each with itspathandmessage), an address that isn't a wallet address, a mint that is no Quote Asset, or a launch mode that can't be set up as given. 401- An unknown or revoked key in
x-api-key; the operator's endpoints without their token. 403- A launch with an airdrop from a wallet the operator hasn't allowed one; a Creator Lock claim from a wallet with no share of the lock.
404- No such coin, Quote Asset, round or key;
/rewardsof a coin that is no Reward Launch;/airdropor/lockof a coin launched without one; a reported transaction not found or not confirmed yet. 409- A launch whose name, ticker or image a coin inside its Copy Protection window already has (
copycarries the verdict); a retry of a coin that has already launched (details.mint); an airdrop that can't be sent right now: every wallet paid, the coin not launched yet, or transactions handed out a moment ago that can still land (details.retryAfterSeconds); a Creator Lock claim before Graduation, while the cliff runs or with nothing new unlocked; a pool Raydium has paused or that opens in a moment; a fee or rules change announced with too short a lead. 422- Well-formed, but not as asked: a Quote Asset the curve rules don't admit at today's price, or a buy paid with SOL where no route exists or none fits one transaction.
429- Past a rate limit;
retry-aftersays how many seconds to wait. 500503- Ours: an internal error, or a dependency down for the moment (the price source, the SOL route, reading holders or a Creator Lock from the chain). Try again in a minute.
The operator's endpoints
Behind Authorization: Bearer <OPERATOR_TOKEN>. Listed so what the operator can do is public; nothing here moves a user's funds.
GET /operator/overview- Launches by status, rounds, burns, Launches with their metadata on Arweave and still waiting (
metadataUploads), the latest run of each job, open alerts, the fees on-chain. GET /operator/alerts- Alerts: a stuck Graduation, a Reward Tax left unlocked, a failed job, a stalled Reward Round; each resolved when its cause goes away.
GET /operator/jobs?job=- Job runs and unsettled job transactions.
POST /operator/jobs/:job- Runs a job now:
quote-registry,fee-collector,creator-forward,rebates(settles every Rebate Week that has ended and pays the wallets whose rebates reach the minimum),reward-rounds,burn,metadata-uploadormentions(the search of X for the coins that traded lately, which calls nothing until the owner sets its key);?fail=simulatedmakes it fail on purpose to see the alert path. POST /operator/rewards/rules- Announces the next version of the Reward Round rules, effective no sooner than the announced lead ahead (never under a minute). A version states every rule:
minHolding,roundThresholdandholdingWeights, the Holding Weight's steps (at most six, each after more days and heavier than the one before, none above five times), named every time, the empty list included. PUT /operator/platform-token- Names the Platform Token the Burn buys.
PUT /operator/budget-destinations- Points the Burn's or the Flywheel's budget at
burnorliquidity, from the next run. POST /operator/creator-ladder- Announces the next version of the Creator Ladder: the second and the top tier's share and Active Days (both climbing from the first tier's half) and the floor of an Active Day, effective no sooner than a fee change's lead ahead and after every earlier version. A coin keeps every tier it has already reached.
POST /operator/budget-table- Announces the next version of the Budget Table: every row's share (summing to 10000 basis points), effective no sooner than a fee change's lead ahead and after every earlier version.
GET /operator/notable-walletsPOST /operator/notable-walletsDELETE /operator/notable-wallets/:wallet- The wallets known by an X account, whose trades the chart marks with the account's handle and picture:
wallet,handle, an optionalnameandavatarUrl(a picture copied once, under 1 MB). A post replaces what is known of a wallet. GET /operator/airdrop-creatorsPOST /operator/airdrop-creatorsDELETE /operator/airdrop-creators/:wallet- The Creator wallets allowed an airdrop at launch (
wallet). The list starts empty, so nobody is offered one until the operator names a wallet. GET /operator/mint-keysPOST /operator/mint-keysDELETE /operator/mint-keys/:mint- Mint keys chosen for a Creator wallet's next launch (
creator,secretKey: a keypair file's 64 bytes), kept encrypted; the list says which a draft has taken, never the secret. A taken key can't be removed; a stored address that is already a coin or draft here is refused. POST /operator/fees/announcePOST /operator/fees/prepare- Announces a Platform Fee or Creator Fee change, effective no sooner than a day ahead on mainnet, and once due prepares the
update_platform_configtransaction for the cold admin key. The Indexer marks the announcement applied when the change lands. POST /operator/api-keysGET /operator/api-keysDELETE /operator/api-keys/:id- See API keys and limits.