Skip to Content
CSGOWINAPI
API v2 Coming soonGiveaways

One giveaway

API v2 - coming soon.

Coming soon

API v2 is not open yet - every request to it answers 404 until it launches, and the details on this page may still change. Build on API v1 today - it keeps working. New keys and a one-step switch will arrive with v2.

No key needed

This read needs no key. Send none: a key sent with it answers 400 bad_request.
GET
/api/v2/giveaways/{id}

One giveaway by its id, as its share link shows it to everyone: for an overlay that follows one giveaway to its winners. Takes no key.

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).

Path Parameters

id*integer

The giveaway id

Range1 <= value

Query Parameters

currency?string

The 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.

Default"COINS"
Value in"COINS""USD""EUR""GBP"

Response Body

OK

application/json
  1. response
giveaway*
serverTime*string

When this answer was made (ISO 8601, UTC)

Formatdate-time
currency?

What the amounts were converted to, when currency was USD, EUR or GBP. Absent for coins

Example Request
curl "https://api.csgowin.com/api/v2/giveaways/41"
Example Response
{  "giveaway": {    "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    }  },  "serverTime": "2026-11-15T14:00:00.000Z"}

Errors

StatusWhenBody
400bad_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":"this read takes no key"}}{"error":{"code":"unknown_currency","message":"currency is one of COINS, USD, EUR, GBP"}}
404not_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"}}
429rate_limited: past a rate limit - wait the Retry-After seconds.{"error":{"code":"rate_limited","message":"too many requests, please try again later."}}
503unavailable: 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."}}