QuackTool guide & FAQ

01 Quick start

Connect your wallet. Connect wallet at the top right. You sign a text message — it is not a transaction, costs nothing and gives nobody access to your funds.
Get a plan. Plans are paid with redeem points: get points on the Redeem page, then pick a plan on Plans.
Open the bot. Launch bot on the home page. The first time it shows a short warning — read it, it is the same text as Risks and responsibility below.
Add your OpenSea API key. Tab Settings → OpenSea API key → Save & check. Without it you see ranks only — no prices, no buying, no monitors.
Scan a collection. Paste the contract address (0x…) and press Scan — the network (Ethereum or Robinhood) is found by itself. One scan costs 1 Quacktoken.
To buy through the bot: create a new, separate wallet, put a small amount on it, and save its private key in Settings → Bot wallet. Start with one quick buy (the Buy button) of something cheap before you switch on auto-buy.

Never give the bot the key of your main wallet. A bot wallet should hold only what you are ready to spend.

02 Plans, points, Quacktokens, fuel

There are three different «currencies» on the site. They are easy to mix up:

What	Where it comes from	What it pays for
Redeem points 🪙	The Redeem page: you send an accepted NFT, the points arrive by themselves within a few minutes	Plans
Quacktokens 🦆	Your plan, every day at 00:00 New York time	Scans: 1 Quacktoken per scan
Fuel ⛽	You pour Quacktokens into it: 1 Quacktoken = 10 fuel	Running monitors

Redeem points

The Redeem page shows the address to send to, the network and which NFTs are accepted. Send the NFT from the wallet you log in with — the points are credited to the account of the sender. Your balance is always in the top bar.

Redeem is not open yet. It will be announced when it opens — do not send NFTs anywhere before that.

Plans

Plan	Price	Lasts	Quacktokens a day	Includes
Basic	1 point	7 days	10	Collection scans, rankings and filters
Premium	5 points	7 days	20	Collection scans, rankings and filters · Quick buy (the Buy button) · Reveal monitoring and auto-scan · Offers on unlisted NFTs (Top-N in one click)
Quack Mod coming soon	15 points	7 days	30	Collection scans, rankings and filters · Quick buy (the Buy button) · Reveal monitoring and auto-scan · Auto-buy (the bot buys by itself) · Offers on unlisted NFTs (Top-N in one click)

The same plan again — its days are added to the end of the current one.
A more expensive plan — any time: the unused part of your current plan is counted towards the price.
A cheaper plan — can be bought when the current one ends.
A plan with a lock («Coming soon») is not on sale yet.
Auto-renew (a tick on the Plans page) extends your plan by itself shortly before it ends, if you have enough redeem points.
When a plan ends, its features switch off at once: monitors and auto-buy stop. Settings and keys stay saved.

Quacktokens

Every scan you start costs 1 Quacktoken: a new scan, a result that was ready at once, joining a scan that is already running, a rescan.
The scan the bot starts by itself after a reveal costs 1 Quacktoken.
A scan that finds nothing (wrong address, empty collection) gives the Quacktoken back — up to 10 times a day.
They refill at 00:00 New York time; the timer next to them on the bot page counts down. Unused Quacktokens do not add up.

Fuel

Monitors work while there is fuel. Pour Quacktokens into it on the Monitors tab (Refuel): 1 Quacktoken = 10 fuel.

Right now monitors burn no fuel — monitoring is free. If that changes, the prices will be here and on the fuel card of the bot page.

Fuel is burned by the minute, not by whole hours.
Unused fuel burns at the daily reset (00:00 New York), together with the new Quacktokens.
Autorefuel pours 1 Quacktoken when the fuel runs out — but never your last one: it is kept for the scan after a reveal.
No fuel and nothing to refuel with → the monitors stop. Start them again yourself.

03 The bot page

Top line

Is the bot online, your plan, Quacktokens and the time to the refill, fuel, the balance of the bot wallet.

Command bar

The network of the collection (found by itself), contract address, then: Scan, Watch reveal, Stop (■), Refresh, Reset (the broom). Under it — progress, how many tokens are loaded and listed, the floor.

Tabs

Results, Traits, Live, Monitors, Auto-buy, Settings, History.

Activity

On the right: what your bot is doing and what happened — scans, reveals, buys, warnings. If something did not happen, the reason is written here.

Every setting has a small ⓘ next to it — point at it for an explanation.
Settings are saved by themselves when you leave a field. A red ⚠ marks settings where a wrong value can cost money; a risky value turns red and says why.
A 🔒 means the feature belongs to another plan. Click it to see the plans.
Stop stops your current scan and auto-buy. Reset only clears the results on the page — settings and monitors are not touched.

04 Scanning and ranks

A scan loads every token of the collection, reads its traits and puts all tokens in order of rarity. With your OpenSea key it also shows who is listed and for how much.

How the rank is counted

A trait counts the more, the fewer tokens have it.
The number of traits a token has counts as a trait too (7 traits where everybody has 5 is rare).
A token with a trait nobody else has — a true 1/1 — always goes to the very top.
Rank 1 is the rarest. Trait classes by the share of tokens that have the trait: Unique < 1% Mythic < 3% Rare < 8% Uncommon < 15% Common.

Some collections are random — there the rank means little. In some collections the traits are scattered at random: lots of traits that only one or two tokens have. Then almost every token looks like a 1/1, and «rank 1» is just the token that collected the most of those one-offs. That is not a mistake of the bot — any rarity tool, OpenSea's too, gets the same picture, because the collection is made that way. Before you buy by rank — with auto-buy (Top-N, Top of the listed), the Buy button or on OpenSea — open the Traits tab. If most traits are held by 1–2 tokens, do not trust the top: buy by the traits you know are valued (super keywords, combo words) or skip the collection.

The ranks you see DURING a scan are not the real ones. The bot loads the listed tokens first and shows their ranks at once, so you see something early. But they are counted only from what is loaded so far: a token that is #1 at that moment can be #500 when the whole collection is in. While that is the case, a red box «NOT THE REAL RANKS YET» stands above the results, the ranks have a «~» in front, and every Buy asks again. Wait until the box disappears — then the ranks are final. Auto-buy by rank waits for the real ranks by itself.

Why the listed tokens come first — and what you can use meanwhile

At a reveal everybody races for the same few listed tokens, and only listed tokens can be bought at all. So the bot first asks OpenSea what is listed and downloads those tokens before the rest of the collection. That gives you the buyable tokens seconds earlier:

Super keywords already work. A listed token with a word from your list («1/1», «one of one»…) is bought the moment its data arrives — it does not need the rank. (The single-trait rule starts after a few tokens have loaded.)
Traits and prices are real. What a token has and what it costs do not change while the rest loads. If you see a listed token whose trait speaks for itself — «1/1», «Legendary», a trait you know is rare in this collection — and the price is fine for you, buying it by eye is your call.
Not real yet: the rank number, the «~» ranks in the table, the trait percentages and classes (Unique / Mythic…), the «rarest first» order, Top-5 listed. They are counted from the listed tokens only.
Auto-buy by rank (Top-N) starts only when the real ranks are there.

Not sure? Wait the few seconds until the red box disappears — then everything on the page is final.

When the collection's data is messy

Ranks are counted from the data the collection publishes. Many collections have broken or inconsistent metadata — missing traits, duplicates, files that do not match the tokens. The bot counts exactly what is there, so on such a collection its ranks can differ from OpenSea's. That comes from the collection, not from the bot: check a couple of tokens by eye before buying expensive ones.

When not everything loads

If the collection's server is slow, a scan may finish with a part of the tokens. A line above the results says «loaded X of Y». The bot keeps loading the rest in the background for up to two hours and recounts the ranks each time.

Refresh (free) shows what has arrived and — if Refresh also re-checks listings is on — reloads the OpenSea prices. It does not start the scan over.
Ranks of a partly loaded collection can still move. The top auto-buy does not run below 90% loaded.
«⚡ instant» next to the floor means the result was already stored — somebody scanned this collection recently.

Scan or Refresh? Refresh — to see what changed in the collection you have open. Scan — to start over (it costs 1 Quacktoken and starts a new round of your auto-buy limits).

05 Results, Traits, Live

Results

All tokens by rank. Each row: rank, token, score, its traits (the rarest first), price.
While the scan runs the ranks have a «~» and a red box stands above them: they are not final (see above).
Search by number or name, Listed only, a max price, sorting by rarity / price / id.
Click a row for the token card: traits with their share, Buy, a link to OpenSea.
Top-5 listed opens the five rarest listed tokens on OpenSea in new tabs (allow pop-ups for the site).

Traits

Every trait of the collection: how many tokens have it, its class, how many are listed and the cheapest listing. Click a trait to see only its tokens. Priority keywords (Settings) highlight traits with your words — «legendary», «gold» — and show them on top. They only highlight; they never buy anything.

Live

Listed tokens noticed during the scan, newest first.

06 Keys and the bot wallet

OpenSea API key — needed for prices and buying

It is free: you get it from OpenSea (docs.opensea.io).
Settings → OpenSea API key → paste → Save & check. The line above the field says whether OpenSea accepted it.
Listings and buy orders are requested with your key, within OpenSea's limits for it.
Without it the bot still scans, ranks and runs monitors (at a reveal it scans and shows the ranks) — but shows no prices and buys nothing: neither quick buy nor auto-buy.

Bot wallet — needed only to buy

Create a new wallet just for the bot. Put on it what you are ready to spend: the currency of the collection (ETH or USDG) plus ETH for gas.
Settings → Bot wallet → paste its private key → Save key. From then on you see only the address; Balance reads the balance from the chain.
Robinhood and Ethereum are different networks: the same wallet needs funds on the one you buy on.

How keys are kept. Encrypted. After saving, a key is never shown again — not to you and not in the admin. Remove deletes it. The bot cannot work on the site without keeping them: it signs your purchases with the wallet key and asks OpenSea with your API key.

07 Buying and gas

Quick buy — the Buy button

Quick buy is when you press Buy. Auto-buy (section 09) is when the bot buys by itself by your rules. Both use the bot wallet and your OpenSea key.

Press Buy in a row of the results or on the token card.
With Ask before buying on, a window shows the price and the most you may pay.
The bot asks OpenSea for the order, checks that it is the token and the price you saw, signs with the bot wallet and sends the transaction.
Activity shows «Bought #…» with a link; the purchase appears in History.

Quick buy: max price rise, % — if the seller raised the price after you clicked, the bot still buys up to this much more (default 5%). A lower price is always bought. Auto-buy does not use this number — it has its own limits.

Buy speed (gas)

Every transaction pays gas. Its price has two parts: the network's own price, the same for everybody, and your tip. On Ethereum, buys with a bigger tip go first in the block.

Speed	Tip on Ethereum, at least	For
Economy	0.1 gwei	Quiet collections; may be late at a busy reveal
Fast	3 gwei	The usual choice
Very fast	25 gwei	Hot reveals — a race with other snipers
Custom	your number	You type the tip, the bot counts the rest

The table under the buttons shows, for each network, the gas right now, your tip and what one buy costs in ETH and dollars. The buttons show the cost on the network of the collection you work with.
A tip of 1 gwei is about 0.0002 ETH per buy (a buy burns about 200 000 gas).
On Robinhood a tip does not buy a place in the queue: the first transaction to arrive wins.
Keep ETH free for gas. A transaction sets aside its whole gas limit (800 000) while it is sent; what is not burned stays in the wallet. The line under the table says how much to keep.
Gas is paid for every buy that reaches the network — also for one that fails there because somebody was faster.

The gas war at a reveal

At a hot reveal several snipers want the same token. On Ethereum a block comes every 12 seconds, so everybody who reacted within those seconds lands in the same block — being faster by a second no longer helps. Inside the block the transactions are lined up by tip: the biggest tip goes first. The first one buys the token; for everybody behind it the token is gone, their transaction fails («reverted») and still pays for the gas it used.

A real case: the bot sent 5 buys 3–6 seconds after a reveal — all in the very next block, in time. The winners paid a tip of 16–21 gwei and stood in places 19–29 of the block; our 9 gwei stood in places 207–211, so the tokens were gone. Each lost buy cost about $1 of gas; each winning buy cost its buyer about $8–10.
A lost buy costs less than a won one. A buy that fails stops at the first check and burns ~55 000 gas instead of ~200 000. So «$1 of gas at 9 gwei» is right: the fee is the gas price × the gas really used.
Flashbots (Ethereum) sends the buy privately to the block builders. A transaction that would fail is simply not included — a lost race costs no gas at all. It may sometimes get in a block later than a public one.
On Robinhood there is no tip auction: the transaction that arrives first wins, so only speed matters there (see below).
When a buy is lost this way, Activity says who got the token, the tips and places in the block, and links both transactions.

The race on Robinhood

Robinhood does not sort a block by tip: the sequencer puts transactions in the order they arrive. A bigger tip changes nothing there — the one who sends first buys the token. A lost buy still fails («reverted»), but gas on Robinhood costs a fraction of a cent.

What decides the speed: how fast the bot notices the reveal (the same moment for everybody on the site), how fast your token is downloaded (listed ones go first) and how fast OpenSea answers the request for your order — that last one varies from about 0.1 to almost 1 second and usually decides who is first.
Keep the bot wallet topped up with ETH for gas: a buy that cannot pay its gas is not sent at all.

When several QuackTool users want the same NFT

Everybody on the site gets the same data at the same moment: the collection is downloaded once for all of you, nobody sees the reveal or the listings earlier than the others.
Each of you buys with your own OpenSea key and your own bot wallet. The bot does not hold anybody back and nobody can pay the site to go first.
So it is a fair race: the first transaction to get in buys the token, the others fail. On Ethereum the bigger tip wins (the gas war above), on Robinhood the earlier one — mostly whoever's OpenSea answer came back faster.
Activity tells the loser who got the token, with links to both transactions.

Check it yourself on Etherscan. Open the transaction and compare with the winner's: Block (the same number = you were in time), Gas Price and, under «Click to show more», Gas Fees → Max Priority (the tip) and Position In Block (the place). Transaction Fee is what the gas cost. The small sums in Internal Transfers are the creator's royalty and the OpenSea fee taken from the NFT's price — not gas.

If a buy does not go through

«somebody bought it first or the listing was removed» — nothing was sent, nothing was spent.
«the price changed» — it rose above your limit; nothing was sent.
Failed on the blockchain — the transaction got in but the token was gone: the gas of that transaction is spent, the price is not. Usually another buyer stood ahead in the same block (the gas war).
Sent but not confirmed — a transaction that has not got into a block for 45 seconds on Ethereum (20 on other networks) is replaced by your next purchase from the same wallet. You do not need to wait or restart anything.
«not enough funds» — price plus gas does not fit the bot wallet; auto-buy stops for that reveal until you top it up.

Flashbots (Ethereum only) sends the purchase privately, so other bots cannot see it waiting and jump ahead of it. USDG collections: before each buy the bot sends an approval for exactly the price — one more small transaction.

💸 Offers (Premium and Quack)

An offer is a bid on an NFT that is not listed: «I pay this much for #123». The bot wallet signs it and OpenSea shows it to the owner, exactly like an offer made on OpenSea itself.

Offer — on any unlisted token: in the Results table (where Buy would be) or in the token card.
Offer Top-5 — above the results: exactly ranks 1–5 (or 1–3, 1–10). A token among them that is listed is marked with its price — keep it (an offer under the listing price is normal) or drop it with ×. One amount and one duration (1 hour … 30 days) for all of them, one click.
No gas. Nothing is sent to the blockchain. The money leaves the bot wallet only if an owner accepts — then the NFT comes to the bot wallet. The fees (OpenSea, creator) are paid by the seller out of your offer: you pay exactly what you offered.
What it is paid in: WETH on Ethereum, Robinhood's own WETH on Robinhood, USDG in USDG collections. ETH cannot be offered directly — Wrap it into WETH in the Offers tab (1 ETH = 1 WETH, Unwrap turns it back). Each is one small transaction.
Once per currency the wallet has to allow OpenSea to use it («Allow WETH» — one small transaction). After that every offer is free.
One amount of WETH can back several offers. If more owners accept than the wallet can pay, the extra sales simply fail — nothing is lost.
The Offers tab lists your offers with their end time. Cancel one or all — free and at once.

Wait for the full scan before «Offer Top-5»: while it runs the ranks are not real yet (why). In random collections the rank means little — look at the traits. Try your first offer with a tiny amount.

08 Reveal monitor

For a collection that is minted but still shows the same placeholder for every token. The bot waits, and the moment the real traits appear it starts the scan — and your auto-buy, if your plan has it — by itself.

If monitors cost fuel on this site: pour some on the Monitors tab (or turn on Autorefuel). The fuel card shows whether monitors cost anything right now.
Paste the address and press Watch reveal (the network is found by itself).
The collection appears in the Reveal monitor list. You can close the page — the bot keeps waiting.
At the reveal: «REVEAL!» in Activity, a sound and a browser notification (if you allowed them), then the scan.

The scan after a reveal costs 1 Quacktoken. With none left the reveal is noticed but not scanned — keep one.
How many collections you can wait for at once depends on your plan.
No OpenSea key? The monitor still works: at the reveal the bot scans and shows the ranks — but without prices, so nothing is bought (neither auto-buy nor quick buy).
Pressing Watch reveal again on a collection you already wait for changes nothing — the bot says so.
Set up and test your auto-buy before the reveal: at the reveal there is no time.
A reveal the project announces on the blockchain is noticed at once; a silent one within a couple of seconds (see How fast does the bot notice a reveal? below).

09 Auto-buy

Auto-buy = the bot buys by itself, you press nothing (pressing Buy yourself is quick buy). The bot buys by your rules — from the bot wallet, with your OpenSea key, within the limits of Protection. There are two rules and one price mode.

Buying by rank only makes sense where the rank means something. In random collections (lots of traits only one token has) switch Top-N / Top of the listed off and buy by keywords.

Super keywords — bought at once, during the scan

A token is bought the moment it is loaded if the name or the value of one of its traits contains one of your words.
Whole words only: «gold» finds «Gold Crown» but not «Golden»; «1/1» finds «Type: 1/1» but not «11/12». Upper and lower case do not matter.
Also buy single-trait tokens — tokens with only one trait while the rest of the collection has more (often the 1 of 1 pieces).
Max price — the most the bot pays for one such token, separately for ETH and USDG.
Group 2 — a second list of words with its own price, for traits that are worth less (or more). For example: group 1 «1/1, one of one» up to floor + 500%, group 2 «mythic, divine» up to floor + 150%. It has its own switch, its own max prices and its own percent in the Floor + % mode — and its own number of buys per reveal (Group 2 buys / reveal, counted separately from group 1). The spend cap is shared. A token that fits both groups goes by the higher price; if that group's buys are used up, by the other group (when the price fits).
Combo words — a separate card: the token is bought only when it has all the words of one combo. «mythic + gold» buys a token with a «Mythic» trait and a «Gold» trait (or both words in one trait), but not one that has only one of them. Words of a combo are joined by «+», one combo per line; up to 10 combos of 2–4 words. Combos have their own max prices, their own percent in the Floor + % mode and their own number of buys per reveal (Combo buys / reveal).

A keyword matches the name of a trait too. With the word «muse» the bot buys every token of a collection where each token has a trait called «Patron Muse». Choose words that appear only on the rare tokens, and use Exclusion words for values like «None».

Top-N rarest — bought after the scan

Buy from top — how many of the rarest tokens to look at.
From those, the listed ones that fit your Max price are bought, strictly from the top down.
Runs only when enough of the collection is loaded (90% by default) — otherwise the «top» may not be the top.

Top of the listed — bought at once, without the rest

The listed tokens are downloaded first. As soon as they are in, the bot ranks them among themselves and buys the rarest of them that fit your price — it does not wait for the rest of the collection. Much faster than Top-N, but the ranks are approximate.
Own settings: how many of the top of the listed, max price (or its own «floor + %»), its own number of buys per reveal.
The protection of the top, counted among the listed: too many of them look unrevealed → nothing is bought; placeholders are never bought; tied ranks are skipped; at least 90% of the listed tokens must be downloaded.

Price mode: Floor + %

Not a third rule — it changes how much the two rules may pay. On: the fixed max prices are not used; the limit is counted from the floor (the cheapest listing of the collection).

Three rank tiers, each with its own percent and its own switch: ranks 1–19, 20–49, 50–100. «Floor + 300%» with a floor of 0.01 means: up to 0.04.
Super keywords get their own percent — each keyword group its own.
Never pay more than — a ceiling whatever the floor gives. With one or two listings the «floor» can be any number; set this.

What else to know

Auto-buy NFTs loaded later (Settings → Buying) — tokens that load in the background after the scan, and listings found by Refresh, also go through your rules. Off by default: ranks of a partly loaded collection can still change.
A scan you started (or a reveal you waited for) starts a new round of your limits. Somebody else's scan of the same collection never buys for you.
A token is not bought twice. Activity says what was bought and what was skipped, and why.

10 Protection

Always on — you only set its limits (Auto-buy tab: the number of buys per reveal is in each rule's own card — Super keywords, Group 2, Combo words, Top-N, Top of the listed; the rest is in the card Protection). Zero means «no limit» for the counters and caps, so think before typing 0.

Setting	What it does	Default
Super buys / reveal	At most this many super-keyword (group 1) and single-trait buys per reveal	2
Group 2 buys / reveal	At most this many buys of super keywords group 2 per reveal (separate count)	1
Combo buys / reveal	At most this many buys by combo words per reveal (separate count)	1
Top buys / reveal	At most this many top buys per reveal	5
Spend cap / reveal	The bot stops buying once it has spent this much on one reveal (ETH and USDG separately)	0 — off
Stop if unrevealed ≥ %	If this share of the first tokens still looks like the placeholder, the reveal is not finished — the top is not bought (super keyword buys go on: each token is checked by its own traits)	10%
Top: min. loaded %	The top is bought only when this much of the collection is loaded	90%
No top buys when ranks are tied	If more than «A tie is more than %» of the collection has exactly the same rarity as a token, its rank is just a place in a tie — it is not bought by the top	on, 10%
Exclusion words	The matched trait also contains one of these → not bought («1/1: None» is skipped, «1/1: Gold» is bought)	none
Blacklist	A token with one of these words in its name or traits is never bought	unrevealed, not revealed, pre-reveal, placeholder, coming soon

And without any setting:

3 buys in a row failed on the blockchain → auto-buy stops for that collection (it may block transfers). A new scan lifts it.
Not enough funds → auto-buy stops for that reveal.
The bot buys only for ETH and USDG; a listing in another currency is skipped.
An order from OpenSea that is not exactly «this token, to your wallet, for this price» is not signed.

11 History and alerts

History — everything the bot bought or tried to buy for you, with links to the transactions. «Rank then → now» shows the rank at the moment of purchase and the rank now: when more of a collection loads, ranks can move.
Sound and browser notifications on a reveal and on every purchase (Settings → Alerts). Click anywhere on the page once so the browser allows sound.
Activity keeps the last messages, also from the time the page was closed.

! Risks and responsibility

This is the text you confirm the first time you open the bot.

Your settings, your purchases
The bot buys exactly what your settings tell it to buy. We are not responsible for purchases made because of wrong or careless settings — including NFTs you did not want or paid too much for.
Some features need your keys — stored encrypted
You can scan, see ranks and run monitors without any keys. Buying — quick buy (the Buy button) and auto-buy (the bot buys by itself) — needs two of them: the private key of a separate bot wallet and your OpenSea API key. They are stored encrypted, are used only for your own scans and purchases, and are never shown again. Put on the bot wallet only what you are ready to spend.
Some collections have messy data
Ranks are counted honestly from the data the collection itself publishes. Many collections have broken or inconsistent metadata — missing traits, duplicates, files that do not match the tokens. Then the ranks can differ from OpenSea's: that comes from the collection, not from the bot. Check a couple of tokens by eye before you buy expensive ones.
Use it with care
The bot works well, but like any software it can hit a hiccup now and then — most often on a collection with broken data, a slow network or OpenSea. Start small and keep an eye on it; you use it at your own risk.

What that means in practice

Test every new setting with a small amount: a spend cap you can afford and a limit of 1 buy.
Wait for the full scan before buying by rank. The ranks shown while the scan runs (the red «NOT THE REAL RANKS YET» box) are counted from the listed tokens only and will change.
Ranks are a calculation from the data that could be loaded. A partly loaded, half-revealed or messy collection gives ranks that differ from OpenSea's.
Some collections are random: traits scattered so that almost every token has a one-off trait. There the top is noise — check the Traits tab before buying by rank (more).
A reveal is a race. Another buyer can be faster; a buy that loses the race costs gas.
OpenSea, the network or this site can be slow or down at the worst moment.

? FAQ

Getting started

What does QuackTool do, in one sentence?

It loads a whole NFT collection, ranks every token by rarity, shows who is listed on OpenSea and for how much — and, if you let it, buys the rare cheap ones for you the moment a collection reveals.

What do I need to start?

A wallet to log in with, a plan (paid with redeem points), and your own free OpenSea API key. To buy through the bot you also need a separate bot wallet with some funds on it. See Quick start.

Is connecting my wallet safe? Does logging in cost anything?

Logging in is a signature of a text message — not a transaction. It costs nothing and gives nobody access to your funds. The message names this site and your address; if a site with another address asks you to sign it, do not.

I cannot log in from my phone. What do I do?

A normal phone browser (Chrome, Safari) has no wallet inside, so the site cannot ask for a signature there. Open the site in the browser built into your wallet app instead: tap Connect wallet and pick MetaMask, Coinbase, Trust or OKX — the site opens in that app and the login starts by itself. Rabby: tap Open in Rabby — it copies the link; open the Rabby app, its built-in browser, paste the link, and the login starts by itself. Another wallet? Same way: its built-in browser (Browser / Explore / DApps) → paste the site address. On a computer: install the MetaMask or Rabby extension.

Why two wallets — the one I log in with and a «bot wallet»?

The wallet you log in with only proves who you are; the bot never touches it. Purchases are signed by the bot wallet, whose private key you give to the bot. Make it a new, separate wallet and keep on it only what you are ready to spend.

Can I use the bot without an OpenSea API key?

Yes: scans, ranks and monitors work without it — at a reveal the bot scans and shows the ranks. Prices and buying need your own key — both quick buy (you press Buy) and auto-buy (the bot buys by itself): listings and buy orders are requested with it. The key is free — see Keys and the bot wallet.

Quick buy and auto-buy — what is the difference?

Quick buy: you press Buy in the results or on a token card — the bot buys that one token for you at once. Auto-buy: you set rules (keywords, top-N, price limits) and the bot buys by itself, without you pressing anything — also right after a reveal. Both buy from your bot wallet and need your OpenSea key. Which plan has which — see the plans table.

Plans, points, Quacktokens

Redeem points, Quacktokens, fuel — what is the difference?

Redeem points pay for plans; you get them on the Redeem page. Quacktokens come with the plan every day and pay for scans. Fuel is what running monitors burn; you make it from Quacktokens. See the table.

What does a scan cost?

1 Quacktoken — for a new scan, for a result that was ready at once, for joining a scan that is already running and for a rescan. The scan the bot starts by itself after a reveal costs 1 Quacktoken. If a scan finds nothing (wrong address, empty collection), the Quacktoken comes back — up to 10 times a day.

When do Quacktokens refill?

Every day at 00:00 New York time, for everybody at the same moment. The timer next to your Quacktokens on the bot page shows how long is left. Unused fuel burns at that same moment.

How do I get redeem points?

Open the Redeem page: it shows the address, the network and which NFTs are accepted. Send the NFT from the wallet you log in with — that is how the points find your account. They arrive by themselves within a few minutes.

A plan has a lock and says «Coming soon». Why?

That plan is not on sale yet. Its features are shown on the bot page with a lock, so you can see what is coming.

Can I switch to another plan before mine ends?

To a more expensive one — yes, any time: the unused part of your current plan is counted towards the price. A cheaper one can be bought when the current plan ends. Buying the same plan again adds its days to the end of the current one.

What happens when my plan ends?

The features of the plan switch off at once: monitors and auto-buy stop. Your settings and keys stay saved. With «auto-renew» ticked on the Plans page, the plan is extended by itself if you have enough redeem points.

Scanning and ranks

How is the rank calculated?

Every trait counts the more, the fewer tokens have it; the number of traits a token has counts as a trait too. A token with a trait nobody else has (a true 1/1) always goes to the very top. Rank 1 is the rarest.

The ranks changed while the scan was running. Why?

While a scan runs, the page shows the ranks of what is loaded so far — and the listed tokens are loaded first. Those ranks are not real: a token that is #1 at that moment can be #500 when the whole collection is in. The red «NOT THE REAL RANKS YET» box above the results says so; when it disappears, the ranks are final. Do not buy by preliminary ranks. Every Buy click asks again while they are shown. Auto-buy by rank waits for the real ranks by itself; super keywords do not depend on ranks.

Why are the listed tokens shown first? Can I use them before the scan ends?

At a reveal only listed tokens can be bought, and everybody races for them — so the bot loads them before the rest of the collection. Meanwhile super keywords already buy (they do not need the rank), and the traits and prices you see are real: if a listed token's trait speaks for itself («1/1», «Legendary») and the price suits you, buying it by eye is your call. What is not real yet: the rank, the trait percentages and classes, the «rarest first» order and Top-5 — they are counted from the listed tokens only. Auto-buy by rank waits for the full scan. More.

The rank here differs from OpenSea or another site. Which one is right?

Our ranks are counted honestly from the data the collection itself publishes. Small differences between rarity sites are normal. A big difference usually has one of two reasons: the collection was not loaded completely (look at the «loaded X of Y» line and press Refresh later), or the collection's own data is messy — missing traits, duplicates, files that do not match the tokens. Many collections are like that; then every site shows something different, and that comes from the collection, not from the bot.

The scan loaded only a part of the collection. What now?

The bot keeps loading the missing tokens in the background for up to two hours, gently, and recounts the ranks every time. Refresh shows what has arrived. Until everything is loaded the ranks can still move — the top auto-buy does not run at all below 90% loaded (you can change that number).

Why was a scan ready instantly?

Somebody scanned that collection recently and the result is still stored. You get it at once; it still costs a Quacktoken.

Refresh or Scan — which one do I press?

Refresh is free: it shows what was loaded since and re-reads the OpenSea prices of the collection you have open. Scan starts over (and starts a new round of your auto-buy limits) and costs a Quacktoken.

Buying and gas

A buy failed. Did I lose money?

If the transaction never reached the network — nothing. If it reached the network and failed there (somebody bought the token first), the gas of that transaction is spent; the price of the NFT is not. History and Activity say which of the two happened.

Which buy speed (gas) should I choose?

On Ethereum the tip decides who is first in the block: Economy 0.1 gwei, Fast 3 gwei, Very fast 25 gwei at least. The table under the buttons shows what one buy costs right now, in ETH and dollars. On Robinhood a tip does not buy a place in the queue — the first transaction to arrive wins — so the speed changes little there.

What do I type into «Your tip, gwei»?

Only the tip — what you add on top of the network's own gas price; the bot counts the rest. A tip of 1 gwei is about 0.0002 ETH per buy. The table below the field recounts the cost while you type.

Why does the bot want more ETH on the wallet than the buy costs?

A transaction sets aside its whole gas limit while it is sent, and only what is really burned is taken. The line under the gas table says how much to keep free. If it is not there, the network refuses the buy as «not enough funds».

A buy says «sent» but is not confirmed. What do I do?

Nothing special: a transaction that has not got into a block for 45 seconds on Ethereum (20 on other networks) is replaced by your next purchase from the same wallet — the new one takes its place and pays a little more. The stuck one is cancelled and says so.

The collection is priced in USDG. Anything special?

The bot wallet needs USDG for the price and a little ETH for gas. Before each buy the bot sends an approval for exactly that amount — one more small transaction.

What is «Flashbots»?

Ethereum only: the purchase is sent privately, so other bots cannot see it waiting and jump ahead of it. If the private relay does not answer, the buy is sent the normal way.

Auto-buy and monitors

The bot bought something I did not want. Why?

It bought by your rules: a super keyword matched a trait, or the token was in your top-N under your max price. Activity and History say which rule it was. Check your keywords, exclusion words and limits — and read Risks and responsibility.

Can different keywords have different prices?

Yes — two groups. The super keywords are group 1; Group 2 in the same card has its own words, its own max prices and its own «floor + %». Put the most valuable words («1/1») into the group with the higher price and the weaker ones («mythic», «divine») into the other. Each group has its own number of buys per reveal («Super buys / reveal» and «Group 2 buys / reveal»); the spend cap is shared. A token that fits both goes by the higher price. For «only when BOTH words are there» use Combo words («mythic + gold»): their own card, price and limit.

When do the «per reveal» limits start again?

With every scan you start, and with every reveal you were waiting for. Somebody else scanning the same collection never resets your limits and never buys for you.

A collection revealed but the bot did not scan it.

The scan after a reveal costs 1 Quacktoken. With none left the reveal is noticed, but the scan cannot start. Autorefuel never takes your last Quacktoken for exactly this reason.

My monitors stopped by themselves.

Either the fuel ran out (and autorefuel had nothing to pour, or is off), or the plan ended. Refuel and start them again — they do not restart by themselves after running dry.

Can I make offers on NFTs that are not listed?

Yes, on Premium and Quack: «Offer» on any unlisted token or «Offer Top-5» for ranks 1 … 5 (a listed one is marked, drop it with × if you like). An offer costs no gas; the WETH (or USDG) leaves the bot wallet only if the owner accepts. Wrap ETH into WETH and allow WETH once in the Offers tab; cancel offers there any time, for free.

Two users of the site auto-buy the same NFT. Who gets it?

The one whose transaction gets in first — it is a fair race. Everybody gets the same data at the same moment, each buys with their own OpenSea key and wallet, and nobody can pay the site to go first. On Ethereum the bigger tip wins; on Robinhood the transaction that arrives first, usually the one whose OpenSea answer came back faster. The other buys fail, and Activity says who got the token.

The top of a collection looks random. Is the bot wrong?

Usually no — the collection is. Some collections scatter their traits so that almost every token has a trait nobody else has; then every token looks like a 1/1 and «rank 1» means little (OpenSea and other rarity tools show the same). Open the Traits tab: if most traits are held by 1–2 tokens, do not buy by rank there — not with auto-buy, not with the Buy button, not on OpenSea. Buy by the traits you know are valued (super keywords, combo words) or skip it.

How fast does the bot notice a reveal?

Most projects announce the reveal on the blockchain («metadata updated») in the same transaction — the node sends that to the bot the moment it is in a block, there is no waiting. A project that reveals silently (only the metadata address changes) is caught by a check that runs every couple of seconds; a third, backup check makes sure an announcement is never missed even if the live connection to the node drops. Metadata kept on the project's own website is read directly, listed tokens first.

Keys, safety, account

How are my keys stored?

Encrypted. After you save a key it is never shown again — not to you, not in the admin; you only see the wallet address and whether a key is set. You can remove a key at any time with «Remove» in Settings. The bot cannot work on the site without keeping them — see Risks and responsibility.

Can I use the bot in two browser windows at once?

You can open it, but both windows show the same account: one collection open at a time, the same Quacktokens, the same limits. A second window does not give a second bot.

«Too many requests — try again in N s»

You clicked faster than a person normally does (for example Refresh many times in a row). Wait the seconds it says.

The page says «engine offline».

The bot itself is restarting. Commands cannot run meanwhile; it is usually back within a minute. Reveal monitors come back by themselves.

Why do I see the warning window again?

Without «Don't show this again» it is shown once every time you open the browser. It also comes back for everybody when its text changes.

Az Glossary

Contract address: The address of the collection (0x…, 42 characters). It is on the collection's OpenSea page and in the explorer.
Reveal: The moment a collection replaces the common placeholder with the real pictures and traits.
Floor: The cheapest listing of the collection right now.
Listing: An NFT put up for sale at a fixed price.
Trait: A property of an NFT: a type («Hat») and a value («Crown»).
Rank: The place of a token in the collection by rarity. 1 is the rarest.
Gas: The network's fee for a transaction. Its price = the network's base price + your tip.
Gwei: The unit gas prices are quoted in: a billionth of one ETH.
Tip: What you add to the gas price for whoever builds the block. On Ethereum a bigger tip goes first.
USDG: The dollar token many Robinhood collections are priced in.
Quick buy: You press Buy — the bot buys that one token at once.
Auto-buy: The bot buys by itself by your rules (keywords, top-N, price limits), also right after a reveal — you press nothing.
Bot wallet: A separate wallet whose key the bot keeps to sign your purchases.
Quacktoken: What a scan costs. Comes with the plan every day.
Fuel: What running monitors burn. Made from Quacktokens.
Redeem points: What plans cost. You get them on the Redeem page.