# Block Lottos API

**Canonical:** https://apis.io/apis/blocklottos-com/block-lottos-api/  
**Provider:** Block Lottos — https://apis.io/providers/blocklottos-com/  
**Base URL:** https://blocklottos.com  
**Documentation:** https://blocklottos.com/api-docs

Block Lottos API is published by [Block Lottos](https://apis.io/providers/blocklottos-com/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Lottery, Advertising, AI Agents, Affiliate Marketing, and Blockchain. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and rate-limit docs.

Public Block Lottos API (OpenAPI 3.1.0, v1.2.0, 20 operations, no API key) covering lottery reads for Polygon Fortune Ledger and Base Future Ledger (jackpot, stats, draw history, draw proof, wallet tickets, prize checks), unsigned ticket-transaction building, the Base-first agent flow (agent-capabilities, agent-referral, agent-purchase, confirm-ticket-tx) and a quote-first USDC banner advertising API (sizes, submit, submit/pay, status, wallet lookup, activate, activate/pay). All responses are JSON; rate limits are per IP with a Retry-After header on 429.

## Operations (20)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/jackpot.php` | Get current jackpot |
| GET | `/api/stats.php` | Get site stats |
| GET | `/api/ads/sizes` | Get available ad sizes and pricing |
| POST | `/api/ads/submit` | Submit an ad (quote-first flow, step 1) |
| POST | `/api/ads/submit/pay` | Confirm ad payment (quote-first flow, step 2) |
| GET | `/api/ads/status/{submission_id}` | Check ad submission status |
| GET | `/api/ads/wallet/{wallet_address}` | Get all ads for a wallet |
| POST | `/api/lottery/build-ticket-tx` | Build an unsigned lottery ticket transaction |
| GET | `/api/lottery/tickets/{wallet}` | Get wallet tickets for the active draw |
| GET | `/api/lottery/draw-history` | Get lottery draw history |
| GET | `/api/lottery/draw-proof` | Get public draw proof |
| GET | `/api/lottery/check-prizes/{wallet}` | Check outstanding failed prize payout for a wallet |
| POST | `/api/ads/activate` | Request an ad activation quote |
| POST | `/api/ads/activate/pay` | Confirm ad activation payment |
| GET | `/api/lottery/jackpot` | Get current jackpot |
| GET | `/api/lottery/stats` | Get site stats |
| GET | `/api/lottery/agent-capabilities` | Get live Base-first agent capabilities |
| POST | `/api/lottery/agent-referral` | Create or load one shared multi-chain affiliate profile |
| POST | `/api/lottery/agent-purchase` | Prepare one bounded Base USDC ticket purchase |
| POST | `/api/lottery/confirm-ticket-tx` | Verify a Base ticket purchase on chain |

## Machine-readable artifacts (12)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/blocklottos-com/refs/heads/main/openapi/blocklottos-com-openapi.yml
- **OpenAPI** — https://blocklottos.com/openapi.json
- **Documentation** — https://blocklottos.com/api-docs
- **APIReference** — https://blocklottos.com/api-docs
- **GettingStarted** — https://blocklottos.com/api-docs#ads-quickstart
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/blocklottos-com/refs/heads/main/rate-limits/blocklottos-com-rate-limits.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/blocklottos-com/refs/heads/main/errors/blocklottos-com-problem-types.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/blocklottos-com/refs/heads/main/overlays/blocklottos-com-openapi-overlay.yaml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/blocklottos-com/refs/heads/main/data-model/blocklottos-com-data-model.yml
- **Examples** — https://raw.githubusercontent.com/api-evangelist/blocklottos-com/refs/heads/main/examples/blocklottos-com-examples.yml
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/blocklottos-com/refs/heads/main/mcp/blocklottos-com-tool-crosswalk.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/blocklottos-com/refs/heads/main/apis.yml

## Tags

Lottery, Advertising, AI Agents, Affiliate Marketing, Blockchain, Base, Polygon

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/blocklottos-com/block-lottos-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/blocklottos-com/.