The giveaways a creator hosts
API v2 - coming soon.
Coming soon
No key needed
The giveaways the code's owner hosts, live (open or being drawn, ending soonest first) or ended (drawn or cancelled, the latest first): the prize, when entries close, the entries, the requirements and, once drawn, the winners, as the site shows them to everyone. The same answer for every caller, so a stream overlay may poll it from any origin without a key. It is cached for 5 seconds and secondsLeft is counted from serverTime. A code whose owner hides their account answers 404, as the site names a hidden account as the host of nothing.
Rate limits: 60 reads a minute per IP across /api/v2 and at most 25 to one path in 2 seconds (429 with Retry-After).
partnerKeyx-apikey<token>Your API v2 key (cgw2_...)
code*stringThe affiliate code (letter case ignored)
1 <= length <= 191status?stringlive: running or being drawn, ending soonest first. ended: drawn or cancelled, the latest end first
"live""live""ended"limit?integerPage size, 1 to 50
1 <= value <= 5020cursor?stringThe nextCursor of the previous page, absent for the first page
length <= 64currency?stringThe currency of the answer's amounts: COINS (the default, the answer as it always was) or USD, EUR or GBP, converted at the rate the site shows and rounded to two decimals as the site writes them. Anything else is a 400 unknown_currency.
"COINS""COINS""USD""EUR""GBP"OK
application/json- response
giveaways*array<>total*integerGiveaways of this status, over all pages
nextCursor*string|nullserverTime*stringWhen this answer was made (ISO 8601, UTC)
date-timecurrency?What the amounts were converted to, when currency was USD, EUR or GBP. Absent for coins
curl "https://api.csgowin.com/api/v2/creators/YOUR_CODE/giveaways"{ "giveaways": [ { "id": 41, "url": "https://csgowin.com/giveaways?id=41", "kind": "community", "status": "live", "name": "Example stream giveaway", "prize": 50, "winnersCount": 2, "startsAt": "2026-11-15T12:00:00.000Z", "endsAt": "2026-11-15T16:00:00.000Z", "drawnAt": null, "secondsLeft": 7200, "host": { "name": "example_creator", "avatar": null, "level": 30, "official": false }, "skin": { "name": "Example Skin (Field-Tested)", "image": "https://example.invalid/skins/1.png", "rarityColor": "#4b69ff" }, "requirements": { "level": 5, "deposit": null, "wager": 100, "timeframeDays": 7, "kyc": false, "discord": false, "affiliateCode": "EXAMPLE-AFFILIATE" }, "entries": 37, "tickets": null, "winners": [], "fairness": { "serverHash": "example-server-hash", "serverSeed": null, "blockNum": null, "blockHash": null } } ], "total": 1, "nextCursor": null, "serverTime": "2026-11-15T14:00:00.000Z"}Errors
| Status | When | Body |
|---|---|---|
| 400 | bad_request: an input outside its rules, a cookie sent, or a refusal by the site (the message says which). unknown_currency: currency is not one of COINS, USD, EUR, GBP. | {"error":{"code":"bad_request","message":"limit: Too small: expected number to be >=1"}}{"error":{"code":"unknown_currency","message":"currency is one of COINS, USD, EUR, GBP"}} |
| 401 | legacy_key: a v1 key - switch to API v2 for a v2 key. invalid_key: not a live API v2 key, or the code is not one of its account’s codes. | {"error":{"code":"legacy_key","message":"this is a v1 key: switch to API v2 in Profile > Affiliates > API key to get a v2 key"}}{"error":{"code":"invalid_key","message":"the key is not a live API v2 key of this code"}} |
| 403 | key_blocked: API v2 is blocked for the account - contact support (a new key does not lift it). account_restricted: the account is restricted - contact support. | {"error":{"code":"key_blocked","message":"this key is blocked: contact support"}}{"error":{"code":"account_restricted","message":"this account is restricted: contact support"}} |
| 404 | not_found: no such giveaway, case or period, or the code has no board or giveaways (also every request while API v2 is not open, and every action while actions are not open). | {"error":{"code":"not_found","message":"not found"}} |
| 429 | rate_limited: past a rate limit - wait the Retry-After seconds. | {"error":{"code":"rate_limited","message":"too many requests, please try again later."}} |
| 503 | unavailable: not available for a moment and nothing was done - try again after the Retry-After seconds. | {"error":{"code":"unavailable","message":"temporarily unavailable, please try again shortly."}} |
Redemptions of the promo codes linked to a code, per day GET
How often each promo code support linked to the code was redeemed per UTC day over a window (at most 366 days, default the last 30), every day present: which campaign worked when. Rate limits: 60 reads a minute per IP across /api/v2 and at most 25 to one path in 2 seconds (429 with Retry-After), and 60 a minute per account across its keyed reads.
Host a giveaway from your balance POST
Hosts a community giveaway as the site's Giveaways page does: the prize is paid from your real balance at once and counts against the key's daily limit. The site's own rules apply (a prize of at least 10 coins and 1 per winner, 1 to 50 winners, entries closing 1 minute to 31 days from now) and its refusals answer 400 with its text (an insufficient balance, a block). affiliateOnly limits entries to players referred by the code in the path. In the example, replace YOUR_END_TIME with the time entries close, written as endsAt is in the answer. 10 a day. Rate limits: 5 actions a minute per account (429 rate_limited), this action’s count per UTC day (429 action_limit_reached, Retry-After to 00:00 UTC), and 120 actions a minute across the site (503 unavailable with Retry-After).