Developer API ReferenceComing Soon
Giveaways & Proofs API
Manage audience raffles programmatically and query verifiable cryptographic proof bundles.
API Status: Coming Soon
The Giveaways & Proofs REST API is currently in development and is not yet publicly released. The endpoints below demonstrate the planned service specification.
List Active Giveaways
GET/api/v1/public/giveaways
Auth: PublicReturns active public giveaways currently accepting entries.
curl -X GET "https://buzzeee.com/api/v1/public/giveaways?limit=10"Create a Giveaway
POST/api/v1/giveaways
Auth: RequiredCreates a new giveaway and automatically publishes the initial SHA-256 server seed commitment.
| Field | Type | Required | Description |
|---|---|---|---|
| title | string | Yes | Headline for the prize (e.g. "$500 Raw Crypto Giveaway"). |
| winnerCount | number | No (default 1) | Number of distinct winners to draw. |
| entryKeyword | string | No | Chat command that registers an entry (e.g. "!win"). |
curl -X POST https://buzzeee.com/api/v1/giveaways \
-H "x-api-key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"title": "$250 Stream Cash Giveaway",
"winnerCount": 1,
"entryKeyword": "!win"
}'Fetch Cryptographic Proof Bundle
GET/api/v1/public/giveaways/:id/proof
Auth: PublicRetrieves the immutable verification bundle containing revealed seed, entrant manifest, and winner draw data.
Sample Proof Bundle Response (JSON)
{
"algorithmVersion": "1.0.0",
"giveawayId": "gw_clx891ab001",
"serverSeed": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"serverSeedHash": "ca978112ca1bbdcafac231b39a23dc4da786eff8147c4e72b9807785afee48bb",
"clientSeed": "kick_stream_session_42",
"manifestHash": "8f434346648f6b96df89dda901c5176b10a6d83961dd3c1ac88b59b2dc327aa4",
"uniqueWinners": true,
"result": {
"winners": [
{
"rank": 1,
"platform": "KICK",
"username": "LuckyViewer99",
"drawIndex": 0,
"digest": "7d793037a0760186574b0282f2f435e7...32b"
}
]
}
}