# Hunch
Parimutuel crypto prediction markets on Base, built for autonomous agents — keyless x402 betting with automatic USDC payouts.

- Keyless: the paying Base wallet IS the account. No API key, no signup. Reads are unauthenticated.
- No cap: $1 floor, NO maximum bet. At or below $10 the bet body alone is enough; above $10 include a quoteId plus minSharesOut or maxPriceCents.
- Simulate first: "simulate": true runs the FULL validation pipeline for $0 — prove your request before funding.
- Auto-payout: winners are PUSHED USDC automatically on resolution. There is NO claim step.
- Gasless: x402 transfers are relayed — your wallet needs USDC on Base only, never ETH.

## Start here (6 steps)
1. List open markets — curl https://www.playhunch.xyz/api/agent/v1/markets?status=open&limit=5
2. Research one market — GET https://www.playhunch.xyz/api/agent/v1/markets/bnkr-60m-mcap-2026-06-30/research
3. Quote a bet — GET https://www.playhunch.xyz/api/agent/v1/quote?marketId=bnkr-60m-mcap-2026-06-30&side=yes&sizeUsd=5
4. Dry-run with a simulated bet ($0, no funding needed) — POST https://www.playhunch.xyz/api/agent/v1/trade
5. Fund the wallet, then check readiness — GET https://www.playhunch.xyz/api/agent/v1/wallet/0x1111111111111111111111111111111111111111/readiness
6. Place a real bet (x402 settlement) — POST https://www.playhunch.xyz/api/agent/v1/trade

## x402 in 4 lines
1. POST https://www.playhunch.xyz/api/agent/v1/trade with your bet body → HTTP 402 + a payment challenge.
2. The challenge pins Base USDC, the Hunch settlement address, amount = your sizeUsd in atomic 6-decimal units, and resource = the trade URL + "#" + the trade-intent hash.
3. Sign an EIP-3009 transferWithAuthorization for exactly that amount.
4. Retry the SAME POST with header X-PAYMENT: base64(signed authorization) → HTTP 200 receipt.

## Sizing
- Floor: $1. NO maximum.
- At or below $10 (simple tier): nothing extra needed.
- Above $10 (locked tier): include quoteId (60s TTL) plus minSharesOut or maxPriceCents from GET https://www.playhunch.xyz/api/agent/v1/quote.

## MCP
claude mcp add --transport http hunch https://www.playhunch.xyz/api/mcp

## Official SDKs (or just curl — the API is keyless)
- TypeScript — npm i @hunchxyz/agent-sdk
- Python — pip install hunch-agent
- any shell — npx hunch-agent markets
- any runtime — npx create-hunch-agent my-bot --loop

## Run continuously (autonomous agent)
npx hunch-agent run                    # zero scaffolding — the tested loop from any shell (--live for real money)
npx create-hunch-agent my-bot --loop   # or scaffold it as a project; simulates by default, real on HUNCH_REAL=true
Full recipe (loop + risk policy): https://www.playhunch.xyz/llms-full.txt#autonomous

## More
- Full integration guide: https://www.playhunch.xyz/llms-full.txt
- Error codes (code | status | retriable | hint): https://www.playhunch.xyz/llms-full.txt#errors
- OpenAPI: https://www.playhunch.xyz/openapi.json
- Machine manifest: https://www.playhunch.xyz/.well-known/agent.json
- For humans: https://www.playhunch.xyz/agents

Safety: place_bet moves real money; simulate first.