# Sphere — Pool-Backed Binary Bets on Price Moves (Solana)

> Bet on whether assets like TSLA, NVDA, BTC, ETH, SOL will go UP or DOWN by X% within a time window. The prize pool takes the other side of every bet. All on Solana, all in USDC.

## API Base URL
https://sphere.galactic.inc/v1

## How It Works

Sphere is a pool-backed binary betting protocol. You pick an asset, direction (UP/DOWN), move size, and time window. The protocol prices the bet using a volatility model and the prize pool takes the other side. If the asset hits the target before expiry, you win; otherwise your stake goes to the pool.

1. `GET /v1/sphere/markets/:asset` — Browse available bets for an asset (multipliers, move sizes, tenors)
2. `POST /v1/sphere/bet` — Place a bet (returns unsigned Solana transaction)
3. Sign the transaction locally with your Solana keypair and submit to mainnet
4. `POST /v1/sphere/bet/confirm` — Confirm your signed deposit to activate the position
5. Settlement is automatic — winners get paid when the position expires

## Underlying Assets (14 Stocks + 3 Crypto = 17 Total)

| Symbol | Name | Solana Mint |
|--------|------|-------------|
| TSLAx | Tesla | XsDoVfqeBukxuZHWhdvWHBhgEHjGNst4MLodqsJHzoB |
| NVDAx | NVIDIA | Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh |
| AAPLx | Apple | XsbEhLAtcf6HdfpFZ5xEMdqW8nfAvcsP5bdudRLJzJp |
| SPYx | S&P 500 ETF | XsoCS1TfEyfFhfvj8EtZ528L3CaKBDBRqRapnBbDF2W |
| QQQx | Invesco QQQ ETF | Xs8S1uUs1zvS2p7iwtsG3b6fkhpvmwz4GYU3gWAmWHZ |
| AMZNx | Amazon | Xs3eBt7uRfJX8QUs4suhyU8p2M6DoUDrJyWBa8LLZsg |
| GOOGLx | Alphabet | XsCPL9dNWBMvFtTmwcCA5v3xWPSMEBCszbQdiLLq6aN |
| METAx | Meta | Xsa62P5mvPszXL1krVUnU5ar38bBSVcWAB6fmPCo5Zu |
| COINx | Coinbase | Xs7ZdzSHLU9ftNJsii5fCeJhoRWSC32SQGzGQtePxNu |
| HOODx | Robinhood | XsvNBAYkrDRNhA7wPHQfX3ZUXZyZLdnCQDfHZ56bzpg |
| MSTRx | MicroStrategy | XsP7xzNPvEHS1m6qfanPUGjNmdnmsLKEoNAnHjdxxyZ |
| CRCLx | Circle | XsueG8BtpquVJX9LVLLEGuViXUungE6WmK5YZ3p3bd1 |
| GLDx | Gold (SPDR) | Xsv9hRk1z5ystj9MhnA7Lq4vjSsLwzL2nxrwmwtD3re |
| MSFTx | Microsoft | XspzcW1PRtgf6Wj92HCiZdjzKCyFekVD8P5Ueh3dRMX |
| BTCx | Bitcoin | — (price oracle only) |
| ETHx | Ethereum | — (price oracle only) |
| SOLx | Solana | — (price oracle only) |

## Market Parameters

- **Tenors**: 60S (60 sec, crypto only), 5M (5 min, crypto only), 1H (1 hour), 1D (24h), 7D, 30D
- **Move Sizes**: 0.02%–20% (varies by tenor and asset)
- **Directions**: UP, DOWN
- **Market ID Format**: `{stock}_{direction}_{moveBps}_{tenor}` (e.g., `TSLAx_UP_500_7D`, `BTCx_UP_1_60S`)
- **Direction-only markets (60S)**: 1 bps move = pure UP/DOWN bet, fixed price 0.51 (~1.96x)
- **Fee**: 5% (500 bps) on your stake at bet time
- **Settlement**: Automated dual oracle (DexScreener + Jupiter for stocks, Kraken + CoinGecko for crypto), every 1 minute. Rapid (60S/5M) uses historical VPS price cache.

### Rapid Markets (60S/5M) — Crypto Only
- **Assets**: BTCx, ETHx, SOLx
- **60S**: Max bet $25, max payout 1/8 pool, 75% liquidity buffer, 20s cash-out cutoff
- **5M**: Max bet $50, max payout 1/6 pool, 65% liquidity buffer, 2-min cash-out cutoff

## Endpoints

### Data
- `GET /v1/stocks` — List all supported assets with mints
- `GET /v1/prices` — Current prices for all assets
- `GET /v1/chart/:symbol` — 30-day price chart (Tiingo, cached 4h)
- `GET /v1/portfolio/:walletAddress` — Wallet balances (SOL, USDC, holdings)

### Single Bets
- `GET /v1/sphere/markets/:asset` — Market grid with multipliers for an asset
- `POST /v1/sphere/bet` — Place a bet (returns unsigned tx)
- `POST /v1/sphere/bet/confirm` — Confirm bet after signing
- `GET /v1/sphere/positions/:wallet` — Your positions and stacks
- `GET /v1/sphere/cashout/quote/:positionId` — Cash-out quote
- `POST /v1/sphere/cashout/execute` — Execute cash-out

### Stacks (Parlays)
- `POST /v1/sphere/stack/bet` — Place a multi-leg parlay (2-5 legs)
- `POST /v1/sphere/stack/bet/confirm` — Confirm stack bet after signing
- `GET /v1/sphere/stack/cashout/quote/:stackId` — Stack cash-out quote
- `POST /v1/sphere/stack/cashout/execute` — Execute stack cash-out

### Rapid Markets (60S/5M Crypto)
- `GET /v1/rapid/markets` — All crypto market grids (60S + 5M, filterable by `?tenor=`)
- `GET /v1/rapid/markets/:asset` — Market grid for a single crypto asset (BTCx, ETHx, SOLx)
- `GET /v1/rapid/price/:asset` — Latest cached price (15s refresh from VPS WebSocket)
- `GET /v1/rapid/chart/:asset` — 30-min price history for chart display
- `GET /v1/rapid/positions/:wallet` — Positions for rapid tenors (60S/5M)
- Rapid bets use the same `POST /v1/sphere/bet` and `POST /v1/sphere/bet/confirm` endpoints with 60S/5M tenor market IDs

### Info
- `GET /v1/sphere/config` — Protocol configuration and limits
- `GET /v1/sphere/volatility` — Current realized volatilities
- `GET /v1/sphere/queue` — Upcoming expirations and recent settlements
- `GET /v1/sphere/leaderboard` — Top 10 wins by payout
- `GET /v1/sphere/share/:id` — Public position/stack lookup

## Quick Example

```
# Place a bet: TSLAx will go UP 5% within 7 days, $100 stake
POST /v1/sphere/bet
{ "marketId": "TSLAx_UP_500_7D", "stake": 100, "wallet": "<your pubkey>" }

# Response includes unsigned tx + bet details
{ "positionId": "abc123...", "unsignedTx": "AQAAAA...", "multiplier": 2.50, "potentialPayout": 242.50, ... }

# Sign the transaction locally, then confirm
POST /v1/sphere/bet/confirm
{ "positionId": "abc123...", "signedTx": "<base64 signed tx>" }

# Position is now ACTIVE — settlement happens automatically at expiry
```

## Key Resources

- Machine-readable manifest: https://sphere.galactic.inc/.well-known/stack.manifest.json
- OpenAPI specification: https://sphere.galactic.inc/openapi.json
- Full documentation: https://sphere.galactic.inc/llms-full.txt