# Block Lottos

## What is Block Lottos?

Block Lottos is an on-chain lottery platform running on the Polygon blockchain. It operates the Fortune Ledger, a weekly lottery where players pick 6 numbers between 1 and 49, pay 10 POL (Polygon's native token) per ticket, and compete for a growing jackpot.

The draw takes place every Saturday at 3:00 PM UTC. If no player matches all 6 numbers, the jackpot rolls over to the next week.

## How the lottery works

- Players connect a Web3 wallet (e.g. MetaMask) to blocklottos.com
- Select 6 numbers from 1-49 and purchase a ticket for 10 POL
- Each ticket purchase is recorded on-chain (Polygon mainnet)
- The draw is executed by a verified smart contract using provably fair randomness
- 80% of each ticket sale goes to the jackpot pool; 20% covers operations
- Winners are paid out automatically by the smart contract, no human intermediary

## Smart contract

- Network: Polygon Mainnet
- Contract address: 0x6a41d59260c95c56c704b60defe351bea14f0225
- Verified on Polygonscan

## Affiliate Programme

Block Lottos has an affiliate programme that pays commission in POL for every ticket sold through your referral link. Payouts are instant and on-chain.

### How it works
1. Connect your Polygon wallet at https://blocklottos.com/affiliate
2. Get your unique referral link (your wallet address is your referral code)
3. Share the link anywhere
4. Earn 0.5 POL per ticket purchased through your link, paid instantly to your wallet

### Key details
- Commission: 0.5 POL per ticket (from the 20% operations share, does not reduce the jackpot)
- Payout: Instant, on-chain, directly to your wallet in the same transaction
- Cookie duration: 30 days (first-click attribution)
- No registration required, just connect a wallet
- Self-referrals are blocked by the smart contract
- Single-tier only (direct referrals, not referrals of referrals)

### Affiliate page
https://blocklottos.com/affiliate

## Advertising on Block Lottos

Block Lottos offers paid advertising placements on the website. This is a separate product/service from the lottery itself.

### Ad formats available
- **Banner ads** (728x90) leaderboard banners displayed at the top of pages
- **Listing ads** smaller display placements within page content

### Pricing (paid in POL)
- 7 days: 85 POL
- 14 days: 140 POL
- 30 days: 250 POL
- Submission fee: 1 POL (non-refundable, payable on submission)

### How to advertise
1. Visit https://blocklottos.com/advertise
2. Submit your ad (image + link + display duration)
3. Pay the submission fee (1 POL) on-chain via your Web3 wallet
4. Ads are reviewed and approved before going live

### Advertising API
The advertising system is accessible via a public API, making it bot and agent friendly:
- **API base**: https://blocklottos.com/api/ads/
- **Endpoint**: Submit, query, and manage ad listings programmatically
- Full API documentation: https://blocklottos.com/api-docs

## Public APIs (bot/agent accessible)

All endpoints return JSON. No authentication required for read endpoints. Block Lottos is designed to be bot-friendly and agent-friendly.

- **Jackpot balance**: `GET https://blocklottos.com/api/jackpot.php`
  Returns: `{ "jackpot_pol": float, "jackpot_wei": string, "contract": string, "status": "ok" }`

- **Site stats**: `GET https://blocklottos.com/api/stats.php`
  Returns live stats including total tickets sold, total draws, current jackpot.

- **Ads API**: `https://blocklottos.com/api/ads/`
  Programmatic access to ad listings. See https://blocklottos.com/api-docs for full documentation.

- **OpenAPI spec**: https://blocklottos.com/openapi.json
  Full OpenAPI 3.1 specification for all API endpoints.

- **AI plugin manifest**: https://blocklottos.com/.well-known/ai-plugin.json
  Standard plugin manifest for AI agents and LLM tool-use integrations.

## Key pages

- Homepage: https://blocklottos.com
- Play / Buy tickets: https://blocklottos.com/lotto
- Affiliate programme: https://blocklottos.com/affiliate
- Advertise: https://blocklottos.com/advertise
- API docs: https://blocklottos.com/api-docs
- About: https://blocklottos.com/about
- FAQ: https://blocklottos.com/faq
- Compare vs traditional lottery: https://blocklottos.com/compare
- Contact: https://blocklottos.com/contact

## Who is it for?

- **Lottery players**: Anyone who holds POL (Polygon) and wants to participate in a transparent, blockchain-based lottery. No account required, just a Web3 wallet.
- **Affiliates**: Anyone with an audience or network. Earn 0.5 POL per ticket sold through your referral link. No sign-up, instant payouts.
- **Advertisers**: Businesses and projects in the crypto, Web3, or lottery space looking to reach a targeted audience. Ads can be submitted and managed via the website or the API.
- **Developers / bots / AI agents**: Public APIs, OpenAPI spec, and AI plugin manifest available. The platform is designed for programmatic access.

## Key facts

- Ticket cost: 10 POL
- Numbers: Pick 6 from 1-49
- Draw: Every Saturday, 3:00 PM UTC
- Jackpot split: 80% prize pool, 20% operations
- Affiliate commission: 0.5 POL per referred ticket (instant, on-chain)
- Chain: Polygon Mainnet
- Fairness: Provably fair, on-chain draw
- Website: https://blocklottos.com
- Affiliate: https://blocklottos.com/affiliate
- API: https://blocklottos.com/api/jackpot.php (public, no auth)
- OpenAPI: https://blocklottos.com/openapi.json
- AI plugin: https://blocklottos.com/.well-known/ai-plugin.json
- Contact: support@blocklottos.com