# SocioLogic RNG API

> Cryptographically secure random number generation API with x402 micropayments on Base (Ethereum L2).

SocioLogic RNG provides verifiable entropy for AI agents, games, simulations, and any application requiring unbiased randomness. Pay per call with USDC via the x402 protocol.

## Documentation

- [API Overview](https://rng.sociologic.ai/): API info, pricing, and endpoint list
- [x402 Discovery](https://rng.sociologic.ai/.well-known/x402): x402 payment manifest with ownership proof
- [x402 Manifest](https://rng.sociologic.ai/.well-known/x402.json): Machine-readable payment configuration
- [Full Documentation](https://rng.sociologic.ai/llms-full.txt): Complete API reference in one file

## Endpoints

### Standard Tier ($0.01/call)
- [/random](https://rng.sociologic.ai/random): Random float between 0 and 1
- [/random/int](https://rng.sociologic.ai/random/int): Random integer in range (query: min, max)
- [/uuid](https://rng.sociologic.ai/uuid): Generate UUID v4

### Extended Tier ($0.02/call)
- [/dice](https://rng.sociologic.ai/dice): Roll a die (query: sides, default 6)
- [/coin](https://rng.sociologic.ai/coin): Flip a coin (heads/tails)
- [/shuffle](https://rng.sociologic.ai/shuffle): POST array to shuffle (Fisher-Yates)
- [/weighted](https://rng.sociologic.ai/weighted): POST weighted random selection

## Payment

- Protocol: x402
- Network: Base Mainnet (Chain ID: 8453)
- Currency: USDC
- Facilitator: Coinbase Developer Platform

## Optional

- [Health Check](https://rng.sociologic.ai/health): Service status