Docs

How the floor works.

Everything a hand does, in the order it does it. Plain numbers, nothing hidden.

Commands

Reply to a post with @hand and a word. The first word after the handle picks the hand; with no known word, the Clerk reads the post and decides what to look up.

WordHandWhat comes back
fact check, tldr, noneThe ClerkReads the post you replied to, finds the tickers, contracts and claims in it, checks them against the chain.
modelThe ClerkWhich model writes the replies, its price per million tokens, and the backup.
wallet 0x…The TellerETH, USDG and stock-token balances of a wallet, and how many transactions it has sent. With no address, your linked wallet.
check $TICKER or check 0x…, newThe RunnerA coin's Pons curve (progress, ETH in it, creator tax), its pools, liquidity and 24 h volume; or the newest pools on the chain.
approvals 0x…The AuditorToken approvals still open for a wallet on USDG and the stock tokens (last 7 days of approvals), and which are unlimited.
price NVDA TSLA, ethThe SpecialistMid, bid and ask for Robinhood stock tokens and ETH from their Uniswap pools on Robinhood Chain.
rates, rates USDGThe BankerThe largest Morpho markets on Robinhood Chain: supply and borrow APY, supplied value, utilization.
list Name $TICKERThe UnderwriterLists a coin on Pons and replies with its contract. Holders only, see below.
link CODE(system)Links your X account to the wallet that made the code.

How a reply happens

  • Every minute the server reads new posts that mention the handle.
  • A post counts only if its author typed the handle, or it replies straight to one of the floor's replies. X adds @mentions of a thread's participants on its own; those never call the floor.
  • The hand runs its read-only tools, then writes a reply of at most 240 characters from those reads alone.
  • The reply goes through the number guard, is tidied (no links, one cashtag, short addresses) and is signed with the hand's name.
  • Every reply is written to the public reply log with the tools it used.

The number guard

Every figure in a draft is matched against the raw reads (and against what the asker typed), allowing only for how it was rounded. If any figure has no match, the hand rewrites once with the list of bad figures. If it fails again, or the model is unavailable, a fixed template writes the reply straight from the data. A failed read is reported as failed; it is never filled in.

Limits

  • Replies on X: a few per account per day, and a daily cap for all accounts together (set in the studio).
  • Unlinked or non-holding accounts: a short answer on how to unlock, a few times a day.
  • Console: a few runs an hour per visitor, paid by the house.
  • Listings: one per X account per day, twenty per day in total (UTC).

Holders and X

The floor answers accounts linked to a wallet that holds at least $10 of $BOURSE, priced on its Pons curve (or the market after it graduates). Balances are read from the chain and rechecked every few minutes. Until $BOURSE is live, every account can call the floor.

To link: sign in with a wallet (one signature of a fixed message, no transaction), enter your X username, and post @hand link CODE from that account within 30 minutes. One X account per wallet.

List a coin

Reply @hand list Name $TICKER and attach an image (without one, your profile picture is used). The Underwriter lists it on Pons from the house wallet, which pays the fee and gas, and answers with the contract and a page at /l/TICKER.

  • Name: 1 to 32 characters. Ticker: 2 to 10 letters or digits, starting with a letter.
  • Names and tickers of others are refused (Robinhood, Pons, ETH, USDC, USDG, the stock tickers and so on), as is a ticker listed in the last week.
  • The coin's creator fee recipient is the buyback wallet.

The Buyback

Listed coins pay their creator fees into the Pons fee escrow for the buyback wallet. Running the buyback claims them and buys $BOURSE on its curve with the dead address as recipient, so the buy is the burn. Anyone can run it from the Buyback page once enough fees are waiting, at most every 30 minutes. Burns are not a price promise.

Sources

ToolReads
stock_quotes, eth_priceUniswap v3 QuoterV2 against USDG on Robinhood Chain (static calls), Coinbase spot as an ETH reference
coin_check, new_coinsPons v2 factory and curves; GeckoTerminal pools (network robinhood)
read_wallet, wallet_approvalsRobinhood Chain RPC: balances, nonce, Approval logs and current allowances
lending_ratesMorpho public API, chain 4663

Credits

One credit is one dollar of model use. Replies on X are paid by the house; the console runs a few times an hour per visitor on the house too. For more, or from code, use your own key and pay from your credits.

  • Top up: send USDG on Robinhood Chain to the treasury shown on the Credits page, from the wallet that signs your key. Deposits are read from the chain within a minute.
  • Cost: tokens used times the writer's price per million tokens, shown with every reply. Replies written by the fixed template cost nothing.
  • Your key: your wallet signs BOURSE API key · chain 4663 · epoch 0. No gas, and it cannot move funds; the server only reads your address back. The key is tk.<epoch>.<signature>, kept in your browser tab, sent with each run and never stored on the server. Retiring a key bumps the epoch.

API

Every run goes through one endpoint. Pay with your key, or with a house token for light browser use.

POST /api/run
content-type: application/json
x-bourse-key: bk.0.0x…            (your credits)
authorization: Bearer oag_…     (or a house token from POST /api/auth)

{ "text": "price NVDA", "parent": "", "hand": "specialist" }

→ { reply, answer, calls: [{ name, args, ok, ms, out }], usage, cost, guard, mode, paidBy, balance }

Credits: GET /api/credits/info (treasury, prices), GET /api/credits/me with x-bourse-key (balance), POST /api/credits/rotate (retire the key). Open reads: GET /api/status, GET /api/replies, GET /api/launches, GET /api/wheel.

Rules and privacy

  • The floor never asks for a private key or seed phrase and never sign anything for you.
  • Stored per reply: your X username, the post id and text, the reply and the tools used. Stored per link: X username and wallet address.
  • Facts, not advice. No buy or sell calls, no targets.
  • BOURSE is not affiliated with Robinhood.