> For the complete documentation index, see [llms.txt](https://bohd4nx.gitbook.io/pyfragment/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bohd4nx.gitbook.io/pyfragment/api-guides/premium/giveaway.md).

# Giveaway

Use this method to run a Telegram Premium giveaway for your channel.

## Method

```python
await client.giveaway_premium(
    channel: str,
    winners: int,
    months: int = 3,
    payment_method: PaymentMethod = PaymentMethod.GRAM,
) -> PremiumGiveawayResult
```

## Parameters

* `channel`: accepts `@channel`, `channel`, or `https://t.me/channel`
* `winners`: integer from `1` to `24_000`
* `months`: one of `3`, `6`, `12`
* `payment_method`: `PaymentMethod.GRAM` (default), `PaymentMethod.USDT_GRAM`, or any other `PaymentMethod` value

**`winners` must be a positive integer, and large values can increase total cost significantly.**

## Return

* `PremiumGiveawayResult(transaction_id, channel, winners, amount, confirmed)`

`confirmed` reflects Fragment's own post-broadcast acknowledgement, not whether the transfer happened — see [Result Models](/pyfragment/reference/models.md#confirmed).

## Typical errors

* `ConfigurationError`
* `UserNotFoundError`
* `WalletError`
* `VerificationError`

## Example

```python
result: PremiumGiveawayResult = await client.giveaway_premium("@channel", winners=100, months=3)
print(result.amount)
```