Docs
One key. Every model. Nothing sits idle.
How credits are granted, spent and burned, what the vault can and cannot do, and how to plug a key into the tools you already use.
01
Overview
Orbz turns the trading fees of one token, $ORBZ, into AI credits for the people who hold it. Every hour, 70% of the fees that reached OrbzVault in that hour are granted to holders, pro-rata to their time-weighted balance. Credits spend on every major model through one API key, at the model provider's list price.
Each credit lives 168 hours. Whatever is left unused when the fuse runs out buys $ORBZ on the market and burns it. A holder who uses AI every day gets it paid by the fees. A holder who never opens the app still gains, because every idle credit becomes a buyback-and-burn.
- One token. No staking, no locking, no second credit token, no order book.
- Credits are pre-funded: a grant is written only after its USDG sits in the vault.
- OrbzVault has no owner and no upgrade path. Burns are permissionless.
- Every hour prints a public receipt, and the reserve page shows the vault holding exactly what the dashboards owe.
$ORBZ has not launched yet. Everything below describes the system as it will run from epoch 0; the API opens at launch.
02
Quickstart
- 1
Hold $ORBZ
Keep at least 100,000 $ORBZ (0.01% of supply) in your own wallet. Grants start at the next full hour.
- 2
Sign once
Connect at use.orbz.app and sign the message "Orbz API key · chain 4663 · epoch 0". No transaction, no network fee. The signature becomes your key.
- 3
Paste the key
Set the base URL and the key in your editor, agent or SDK. The API is chat-completions compatible, so existing clients keep working.
- 4
Work
Credits arrive every hour and are spent oldest first. Every response carries X-Orbz-Balance, the balance the request started from.
# the two values your client needs
base_url = https://api.orbz.app/v1
api_key = sk-orbz-0-… # from your wallet signature, shown once
# a first request
curl https://api.orbz.app/v1/chat/completions \
-H "Authorization: Bearer $ORBZ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "<id from /v1/models>", "messages": [{"role": "user", "content": "Plan the next task."}]}'Rotate a key by signing the same message with a higher epoch number. The old key stops working the first time the new one is used. Anyone holding your key can spend your credits, so keep it on your server.
03
How credits work
Epochs
An epoch is one clock hour, numbered from launch. Fees harvested during an hour are booked to that epoch's pool, in USDG, inside OrbzVault. At the top of the next hour the allocator reads the booked amount and writes grants.
Your share
Your grant for an epoch is the pool multiplied by your time-weighted balance, divided by the time-weighted balance of every eligible wallet. The time-weighted balance is your average holding across the hour, integrated block by block from $ORBZ transfer events, so a position held for five minutes counts for one twelfth of the hour.
grant(wallet, N) = pool(N) × twab(wallet, N) / Σ twab(eligible, N)
eligible = wallets holding ≥ 100,000 $ORBZ
excluded = the launch curve, the pool, OrbzVault, the treasury,
the burn address and published exchange walletsSpending and expiry
- Credits spend at the provider's list price for the model you call, with no markup.
- Grants are spent first in, first out: the oldest credit burns first, so you never lose a fresh credit to an old fuse.
- A grant expires 168 hours after it was written. An expired grant cannot be spent or revived; its USDG waits for burnExpired().
What a credit is, and is not
- A credit is
- $1.00 of model usage at list price, tied to the wallet that received it, valid for 168 hours
- A credit is not
- a token, an NFT, transferable, redeemable for cash, ETH or USDG, or a return on holding
04
Fees and the split
Traders pay 2% on every $ORBZ trade: the launchpad's 1% base fee plus a 1% creator tax that is fixed at launch and cannot change. The launchpad passes 70% of its base fee to the creator-fee recipient, which is OrbzVault from the first block. So 1.7% of all volume reaches the vault, before and after graduation.
Of every trade
- 85%OrbzVault: 0.7% creator share of the base fee + 1% creator tax (1.7% of volume)
- 15%The launchpad keeps its share of the base fee (0.3% of volume)
Of what reaches the vault
- 70%Credit pool: booked hourly in USDG, granted to holders
- 30%Treasury: operations, provider float, the free demo, growth, reserve
Per $100,000 of volume
- Traders pay (2%)
- $2,000
- Launchpad keeps
- $300
- OrbzVault receives
- $1,700
- Credit pool (70%)
- $1,190
- Treasury (30%)
- $510
- If holders spend 15%
- $178.50 becomes AI, $1,011.50 buys and burns $ORBZ
- If holders spend 50%
- $595 becomes AI, $595 buys and burns $ORBZ
- If holders spend 100%
- $1,190 becomes AI, nothing is burned
Illustrative arithmetic per unit of volume, not a forecast. Grants follow real volume hour by hour and are never promised.
05
OrbzVault
OrbzVault is the creator-fee recipient and the only place the credit pool exists. It has no owner and no upgrade path. Its parameters are immutable at deploy: the $ORBZ, USDG and WETH addresses, the launchpad escrow, the router, the treasury, the settlement address, the operator, the 7000 bps split, the 3600-second epoch, the 168-epoch expiry and the 25 bps caller tip.
- harvest()
- Anyone. Claims escrowed ETH, swaps to USDG within a TWAP bound, sends 30% to the treasury and books 70% to the current epoch.
- withdrawForUsage(epoch, amt, root)
- Operator only. Pays the fixed settlement address for used credits, oldest epoch first, never above that epoch's remainder. root is the Merkle root of the requests it pays for.
- burnExpired(epoch)
- Anyone, after hour 168. Swaps the remainder USDG → ETH → $ORBZ, burns it, tips the caller 0.25% capped at $2.
- freezeOperator()
- Guardian only. Stops usage withdrawals. It can never move funds.
Invariants, tested on a mainnet fork
- 1
I1
Vault USDG equals the sum of open epoch remainders, within dust.
- 2
I2
Usage withdrawn from an epoch never exceeds what it booked.
- 3
I3
burnExpired reverts before epoch + 168 hours.
- 4
I4
A burned epoch can never be withdrawn again.
- 5
I5
Every harvest splits exactly 70 / 30 of the swapped USDG.
- 6
I6
Swaps revert if the price moves more than 3% from the 30-minute TWAP.
- 7
I7
Total supply of $ORBZ drops by exactly the burned amount in every burnExpired call.
No function sends USDG anywhere except the settlement address (used credits), the treasury share, or the burn path.
06
Burns
Three pipes feed the same public burn path. Each one swaps USDG to ETH to $ORBZ and calls burn() on the token, so total supply drops by exactly the amount burned. Every burn writes a row to the receipts feed with its transaction.
- 1
Expired holder credits
From launch + 168 hours: every epoch past its fuse burns whatever is left in it.
- 2
Paid top-up margin
V2: non-holders pay list price + 5% in ETH or USDG; the 5% buys and burns $ORBZ.
- 3
Idle treasury budget
V2: demo budget the funnel did not use can be routed into the same burn.
// callable by anyone once epoch + 168h has passed
OrbzVault.burnExpired(epoch)
→ swap remainder USDG → ETH → $ORBZ (reverts beyond 3% of the 30-min TWAP)
→ $ORBZ.burn(amount) // totalSupply drops
→ tip the caller 0.25%, capped at $2Our keeper calls burnExpired every hour. If it ever stops, anyone can call it and collect the tip, so nobody, including us, can stall a burn. Large remainders on a thin pool burn in slices to respect the price bound.
07
Receipts and reserves
Every epoch produces one receipt row and one receipt image, published at orbz.app/receipts and exportable as CSV.
- Fees in
- USDG harvested and booked for the hour
- Split
- treasury 30%, credit pool 70%
- Grants
- number of wallets credited and the total granted
- Usage
- credits spent and settled to providers, with the settlement Merkle root
- Burn
- remainder at hour 168, $ORBZ bought and burned, the transaction and the caller tip
The reserve equation
The reserves page reads OrbzVault's USDG balance from the chain every block and compares it with the open, unexpired credits shown on every dashboard. The two must be equal. Credits are pre-funded, so there is never a credit without USDG behind it.
08
Tiers and limits
Grants are strictly pro-rata; tiers never change what a credit is worth. They raise rate limits for heavier users and unlock cosmetic badges.
- Visitor · hold 0
- 20 demo messages a day on a small model; receipts, reserves and docs
- Orbit · 100,000 (0.01%)
- hourly grants; 60 requests / min, 8 concurrent; usage dashboard and fuse view
- Ring · 1,000,000 (0.1%)
- 120 requests / min, 16 concurrent; Ring badge on share cards
- Sun · 10,000,000 (1%)
- 240 requests / min, 32 concurrent; first look at new models; name on the holder wall
What $ORBZ never does
- Pay out cash, ETH or stablecoins to holders.
- Make one holder's credit worth more than another's.
- Need staking, locking or a second token.
- Let the team move the credit pool.
- Promise a fixed amount.
09
Token facts
- Ticker
- $ORBZ
- Chain
- Robinhood Chain, chainId 4663
- Supply
- 1,000,000,000, fixed, no mint
- Launch
- 100% fair launch on the Robinhood Chain launchpad bonding curve
- Graduation
- 4.2 ETH on the curve, then a Uniswap v4 pool
- Team allocation
- None. No presale, no private round
- Dev buy
- At most 2% of supply, wallet disclosed before launch
- Trader fee
- 2%: launchpad 1% base + 1% creator tax
- Creator tax
- 1%, fixed at launch, immutable
- Fee recipient
- OrbzVault: no owner, no upgrade, source verified
- Contract address
- Published on orbz.app and our official channels at launch, nowhere else
10
API reference
Public, no key
- GET /v1/models
- the model catalogue with list prices
- GET /api/stats
- 24-hour and all-time counters
- GET /api/epochs/:n
- one epoch with its full receipt
- GET /api/receipts?from=
- the paginated receipt feed
- GET /api/reserves
- vault balance vs open credits
With a key (Authorization: Bearer sk-orbz-…)
- POST /v1/chat/completions
- spend credits; streaming supported
- GET /v1/key
- available balance, fuse buckets and your rate limits
- GET /v1/usage?from=
- your per-request log
Wallet-signed
- POST /api/keys
- signature → a new key
- POST /api/keys/rotate
- a higher epoch → a new key, the old one retires on first use of the new one
- 401
- missing, invalid or rotated key
- 402
- no credits available
- 429
- rate limit for your tier
- X-Orbz-Balance
- response header: the balance the request started from
Money is an integer number of micro-dollars everywhere in the system; the API returns exact decimal strings.
11
Security and anti-gaming
- 1
Flash holds
Time-weighted balances: five minutes of holding gets one twelfth of the hour's share.
- 2
Wash trading
A round trip costs 4% in fees and only part of it returns, pro-rata to every holder. It is always a loss.
- 3
Sybil splits
Pro-rata math gains nothing from splitting a bag, and the floor keeps dust wallets out.
- 4
Key sharing
Allowed: it spends the owner's own credits.
- 5
Junk requests
Provider cost is real money, so junk only moves value from the burn to the provider.
- 6
Operator compromise
The operator can only pay one fixed settlement address, capped per epoch, and the guardian can freeze it.
- 7
Indexer lag
Grants pause; the allocator never guesses a balance. If settlement fails, spending pauses.
- Holders never deposit anything to receive credits.
- API keys are stored as hashes; rotation requires a new signature.
- The keeper key holds only ETH for network fees, and every call it makes is permissionless anyway.
- The launchpad's operator keeps a timelocked power to redirect creator fees. We watch for that event and alert publicly within minutes.
12
Treasury
- 35%Operations: servers, indexing, monitoring
- 20%Provider float: a prepaid balance so credits never wait for a settlement
- 15%Free demo: the chat on the landing page, capped by budget
- 20%Growth: creators, dev communities, bounties
- 10%Reserve: reviews and an incident fund
The treasury ledger is published monthly on the reserves page with transaction links.
13
Roadmap
- 1
Phase 0 · done
Mechanism locked, name and brand kit, blueprint and landing page.
- 2
Phase 1 · building now
Gateway with keys by signature and metering, indexer and allocator on a mainnet fork, OrbzVault fork-tested against I1 to I7, keeper, publisher, receipts and reserves.
- 3
Phase 2 · launch
Vault as fee recipient from block one, hourly receipts, the first-burn countdown, share cards and boards, the editor integration server, paid top-ups.
- 4
Phase 3 · scale
Sub-keys with spend caps, web search and page reads on the same credits, redundant providers, a third-party review of OrbzVault.
- 5
Phase 4 · ecosystem
Orbz keys as a payment rail inside other apps, fee-to-credit partnerships on Robinhood Chain, an agent SDK with budget planning.
Launch day
- T-24h
- the fuse animation and the vault address
- T-1h
- contract source and the fork test report
- T0
- launch; the vault is the fee recipient
- T+1h
- first harvest, first epoch, first grants
- T+2h
- first receipt printed
- T+24h
- day-one report: volume, fees, grants, usage
- T+168h
- first burn: epoch 0 expires, live
14
Risks
- Grants follow volume. If trading fades, every hourly grant shrinks with it. Credits stay pre-funded, so nothing breaks, but the product gets smaller.
- The launchpad's operator keeps a timelocked power to redirect creator fees. A migration plan to a new vault is published in advance.
- Metering runs on our gateway and usage is reported by an operator key: bounded per epoch, freezable and backed by Merkle roots, but still trust.
- Model providers can change prices or access. We keep more than one and re-read list prices every hour.
- At launch OrbzVault is fork-tested, not externally reviewed. That review is in Phase 3.
- Smart contracts can contain bugs. Digital assets are volatile.
15
FAQ
What do I get for holding $ORBZ?
AI credits every hour, paid by trading fees, spendable on every major model through one key. You need at least 100,000 $ORBZ; your share is pro-rata to your time-weighted balance.
Is this cash or a return?
No. A credit is a grant of product access to model usage: not transferable, not redeemable for cash or any digital asset, never a fixed amount.
What happens to credits I do not use?
After 168 hours the unused remainder of that epoch buys $ORBZ on the market and burns it.
Who triggers the burns?
Anyone. burnExpired is permissionless after hour 168 and tips the caller 0.25%, capped at $2. Our keeper calls it every hour.
Do I need to stake, lock or deposit?
No. Hold $ORBZ in your own wallet and sign one message to create a key.
Can I buy credits without the token?
Paid top-ups arrive in V2: list price + 5% in ETH or USDG, with the 5% burning $ORBZ.
16
Disclaimer
Orbz credits are a grant of product access to AI model usage. They are not transferable, not redeemable for cash or any digital asset, and not an investment return. Credit amounts depend on trading activity and are never fixed or promised. $ORBZ is a utility token for access within the product; it confers no ownership, profit share or claim on any entity or asset. Burns are a protocol mechanism, not a payment to holders. Nothing here is financial, investment, legal or tax advice. Smart contracts can contain bugs; model providers can change prices or access. Digital assets are volatile. Never risk funds you cannot afford to lose.