Halbrook Docs
Everything you need to use Halbrook, in a six-minute read.
1What is Halbrook
Halbrook is an exchange for AI models: one wallet, one balance in USDG, every major model. Buy tokens of the models you believe in at the market price, swap between them, go long or short with leverage, and use them in the Aggregator or through the API, where each request goes to the cheapest host.
Prices are real and public. They come from the hosts themselves and refresh every 60 seconds.
Models available today: Claude Opus 5.5, Claude Fable 5.2, GPT-6 Astra, GPT-6.1 Sol, GPT-6.1 Terra, Gemini 4 Neon, Gemini 4 Carbon, Mistral Large 4, DeepSeek V4.1 Flash, DeepSeek V4 Pro and Grok 4.7.
2Getting started
You need a browser wallet such as MetaMask or Rabby. It takes under a minute.
- Open the Exchange.
- Click Connect wallet, accept in your wallet, then sign the message. Signing is free: no transaction, no gas.
- Your balance appears at the top right of the page.
- Click Deposit and send USDG from that same wallet. It is credited in about a minute.
You stay signed in for 7 days on that browser.
Deposit and withdraw. Halbrook runs on USDG, the Global Dollar by Paxos, on Robinhood Chain. Click Deposit at the top of the page and send USDG from your connected wallet: it is credited after 5 confirmations, usually under a minute. The Deposit window shows how much USDG is in your wallet, with a Max button. Only USDG, only on Robinhood Chain, only from the wallet you signed in with. Buy any model with it, swap, use. To cash out, swap back to USDG, then click your balance at the top of the page and choose Withdraw: it goes to your connected wallet. Fee: 0.50 USDG per withdrawal. Limits: 100 USDG per withdrawal and 200 per day; large withdrawals are checked by a person first.
3Swap tokens between models
A swap turns tokens of one model into tokens of another, at the market price, in one click.
- Pick what you give and what you get. Each list shows your balance of every asset, USDG first.
- Enter an amount: in dollars when you give USDG, otherwise in tokens, written like the result: 1M, 500K, 2.5M. Max fills in all you hold.
- Check what you will receive, then click Swap.
Each model has two prices:
- Reference: the real cost of using the model, from the hosts. It refreshes every 60 seconds. When a host changes its price, the market price stays where it was and the premium absorbs the change.
- Market: what the model trades at on Halbrook. Swaps into a model push it up, swaps out push it down.
The gap between the two is the premium. It always stays between −30% and +30% of the reference. Trades move it: buying pushes it up, selling pushes it down. Between trades it fades back toward the reference, losing half of its gap every 6 hours. A model pushed to +20% is at about +10% six hours later if nobody trades it, and close to its reference after a day. So a premium only lasts while players keep buying: buy before the hype, swap out while the premium is high.
Using your tokens, in the Aggregator or through the API, always counts them at the reference price. So a model trading below its reference is a bargain to use: that is its floor.
Big swaps move the premium more, and you pay the average price along the way: about 1 point of premium for every $10 swapped, so a $100 swap moves it by about 10 points. The part of an order that would go past the ±30% band trades at the edge price. Before you confirm, the Exchange shows the premium after your swap. Fee: 0.3%, and a swap must be worth at least $0.01.
If a host changes a model's official price by more than the band can absorb, trading on that model pauses while the new price is checked, then resumes.
The market table lists each model's reference price, market price, premium and cheapest host. Click a model to open its chart: the market price over 1 day, 1 week, 1 month or all time, the reference line, a dot for every trade (green buy, red sell, yours bigger) and the slow glide back toward the reference between trades.
4Leverage: go long or short
Leverage lets you bet on a model's price going up (long) or down (short) with more exposure than your margin. Your margin is in USDG, and you never hold the model's tokens.
- In the Exchange, open the Leverage tab next to Swap.
- Pick a model, then Long or Short.
- Enter your margin in USDG and pick the multiplier. Before you confirm, you see the entry price, the liquidation price and the fees.
- Click Open long or Open short. Your position appears below, with its live value and a Close button.
Example. You open a long on Claude Opus 5.5 with 10 USDG at x2: a 20 USDG position. If the mark price rises 10%, you gain 2 USDG; if it falls 10%, you lose 2 USDG. Fees come on top.
The mark price. Positions follow a mark price: the average of the model's market price over the last 4 hours, sampled every minute. One big trade cannot wipe anyone out or hand anyone a win. You open and close at the more conservative of the live market price and the mark price. When leverage has just been switched on, the mark price needs about 80 minutes of samples before positions can open: the tab shows “warming up” until then.
When positions can open. Only while the market is calm: the live price and the mark price must agree within 3%, and the model must trade within 10% of its reference price. Otherwise, wait for it to settle.
Liquidation. If a position falls to 10% of its margin or less, it closes on its own and that margin is lost. You can never lose more than your margin.
Backed by the reserves. A position only opens if the reserves already cover its biggest possible win, at the edge of the band. Open positions are capped at $100 in total for now, and they show up on the proof of reserves. If leverage is full, try a smaller position later.
Leverage multiplies gains and losses. Only trade what you can afford to lose.
5Aggregator and API: every model
Each question goes to the cheapest host for that model, and you pay only what it really cost.
- Open the Aggregator tab.
- Pick any model.
- Type your question and press Enter.
Under each answer: the model that wrote it, the tokens used, the price in dollars, the host it went to, and the saving against the official price. Each answer is paid from your tokens of that model if you hold some, otherwise straight from your USDG at its real cost. No balance? Deposit USDG first.
One conversation, every model. Switch models in the middle of a conversation: the new model sees everything said before. New chat starts fresh.
Shared memory. Click Memory to save short notes about you or your work (“I write Python”, “my startup sells to dentists”). Every model reads them, so you never repeat yourself. Notes are encrypted on our server; Forget everything deletes them for good.
The API. Use the same aggregator in any app that works with OpenAI: Cursor, scripts, agents. Same balance, same memory, same cheapest-host routing, paid from your model tokens or your USDG.
- Open the API at the bottom of the Aggregator and sign in.
- Click Create or manage keys, then Create a key and copy it right away: it is shown only once.
- In your app, set the base URL and the key.
Base URL https://www.halbrook.xyz/v1
API key hb_…
curl https://www.halbrook.xyz/v1/chat/completions \
-H "Authorization: Bearer hb_…" \
-d '{"model":"claude-opus-5.5","messages":[{"role":"user","content":"Hello"}]}'
Before each request, Halbrook sets aside the most it could cost; after the answer, you pay the real cost and the rest comes back. Streaming works, and GET /v1/models lists the models and their prices. Add the header X-Halbrook-Memory: on to give the model your shared memory notes. Limits: 60 requests a minute per key, 4 at a time per account, 5 keys per account. Lost a key? Revoke it in one click.
6Fees and pricing
| What | Fee | Example |
|---|---|---|
| Swap | 0.3% | $10 swapped, $0.03 fee |
| Leverage | 0.3% to open, 0.3% to close, 0.01% per hour held | 20 USDG position held 10 h: $0.12 + $0.02 |
| Aggregator and API | 5% on top of the real cost | $0.0020 answer, $0.0021 paid |
| Withdrawal | 0.50 USDG | Withdraw 20 USDG, receive 19.50 |
| Deposit, sign-in | Free | You only pay the network gas on deposit, a few cents |
A model's price mixes its input and output prices, three parts input for one part output, like a typical conversation.
7The film and the briefcase
The home page is a short interactive film. The briefcase is optional: you can enter the dApp freely at any time, or crack KESTREL first, like a real agent.
- Click the van to open the door.
- Meet Madame Vale and Horace, her parrot. Look around and talk to them.
- Find the four-digit code that opens the briefcase.
- Watch the ending, then click Enter dApp. To skip the film, click Enter dApp at the top and choose Enter the dApp.
Stuck? Give Horace a sunflower seed and listen to what he shouts.
8Safety and FAQ
Halbrook will never ask for your seed phrase or private key. If anyone does, it is a scam.
Is it real money?Yes. Deposits and withdrawals are in USDG on Robinhood Chain. Halbrook holds the USDG you deposit and keeps your balance on its server, like an exchange: there is no Halbrook smart contract. Start small.
What does signing in do?It proves you own the wallet. It moves no funds and costs no gas.
Do swaps happen on chain?No. Only deposits and withdrawals are blockchain transactions. Swaps, leverage and chat happen inside Halbrook: instant, with no network fee.
Can someone push a price to win on leverage?It does not pay. The mark price is a 4-hour average, premiums fade back toward the reference, and positions only open in a calm market. Holding a price up for hours costs more than any position could win.
Is every balance backed?Check it yourself on the proof of reserves: the USDG the treasury holds on chain against everything players could take out, live. If it ever fell short, withdrawals would pause on their own.
Something looks wrong?Write to us on X: @halbrookmarket. Code: GitHub.
Halbrook