What is stonkbroker-agent?

This project is a server that lets an AI agent control a specific kind of crypto wallet called a token bound account, which is tied to an NFT called a StonkBroker. Through this server, the agent can check the wallet's holdings, get a price quote for swapping one tokenized stock for another, carry out that swap on a network called Robinhood Chain, and then post a message about the confirmed trade to X, the platform formerly known as Twitter. The project is independent and is not connected to Robinhood, StonkBrokers, Uniswap, or X. It deals with tokenized stocks and automated trading, both of which carry real financial risk, so the README recommends starting in a read only mode where nothing can actually be traded. By default the agent can only inspect the wallet and look up prices using a public connection, and it needs no private key to do that. To move past read only mode and actually place trades, an owner has to supply their private key, turn on a live trading setting, and connect an account on X so trades can be posted there. Even then, safety limits apply: a single quote cannot use more than a set percentage of the wallet's current balance, only official, verified contracts can be used, and every trade requires the operator to type a specific confirmation word before anything is signed. The system also checks that the NFT, its linked wallet, and the token being swapped all match expectations before allowing a transaction to proceed. The repository includes a command line tool for checking wallet status and prices without cloning the code, a way to build and run the server directly with Node.js and a package manager called pnpm, and a Docker option for running it in a container. It also includes a built in tool for recording a step by step proof of a trade being quoted and executed, useful for verifying the whole flow worked as intended. The project is written in TypeScript and released under the MIT license.