Documentation

Know the market.
Know the rules.

Oraqle brings prediction markets to the Robinhood economy: stock tokens, trader performance, and onchain activity. This guide explains how shares trade, what the sources measure, and how outcomes become claimable.

01

Oraqle & the Robinhood economy

Each native market asks one verifiable question. Its asset or wallet, threshold, cutoff, and source are published in an immutable rules document before the market opens. The document’s hash is recorded onchain.

Robinhood asset and trader data comes from Robinhood Chain mainnet (4663). Oraqle’s initial trading deployment targets Robinhood Chain Testnet (46630), with valueless tUSD collateral. A market only displays executable native prices after its contract and seeded pool exist.

The external research board shows Polymarket source prices and liquidity. Those markets execute at their source venue and do not use Oraqle’s contracts or fee model.

02

Buy and sell outcome shares

Native AMM markets hold collateral-backed Yes and No shares. At a valid resolution, a winning share redeems for one unit of collateral and a losing share redeems for zero. Before closing, shares can be bought or sold through the pool.

Instantaneous Yes price, before trading fees
No reserve ÷ (Yes reserve + No reserve)

Trading changes the reserves and therefore the odds. The displayed probability is a marginal pool price, not a promise that an entire order executes at that price. Your quote accounts for order size, price impact, fees, and integer rounding.

Slippage protection

Before submission, review the minimum shares received when buying, or minimum collateral received when selling. The contract rejects a trade if the executed result is below that limit. A quote can change while a wallet confirmation is pending.

Seed liquidity

An approved market creator deposits initial collateral to seed both outcomes. Equal starting reserves produce a 50/50 starting price; this is pool initialization, not a forecast. The creator cannot withdraw the seeded reserve during an open market and redeems its remaining outcome reserves only after settlement.

Keep market models separate

The older pooled-stake contract uses hold-until-settlement pari-mutuel accounting. It is separate from the new buy/sell AMM, and its positions are not interchangeable with AMM shares.

03

The 2% fee & ORAQLE

For buys, 2% of gross collateral is a fee and the remaining collateral enters the pool. For sells, 2% of the gross collateral output is a fee. Fees are calculated in integer collateral units and stay escrowed until a valid resolution.

At valid resolution, escrowed fees move to the fee vault. The vault supports buying ORAQLE through an allowlisted trading router, with an explicit minimum received amount and transaction deadline, then burning the purchased tokens.

Buybacks require an actual liquid trading route and an authorized executor. They are not automatic from deployment, and no buyback route is active yet. Direct token deposits followed by burning are a separate operation, not a market purchase.

The test deployment creates a provisional supply of one billion ORAQLE. It does not establish a final mainnet token supply, price, or entitlement to returns.

04

Resolution & claims

01Open

Buy and sell shares under the published rules.

02Close

Trading stops at the market’s closing timestamp.

03Propose

The authorized resolver submits Yes or No using the specified evidence.

04Finalize

Anyone may finalize after the fixed 24-hour delay, making payouts claimable.

The resolver is trusted. The delay allows public visibility, but the contract does not implement a decentralized challenge or arbitration mechanism. Read each market’s exact source and outage policy.

Voided AMM markets

If a result is not proposed by the resolution deadline, anyone can void the expired market. Each Yes and No share then redeems for half a unit of collateral, subject to integer rounding. Escrowed fees are separately refundable to the wallet that paid them, including wallets that fully sold their position.

A void does not reverse earlier trades or guarantee a return of gross stakes. Earlier AMM gains, losses, and price impact remain reflected in the shares held. A wallet can claim only once; the last eligible void claimant receives any remaining rounding dust.

05

What the data measures

Robinhood stock tokens

Logos, token addresses, chain IDs, and multipliers come from the official asset registry. The live bid/ask and stock chart are underlying-equity reference prices, not executable stock-token quotes. Multipliers affect token exposure. The historical stock endpoint is public but undocumented and may become unavailable.

Underlying equity trading volume is not onchain volume. The quote API’s mint/burn fields are displayed only as source-reported mint/burn metrics; they are not used as DEX volume.

Trader profiles

GMGN’s Robinhood-chain KOL trade feed supplies public wallet identities. Period PnL uses provider-reported realized profit. The activity chart accumulates realized PnL only for returned sell records with source cost basis. If history is incomplete, the chart is explicitly partial and cannot be treated as full account PnL. An identity label does not establish endorsement or control of a wallet by a named person.

Chain activity

DeFiLlama supplies indexed DEX volume and TVL. Coverage follows tracked protocols and adapters, rather than every transaction or stock-token transfer on Robinhood Chain.

News & external odds

News links point to Robinhood Newsroom, financial/crypto publishers, and SEC releases, with publisher timestamps and images. Polymarket reference odds and historical charts come from its current market-data APIs. News does not itself settle an Oraqle market unless its rules name that source.

Sources can be delayed or unavailable. A missing observation is shown as unavailable, not as zero. Market rules specify the exact observation needed for settlement.

06

Wallets & community

Privy supports email sign-in and external Ethereum wallets. Users without a linked wallet can create an embedded wallet. Trading still requires the correct network, sufficient gas, and collateral; an email login is not a deposit.

Community posts, replies, likes, and profile edits use a wallet-verified server session. Signing in proves wallet ownership without granting token allowance. Token approval is a separate wallet transaction shown when required for trading.

The portfolio reads actual wallet balances and positions. Saved markets are local bookmarks; they are not positions.

07

Contract directory

Configured trading network: Robinhood Chain Testnet (46630). Only confirmed deployment addresses belong in this directory.

AMMDeployment pending
CollateralDeployment pending
ORAQLE tokenDeployment pending

Contracts support standard, non-rebasing ERC20 collateral without transfer fees. The initial test collateral has no monetary value. Production collateral, liquidity, and operator custody require separate configuration.

08

Public data routes

/api/robinhoodOfficial asset registry and current references
/api/robinhood/AAPL/history?range=1MUnderlying stock history
/api/robinhood/activityIndexed Robinhood-chain activity
/api/traders?period=7dRobinhood-chain trader directory
/api/newsAttributed publisher headlines
/api/marketsExternal prediction market research
/api/statusService and deployment status

Reference API keys remain on the server. API availability is separate from contract settlement; do not assume an external data response is an oracle transaction.