Block Lottos API
Public Block Lottos API for Polygon and Base lottery data, advertising, affiliates, and a Base-first non-custodial agent purchase flow. A verified winning…
Finance & banking#cryptocurrency
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Public Block Lottos API for Polygon and Base lottery data, advertising, affiliates, and a Base-first non-custodial agent purchase flow. A verified winning Polygon ticket receives at least 100 POL and a verified winning Base ticket receives at least 100 USDC; a higher current jackpot applies when it exceeds the minimum.
Endpoints 20
Lottery
- GETGet current jackpot
/api/jackpot.phpReturns the selected game’s live on-chain jackpot, its published minimum winner payout, and the payable winner amount, which is the higher of those values.… - GETGet site stats
/api/stats.phpReturns the selected game’s live on-chain jackpot, its published minimum winner payout, and the payable winner amount, which is the higher of those values.… - POSTBuild an unsigned lottery ticket transaction
/api/lottery/build-ticket-txBuilds transaction data for buying a lottery ticket. Polygon returns a native POL value transaction. Base returns a USDC approval transaction plus a… - GETGet wallet tickets for the active draw
/api/lottery/tickets/:walletReturns tickets purchased by a wallet for the active draw on Polygon or Base. - GETGet lottery draw history
/api/lottery/draw-historyReturns recent completed on-chain draw results from Polygon or Base. If no on-chain draw has completed yet, returns published public draw results from the… - GETGet public draw proof
/api/lottery/draw-proofReturns the public cutoff commitment or completed draw proof for Polygon Fortune Ledger or Base Future Ledger. During cutoff, winning numbers and the secret… - GETCheck outstanding failed prize payout for a wallet
/api/lottery/check-prizes/:walletChecks whether a wallet has an outstanding failed on-chain prize transfer that can be retried through retrySendPrize(). This endpoint covers contract transfer… - GETGet current jackpot
/api/lottery/jackpotReturns the selected game’s live on-chain jackpot, its published minimum winner payout, and the payable winner amount, which is the higher of those values.… - GETGet site stats
/api/lottery/statsReturns the selected game’s live on-chain jackpot, its published minimum winner payout, and the payable winner amount, which is the higher of those values.… - GETGet live Base-first agent capabilities
/api/lottery/agent-capabilitiesReturns authoritative Base USDC payment details, on-chain jackpot, 100 USDC minimum winner payout, payable winner amount, complete purchase workflow, referral… - POSTCreate or load one shared multi-chain affiliate profile
/api/lottery/agent-referralOne shared affiliate profile for humans, bots, agents, and LLMs. Secure enrollment is two-step: request action=challenge, sign the returned message with the… - POSTPrepare one bounded Base USDC ticket purchase
/api/lottery/agent-purchaseBase-only non-custodial endpoint. Each call prepares exactly one ticket to prevent accidental batching; agents may make multiple purchase calls for as many… - POSTVerify a Base ticket purchase on chain
/api/lottery/confirm-ticket-txChecks receipt success, sender, active contract, purchase selector and TicketPurchased event before recording private agent attribution.
Advertising
- GETGet available ad sizes and pricing
/api/ads/sizesReturns all available banner sizes with dimensions, pricing for 7/14/30 day durations, submission fee, and any active discounts. Rate limit: 2 requests/min/IP. - POSTSubmit an ad (quote-first flow, step 1)
/api/ads/submitSubmit ad details and an image to get a payment quote. Returns a quote_id and an unsigned USDC transfer transaction. The caller signs and broadcasts the… - POSTConfirm ad payment (quote-first flow, step 2)
/api/ads/submit/payAfter broadcasting the USDC payment transaction, call this endpoint with quote_id and transaction hash to finalise the submission. The system verifies the… - GETCheck ad submission status
/api/ads/status/:submission_idReturns the current status of a submitted ad. Rate limit: 2 requests/min/IP. - GETGet all ads for a wallet
/api/ads/wallet/:wallet_addressReturns all ad submissions associated with an EVM wallet address. Useful for bots to discover their submission IDs and track statuses. Rate limit: 2… - POSTRequest an ad activation quote
/api/ads/activateRequest an activation quote for an approved ad. Returns current duration pricing and an unsigned USDC transfer transaction. Accepts application/json or… - POSTConfirm ad activation payment
/api/ads/activate/payAfter broadcasting the USDC activation payment transaction, call this endpoint with quote_id and transaction hash. The system verifies payment on-chain before…
API details
- Base URL
https://blocklottos.com- Authentication
- None declared in the description
- Operations
- 20 operations on 20 pathsGET 12POST 8
- Main resources
- Lottery 13Advertising 7Agents 4Affiliate 1
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
1.2.0 - Links
- Documentation · OpenAPI document · Support
- Listed from
- Blocklottos's published OpenAPI description
How to test the Block Lottos API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Block Lottos API collection, without the publisher's secrets.
- Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
- Send a requestPick an endpoint, for example “Get current jackpot” (GET /api/jackpot.php), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Block Lottos API?
Public Block Lottos API for Polygon and Base lottery data, advertising, affiliates, and a Base-first non-custodial agent purchase flow. A verified winning… It is listed under Finance & banking and has 20 endpoints.
Who publishes the Block Lottos API?
It is listed from Block Lottos's public API description (an OpenAPI document), not published by Block Lottos on Swastik Codes. Anyone who controls blocklottos.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Block Lottos API?
Requests go to https://blocklottos.com. Endpoint paths are added to this base URL.
How do I authenticate with the Block Lottos API?
Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.
How many endpoints does the Block Lottos API have?
20 operations on 20 paths (12 GET, 8 POST). The largest groups are Lottery, Advertising, Agents, Affiliate.
Is forking the Block Lottos API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.