explaingit

bigcjat/floorsweeper

Analysis updated 2026-05-18

2PythonAudience · developerComplexity · 3/5Setup · moderate

TLDR

A Python bot for the XRP Ledger that automatically buys underpriced NFTs and relists them for profit, with a dry run mode for safe testing.

Mindmap

mindmap
  root((repo))
    What it does
      Buys underpriced NFTs
      Relists for profit
      Cold wallet sweep
    Tech stack
      Python
      XRPL
      WebSocket
    Use cases
      NFT trading
      Collection bidding
      Dry run testing
    Audience
      Crypto traders
      XRPL wallet owners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically buy underpriced NFTs listed below your target price on the XRPL market.

USE CASE 2

Relist bought NFTs at a profit after accounting for creator royalties and marketplace fees.

USE CASE 3

Sweep excess profit into a separate cold wallet while keeping a fixed NFT inventory.

USE CASE 4

Simulate a full trading cycle in dry run mode before risking real XRP.

What is it built with?

PythonXRPLxrpl-pyWebSocket

How does it compare?

bigcjat/floorsweeper0-bingwu-0/live-interpreter0cm-labs/tokenizer-benchmark
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity3/52/52/5
Audiencedevelopergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires a funded XRPL wallet and careful configuration of buy and sell floor prices.

No license information is stated in the README.

In plain English

This is a bot for the XRP Ledger, known as the XRPL, that automates buying and reselling NFTs. It is written in Python and works by watching the market for NFTs listed below a price ceiling you set, buying them right away, then relisting them for sale at a higher floor price you also choose. When it relists a bought NFT, it works out the original creator's royalty and any marketplace fee automatically, so the resale price is set high enough that you still make your target profit after those costs are subtracted. There is also a mode that caps how much NFT inventory the bot holds and moves any extra XRP profit into a separate cold wallet, which is a wallet kept offline for safekeeping. You can also give the bot a list of specific NFTs to snap up the moment they appear for sale, and a separate protected list of NFTs it should never sell or make offers against. The bot can place standing low offers across an entire NFT collection at once, tracking which pieces change owners and cleaning up old offers automatically. Before risking real funds, there is a dry run mode that lets the bot go through its full buying and selling logic in simulation, logging what it would have done without spending any XRP or submitting real transactions. Under the hood, the bot keeps a persistent connection open to an XRPL server rather than reconnecting for every request, and it uses a ledger feature called Tickets so buying and relisting can happen at the same time without conflicting. It automatically tops up its supply of these tickets when they run low. It also checks transaction fees on the network each cycle so it can adjust its own fees during busy periods. To run it, you need Python 3.11 or newer and a funded XRPL wallet, since the ledger requires a small amount of XRP reserved for each active offer and for storing NFTs.

Copy-paste prompts

Prompt 1
Help me configure the .env file for this XRPL floor sweeper bot, explaining each setting.
Prompt 2
Walk me through generating a new Ed25519 XRPL wallet using the provided Python script.
Prompt 3
Explain how this bot calculates NFT royalties and broker fees when relisting.
Prompt 4
Show me how to run this bot in DRY_RUN mode so I can test it safely first.

Frequently asked questions

What is floorsweeper?

A Python bot for the XRP Ledger that automatically buys underpriced NFTs and relists them for profit, with a dry run mode for safe testing.

What language is floorsweeper written in?

Mainly Python. The stack also includes Python, XRPL, xrpl-py.

What license does floorsweeper use?

No license information is stated in the README.

How hard is floorsweeper to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is floorsweeper for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.