Stokerdevnet
Stoke a coin

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.

Request
curl https://api-devnet.stoker.markets/v1/platform
Answer
{
  "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, and ladder, the Creator Ladder in force and any announced for later: three tiers, each with the Active Days that reach it and its share of a pool creator fee collection, and activeDayFloorBps, 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 country as the edge read it (null when it could not) and the features withheld there, 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 category and, for a tokenized stock, its issuer (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), its liquidityUsd from 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. Its market is 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 than category=tokenized_stock), status, limit, offset, and fields, extra figures by name: fields=sparkline adds each Launch's sparkline, 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 its issuer, how many launches it has and their volume24h.
GET /launches/:mint
One Launch: its supply in raw units (1 trillion coins at 6 decimals; a coin launched on the earlier 1 billion keeps it), curve progress, Graduation (with its fee, the Graduation Fee and how much of it has been withheld, and creatorTier, the coin's place on the Creator Ladder: its tier, its activeDays, when the tier was recorded and the next tier with the Active Days it takes; null in a list), Reward Tax (with its payout asset, coin or quote), 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: its bps and locked, the transaction that gave the tax authority up after Graduation, null until then; null for any other coin, and a Stoke Launch's rewardTax is null), earningsDestination (where its Creator's earnings go, fixed at launch: wallet, holders, burn or liquidity; a coin launched without this API pays the wallet), creatorLock (the Creator Lock as the launch transaction set it: bps of the supply, the amount in raw units, cliffSeconds and unlockSeconds; null for a coin that locked nothing), market (price, marketCap, volume24h, change24h and change5m, the price change over the day and over five minutes as fractions, null until the first trade, and holders, 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, and copyOf when 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, and volume24h across 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 one interval (1m, 5m, 15m, 1h, 4h or 1d); with before (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 interval that start from from to to (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 its roles: the Creator, the snipers, the ten largest holders by their trades, the wallets known by an X account, and the wallet named in wallet; trades=all marks every trade and trades=none none, 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=false leaves them out. Pictures are served from /avatars/ on this API.
GET /launches/:mint/quote
A trade quote. side, amount, slippageBps, payWith (quote or sol), referrer. A buy paid with SOL on a coin paired with another asset carries route: the swap takes exactly solIn, the trade spends quoteOut (the least the swap may deliver, slippageBps.route under the current price), and about kept of 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, the curve's state, unlockStartsAt and unlockEndsAt (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: its amount, what has unlocked, what is claimed and what is claimable now, which is 0 before Graduation), stillLocked, and a Reward Launch's rewardTaxBps (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's payout asset. A round carries its source: tax, a Reward Launch's Reward Tax, or earnings, a Creator's earnings paid to their coin's holders in its Quote Asset. /launches/:mint/rewards lists a Reward Launch's tax rounds only; /rewards/rounds/:id answers any round, a standard coin's earnings round included, and each of a wallet's payouts names its round's source. The Holding Weight: each rules version carries its holdingWeights, the steps shortest first (afterDays and weightBps, 10000 being once; empty when every coin counts once), and the rules answer holdingDaySeconds, the length of the day a step counts (86400 on every public deployment). Every payout carries weightedHolding beside its holding (raw units times basis points), and a round its weightedTotal, so a payout is pot * weightedHolding / weightedTotal, rounded down; weightedTotal is 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, their total, and quote, the Quote Asset an addition's sale left over for the next); coinsAdded and quoteAdded, what every addition has put into the pool; and recent, the latest additions, newest first, each with its signature, coins, quote, locked position and time. 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/rewards answers 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 its checkedAt and slot; null for a coin that can have no Reward Round, which is never checked): lots, oldest first, each an amount, the since its coins' age runs from and the weightBps they count for now under the rules in force (rulesVersion); what they add up to (held), the wallet's weightedHolding and 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. flat is 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 destination and, in the coin's Quote Asset, what the platform has collected for the Creator on it, the Graduation Fee withheld out of that, what the rule has applied (paid out or spent, or committed to) and what is waiting for its next run, which comes once that is worth minLamports; waitsForGraduation is true while a liquidity coin has no pool yet. rounds are the latest ten earnings rounds of a holders coin, and buybacks the latest ten of a burn or liquidity coin: each with its transaction, its venue (curve or pool), its status (sending or landed) and, once landed, what it spent, the coins it bought and those it burned, or for liquidity what went into the pool, the LP tokens locked, the locked position and its Fee Key. totals count all that has landed. A coin that pays its Creator's wallet has no rule: applied and waiting are 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, its destination and, for a coin with a rule, what the rule has applied (null for a coin that pays the wallet), its tier on the Creator Ladder with its Active Days, and its graduationFee once 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: airdrop is 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). A creator_forward entry is a payment to a Creator, an arweave_top_up SOL sent to ArDrive Turbo for upload credits, a metadata_upload what one Launch's permanent metadata cost in those credits, in lamports, against its launch transaction, a reward_sale a Reward Launch's tax sold for its holders: the coins out and the Quote Asset in, two entries of one transaction, a holder_dividend a Creator's share paid to their coin's holders, one entry per payout transaction of an earnings round, a creator_burn or a creator_liquidity a 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 its asset, and a graduation_fee a 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's graduationFee on GET /revenue is the sum of them. A rebate is 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's rebates row. A burn_liquidity or a flywheel_liquidity is 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 its destination. A reward_liquidity is 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, burn or liquidity), 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's pool_fee entries and each coin's creatorTier, 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 on GET /platform as budgetTable.
GET /rebatesGET /wallets/:address/rebates
Volume Rebates: the Budget Table's rebates row paid back to traders, every amount in lamports. program is 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 its effectiveAt), 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, and current, the week being traded as it would be settled at this moment (its start and end, the Platform Fees paid so far and the pot; an estimate, and null while the row has no share). weeks are the settled weeks, the latest first: each with its capBps (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), the traders given 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, its status (waiting until the wallet's waiting rebates reach the minimum, sending while its payment is in flight, paid) and the payment's signature, which several weeks can share, beside what is waiting and paid in all and, under current, the fees its trades have paid this week and what they would earn now. Each payment is a rebate entry 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 but website must be on its own site, with or without www., m. or mobile. before the host: telegram on t.me or telegram.me, x on x.com or twitter.com, discord on discord.gg or discord.com, tiktok on tiktok.com, instagram on instagram.com, youtube on youtube.com or youtu.be; a link on any other host is refused with 400, its field named by the path of the one entry in details), image, and the launch modes firstBuy, airdrop, rewardTax and, with it, rewardPayout (coin or quote; coin unless set, refused with 400 without rewardTax) and rewardBurn, the Reward Burn (0, 1000, 2500 or 5000 basis points of every harvested tax, burned instead of paid out; 0 unless set, refused with 400 without rewardTax) and rewardLiquidity, the Reward Liquidity (the same steps, added to the coin's pool as locked liquidity once it graduates; 0 unless set, refused with 400 without rewardTax and when it and rewardBurn add up to more than 5000), or in place of those four liquidityTax (100 to 500 basis points in steps of 100, as rewardTax), 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 with rewardTax, rewardPayout, rewardBurn or rewardLiquidity, a 0 included, and with earningsDestination holders), and earningsDestination, where the Creator's earnings on the coin go for good (wallet, holders, burn or liquidity; wallet unless set, any coin may take any of them but a Stoke Launch, which may not take holders, 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's creatorLockCapBps), with lockCliffSeconds and lockUnlockSeconds, 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 without lockBps, or a lock past these limits, is refused with 400). An airdrop from a wallet the operator has not allowed is refused with 403. The mint address and the coin's metadataUri on 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), as POST /launches/check would have said.
POST /launches/check (multipart)
Copy Protection before the form is sent: name, symbol and image, each optional, and creator, whose own coins never count. Answers a verdict per field sent (free, taken with the protected coin and the sentence prepare would refuse with, or unchecked for an image the API can't read) and protectionSeconds, the window every launch gets.
GET /launch-quote
What a First Buy would get before anything is prepared: quoteMint, firstBuy, a Reward Launch's rewardTax or, in its place, a Stoke Launch's liquidityTax, and lockBps for a Creator Lock, whose coins come out of the sale, so the same buy gets fewer and the curve opens higher. rewardBurn and rewardLiquidity move no price and are refused with 400 as prepare refuses them, liquidityTax with 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's amount is what it takes out of the lock and received what 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. amount is in raw units of what is paid: the Quote Asset for a buy (lamports when payWith is sol), 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.

A buy, in JavaScript with web3.js
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 (details carries the validation issues, each with its path and message), 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; /rewards of a coin that is no Reward Launch; /airdrop or /lock of 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 (copy carries 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-after says 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-upload or mentions (the search of X for the coins that traded lately, which calls nothing until the owner sets its key); ?fail=simulated makes 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, roundThreshold and holdingWeights, 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 burn or liquidity, 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 optional name and avatarUrl (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_config transaction 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.