# HouseMath — Blockchain gambling intelligence for AI agents — tracked degen-game directory, on-chain risk audits, and live EV / house-edge math. Per-call, no signup. Analytics only — never buy/sell advice; analysis is not an endorsement; gambling involves risk of total loss. (v1.0.0)

> HouseMath is a multi-protocol degen-game analytics API — blockchain gambling intelligence.
> FREE: GET /v1/games lists tracked protocols; GET /v1/games/{key} returns a live EV /
> house-edge headline computed from on-chain state; GET /v1/games/{key}/audit returns the
> full published risk audit with findings. All v1 routes are free; a paid historical
> metric time-series tier is coming.
> Analytics only — never buy/sell advice; analysis is not an endorsement; gambling involves risk of total loss.

## Base URL
- API: https://api.housemath.dev
- This document: https://api.housemath.dev/llms.txt  ·  Extended: https://api.housemath.dev/llms-full.txt
- Discovery (JSON): https://api.housemath.dev/discovery
- OpenAPI 3.1: https://api.housemath.dev/openapi.json
- x402 manifest: https://api.housemath.dev/.well-known/x402
- Agent card (A2A): https://api.housemath.dev/.well-known/agent-card.json
- Terms: https://api.housemath.dev/terms.txt

## Free endpoints (no auth, no payment)

| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/games | Free, no payment. Lists every tracked degen-game protocol (identity + category + chain + status + published risk grade). Use a protocol's `key` in the per-protocol routes. (rate limit: 30/min) |
| GET | /v1/games/:key | Free, no payment. One protocol's headline: identity + risk grade + LIVE analytics (EV per pull, house edge, pull price) computed from on-chain state, plus freshness. If a live read is temporarily unavailable, `analytics` is null with a note (never a 500). (rate limit: 30/min) |
| GET | /v1/games/:key/audit | Free, no payment. The published contract risk audit for a protocol: overall risk, summary, methodology, scope, and the findings list (code / severity / category / title / summary / status). Full finding `detail` is omitted from the list; add ?full=1 to include it. 404 if no audit is published for that protocol. (rate limit: 30/min) |

## How to pay (x402)
Each paid call answers a 402 challenge; sign an x402 `exact` USDC authorization for one advertised rail (Base or Solana) and retry. Standard @x402 V2 clients send the `PAYMENT-SIGNATURE` header; legacy clients send `X-PAYMENT`. Prices are USD, settled as USDC (6 decimals).

## Links
- Docs: https://api.housemath.dev/llms.txt
- Full: https://api.housemath.dev/llms-full.txt
- OpenAPI: https://api.housemath.dev/openapi.json
- Discovery: https://api.housemath.dev/discovery
- Agent card: https://api.housemath.dev/.well-known/agent-card.json
- Website: https://housemath.dev

## What HouseMath is (and is not)
HouseMath analyzes on-chain "degen games" (NFT gacha, timer games, etc.): expected value per pull, house edge, exit-liquidity risk, plus a published contract risk audit per protocol. Everything served is either a database row (directory, audit, historical series) or a live computation from on-chain state, labelled with its source block/time. HouseMath is ANALYTICS ONLY: it is never buy/sell advice, an analysis is not an endorsement of any protocol, and on-chain gambling carries risk of total loss.

## Multi-protocol by construction
Protocols are database rows, not routes. GET /v1/games enumerates every tracked protocol; use its `key` (e.g. "fwa") in the per-protocol routes. Historical series may be empty for a freshly-tracked protocol whose collector has not yet run — the history route returns an empty series with a note and does NOT charge in that case.