Contains information about the current user's state in an auction ».
The bid_amount, bid_date, bid_peer and min_bid_amount flags of starGiftAuctionUserState will all be set if the user placed a bid in the auction.
Constructor schema is available as of layer 218. Switch »| Name | Type | Description |
|---|---|---|
| flags | # | Flags, see TL conditional fields |
| returned | flags.1?true | If set, the placed bid was returned to the user, because it was outbid so much that it fell out of the top starGiftAuctionState.gifts_left positions, meaning that even if no new bids are placed, the user will never receive any gifts, so the bid was completely removed from the auction, and in order to participate again the user must manually make a new bid. |
| bid_amount | flags.0?long | Contains the amount of the placed bid in Telegram Stars. |
| bid_date | flags.0?int | Contains a UNIX timestamp, indicating when the bid was placed. |
| min_bid_amount | flags.0?long | Contains the minumum allowed bid amount in Telegram Stars, if set overrides starGiftAuctionState.min_bid_amount for the current user. |
| bid_peer | flags.0?Peer | Contains the peer that will receive the gift, if you end up winning this round |
| acquired_count | int | Contains the number of gifts that were purchased so far in the auction by the current user. |
Represents an active or pending auction ».
Telegram Stars are virtual items that allow users to purchase digital goods and services from bots and mini apps inside the Telegram ecosystem, send gifts to content creators on the Telegram platform, and more.
Contains information about the current user's state in an auction ».
The bid_amount, bid_date, bid_peer and min_bid_amount flags of starGiftAuctionUserState will all be set if the user placed a bid in the auction.