Automated script to hunt for rare sats.
- An account on one of the supported exchanges (see Exchanges section)
- Deezy API Token (email [email protected] to request one)
- Some Bitcoin
Contact the exchange you're using before running the operation. Sat hunting looks very suspicious to the risk department of bitcoin exchanges, so it is important that you pre-emptively reach out to them and let them know what you're doing so your account does not get banned. All it takes is emailing support saying: "Hello, I am going to do rare sat hunting on your platform which involves withdrawing and depositing a high volume of the same coins over and over again. The activity may look suspicious so I wanted to flag it for you ahead of time. Rare sats are a new phenomenon on bitcoin and the ordinals protocol, and I am sifting through a large volume of coins in order to find them. Please reach out with any questions. The operation will be mutually beneficial because I will be paying a lot of withdrawal fees on your platform. Thank you!"
Follow This Guide to set up the automated hunter without touching any code
The self hosted option requires you to run either of the following:
- Local wallet (e.g. Sparrow): You can use whichever wallet you want as long as you can find your wallet seed, derivation path, and a wallet address (see .env.sample). We strongly recommend Sparrow. See below for Sparrow setup instructions.
- Bitcoin Core: For those not familiar, this is not as intimidating as it sounds. This does NOT mean you need to start a mining operation. See Bitcoin Core section below for more info
Install the Script
git clone https://github.com/deezy-inc/sat-hunter.git
cd sat-hunter
npm install
Setup Environment Variables (you'll need to do some setup for the exchange you're using like getting API keys and allowlisting the withdrawal address)
cp .env.sample .env
// Edit .env to match your setup.
npm start
We recommend using Sparrow unless you're running an instance of Bitcoin Core. For security purposes we recommend creating a new wallet for sat hunting even if you already use Sparrow for other activities. Alternatively, you can also use a Coldcard running in HSM mode for an even higher level of security, and is described further down.
- Download Sparrow from https://sparrowwallet.com/download/
- Open Sparrow, click File, New Wallet.
- Name your wallet, click Create Vault
- Native Segwit is the default script type – use this option.
- Click New or Imported Software Wallet
- From the dropdown menu select Use 12 Words
- Generate new
- Write down these words in a safe place. You will need the seed words for .env file configuration.
- Create Keystore -> Import Keystore -> Apply
- The tabs on the left will turn blue.
- Go to the receive tab. You will need this address for .env file configuration.
To encrypt the wallet seed run:
npm run encrypt-seed
This will require you to enter a password to unlock the bot every time it starts up.
Enable Coldcard HSM support for enhanced security during the signing process. This ensures that private keys are managed within a secure, tamper-resistant hardware environment, offering an additional layer of security.
To utilize this, you'll need to install the ckcc CLI tool first, and be able to physically connect your Coldcard to the machine running the sat-hunter via USB.
To activate HSM support, run the npm run hsm command, which will guide you through configuring your .env file and activating an HSM policy.
To fetch your scan limits and payment information run:
npm run hunter:limits
Or if you have Telegram configured:
/limits
This will return your available scan limits, consumed scan volume, and your deposit address to purchase additional volume or renew your subscription.
To perform a withdrawal, first alter your ADDRESS_BOOK in the .env and then run:
npm run hunter:withdraw name amount_btc
Or if you have Telegram configured:
/withdraw name amount_btc
This will attempt to fill the withdrawal request in your next scan and a notification will be sent upon completion.
To perform a bulk transfer, simply run:
npm run hunter:bulk-transfer from_address to_address tag_to_transfer num_of_sats_to_send fee_rate
Or if you have Telegram configured:
/bulktransfer from_address to_address tag_to_extract num_of_tag_to_send fee_rate
This will attempt to build a PSBT, store the results in the data folder, and a notification will be sent upon completion. This can be used to transfer sats between your own wallets or to send special sats to settle an OTC trade. The PSBT at this time must be manually loaded into a wallet of your choice to be signed and broadcasted. (e.g. Sparrow)
For example, to transfer 100,000 pizza sats from address abc123 to address def456 with a fee rate of 1 sat/vbyte, you would run:
npm run hunter:bulk-transfer abc123 def456 pizza 100000 1
Setting up the telegram bot can give you real-time updates of your operation. Follow these instructions:
- Message @botfather on telegram with the command
/newbotand answer the questions - After the bot is created @botfather will give you an API key that looks something like this:
123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ - Paste that API key into your
.envfile asTELEGRAM_BOT_TOKENlike this (TELEGRAM_BOT_TOKEN=123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ) (Or as a Secret if using Replit) - Run the command
npm run setup-telegramand leave the terminal window open - Message your bot on telegram (the botfather will have given you a t.me/yourbotname link)
- When your message goes through, your terminal window will show a TELEGRAM_CHAT_ID, add this to your
.env(or Replit Secret) as well
Note: see .env.sample for the fields you'll need for each exchange.
Kraken is well-tested and works well. You can email kraken support to get increased daily limits.
Gemini is also well tested and works well, but adding a new withdrawal address requires a 7-day waiting period.
Make sure you are NOT a US user and are prepared to KYC. API withdrawals without manual approval require some waiting: you need to enable 2fa and withdrawal address whitelisting and whitelist your withdrawal address and then wait 5 days.
Regular Coinbase accounts work OK, but withdrawals are often delayed and require additional KYC. Ideally upgrade to Coinbase Exchange for a better experience (below)
This is the upgraded version of Coinbase with more support for automation. This account type is recommended if you are able to get the upgrade.
This is another type of coinbase account
Binance should work but is not yet well-tested
Bybit should work but they are known to shotgun-KYC (let you do a little activity then hold your funds unless your provide full KYC), so ensure that you are able to fully KYC according to their regulations
Works ok - kind of slow withdrawals from them.
Newly added
Help us add more exchanges - we want to add them all! Open an Issue in the Github to request a new one.
You can use bitcoin core as the wallet backend. See the .env.sample