Giveaway#

class aiogram.types.giveaway.Giveaway(*, chats: List[Chat], winners_selection_date: datetime, winner_count: int, only_new_members: bool | None = None, has_public_winners: bool | None = None, prize_description: str | None = None, country_codes: List[str] | None = None, premium_subscription_month_count: int | None = None, **extra_data: Any)[source]#

This object represents a message about a scheduled giveaway.

Source: https://core.telegram.org/bots/api#giveaway

chats: List[Chat]#

The list of chats which the user must join to participate in the giveaway

winners_selection_date: DateTime#

Point in time (Unix timestamp) when winners of the giveaway will be selected

winner_count: int#

The number of users which are supposed to be selected as winners of the giveaway

only_new_members: bool | None#

Optional. True, if only users who join the chats after the giveaway started should be eligible to win

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}#

A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

has_public_winners: bool | None#

Optional. True, if the list of giveaway winners will be visible to everyone

prize_description: str | None#

Optional. Description of additional giveaway prize

country_codes: List[str] | None#

Optional. A list of two-letter ISO 3166-1 alpha-2 country codes indicating the countries from which eligible users for the giveaway must come. If empty, then all users can participate in the giveaway. Users with a phone number that was bought on Fragment can always participate in giveaways.

premium_subscription_month_count: int | None#

Optional. The number of months the Telegram Premium subscription won from the giveaway will be active for