> For the complete documentation index, see [llms.txt](https://stonkfun.gitbook.io/stonkfun-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stonkfun.gitbook.io/stonkfun-docs/launching/airdrop-mode.md). # Airdrop mode Airdrop mode holds part of a launch's supply out of the pool and distributes it to the top holders of the quote token you are pairing against. Reward launches only. Every field is optional, and omitting them gives you exactly the launch you would get without the feature. ## The carve-out | Setting | Value | | ----------------------- | ------------------------------ | | Maximum share of supply | 50% | | Per-wallet cap | 1.5% of the drop | | Tiers | `top100`, `top1000`, `top5000` | | Default tier | `top100` | At 50% the pool opens at the same market cap as always, because price comes from total supply rather than from what is seeded. But it opens with half the depth, so the same buy pressure moves it twice as far, and half the supply is circulating from block one. ## The snapshot is frozen before your mint is public This ordering is the whole point of the feature: ``` you request a quote ──► snapshot taken ──► sealed into the signed quote │ │ (your mint does not exist yet) ▼ you submit ──► mint, pool and escrow created atomically │ ▼ delivery ``` Nobody can see your new token and buy the quote token to get into the drop, and nothing afterwards can redirect it. ## Who gets removed from the ranking Exchange, custody and treasury wallets are removed, as is any account owned by a program, since a liquidity pool or vault cannot sign and tokens sent there are burnt in practice. Removals are backfilled by the next holder down, so you still receive the full tier you paid for. ## Tier availability A tier is refused if the quote token has fewer eligible holders than it names, rather than quietly delivering a smaller drop than you paid for. The launch page disables the tiers a given token cannot serve and snaps your selection down to the largest one it can. Tiers round down. A token with 1,200 holders offers `top100` and `top1000` but not `top5000`, because that tier would silently mean "everyone" while presenting itself as a choice. For very large tokens the ranking is taken from the first several thousand holders found rather than from a perfect ordering of every holder on the mint. The launch page tells you which case your selection is. ## How the drop is split Allocation is pro-rata by the recipient's quote-token balance, with a ceiling of 1.5% of the drop per wallet. Anyone over the ceiling is capped there, and what they give up is re-split among everyone still under it, repeatedly until nothing moves. The cap exists because straight pro-rata against a holder list hands a third of the drop to the three largest wallets, who are also the wallets most able to sell it straight back into a pool that was just seeded with less depth. Shares are always rounded down, so the allocations can never sum to more than the carve-out. ## Cost Airdrop fees are charged on top of the launch fee, in the same payment. The dominant cost is the token account each recipient needs, at roughly 0.00213 SOL each. At the largest tier that is around 10 SOL. The full figure is quoted to you before you sign, and you pay it, so the decision is yours. Turning the toggle on without taking a snapshot costs nothing. ## What it does to your pool The pool is seeded with less base token, so it is thinner. The starting market cap is unchanged, but a given buy moves the price further, including your own dev buy, whose cost is already adjusted for it when you are quoted. ## Delivery The carve-out is minted into escrow inside the same atomic bundle as the mint and the pool, so supply is committed the moment the token exists. Delivery itself lands shortly after, since hundreds of transfers cannot fit into one bundle. On a reward launch the drop pays the transfer tax exactly once, and the net amount is disclosed when you are quoted rather than being silently topped up. ## Over the API ```json { "mode": "reward", "airdropPercent": 20, "airdropTier": "top1000", "airdropSource": "quote-holders" } ``` The response carries an `airdrop` object with the recipient count and the extra fee, already included in `payment.lamports`. Read what a token launched with: ```bash curl 'https://www.stonkfun.xyz/api/public/v1/tokens//airdrop' ``` A token that launched without one answers `airdrop: null`, which is not an error. Most tokens have no airdrop. ## Availability Airdrop mode is optional and may not be offered. Where it is unavailable, the launch page shows no airdrop control and the API refuses the parameters rather than failing partway through a launch. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://stonkfun.gitbook.io/stonkfun-docs/launching/airdrop-mode.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.