# Aggregator.Casino

> HTTP-native casino for autonomous AI agents. Deposit USDC via x402 protocol, spin real slots from licensed providers, cash out on-chain. No accounts, no KYC, pure API.

## Documentation
- Full API reference with examples: https://testnet.aggregator.casino/docs
- Detailed machine-readable index: https://testnet.aggregator.casino/llms-full.txt

## API endpoints
- Base URL: `https://testnet.aggregator.casino/api/v1/agent`
- `GET /auth/challenge?address=0x...` — get wallet auth challenge
- `POST /auth/verify` — verify signature, get Bearer token (valid 7 days)
- `GET /games` — list available games (public, no auth needed)
- `POST /sessions` — create game session + deposit USDC via x402
- `GET /sessions/{id}` — get session details and recent spins
- `POST /sessions/{id}/spin` — place a bet (min 3s between spins)
- `POST /sessions/{id}/cashout` — withdraw balance on-chain

## Quick start (testnet)
On testnet, x402 payment verification accepts any non-empty X-PAYMENT header — no real USDC needed:
1. GET /auth/challenge?address=0xYourWallet → sign the returned message
2. POST /auth/verify with {address, signature, challenge_token} → get Bearer token
3. GET /games → pick a game_id
4. POST /sessions with {game_id, deposit_usd} + header X-PAYMENT: test → get session_id
5. POST /sessions/{id}/spin with {bet_usd: 1.00} → get result, payout, balance
6. POST /sessions/{id}/cashout → get USDC withdrawal tx_hash

## Authentication
- Wallet-based: Ethereum signature (SIWE-style), no accounts or API keys
- Token: Bearer token via Authorization header, valid 7 days
- Public endpoints (no auth): /auth/challenge, /auth/verify, /games

## Protocol
- Payment: x402 — USDC on Base Sepolia (testnet) / Base mainnet (production)
- Testnet chain: 84532, USDC: 0x036CbD53842c5426634e7929541eC2318f3dCF7e
- Testnet shortcut: any non-empty X-PAYMENT header bypasses real payment

## Integration
- MCP server: `@theaggregator/mcp-server` (npm)
- TypeScript SDK: `@theaggregator/sdk` (npm)
- Python: `pip install eth-account requests` — see /docs for full example
- Parent platform: [The Aggregator](https://the-aggregator.io)

## Game providers
- TRUE LABS — 50+ games (LIVE on testnet)
- BGaming — 100+ games (LIVE on testnet)
- Pragmatic Play, Play'n GO, Push Gaming, Hacksaw Gaming — coming soon

## Safety notes
- This is a **testnet** — use Base Sepolia USDC only (or testnet bypass)
- Real licensed casino games from production providers
- For production/mainnet access, onboard via the-aggregator.io