payments.getStarGiftActiveAuctions

Fetches all currently active gift auctions the user has ever bid on (including auctions where the user was outbid and their bid was returned), as long as the auction hasn't ended yet.

This method is primarily used to display an auction badge in the chat list immediately on app startup, without waiting for real-time updateStarGiftAuctionState updates to arrive: the client calls it to discover which auctions the user is participating in and show the badge proactively.

To instead fetch the full state of a single auction, subscribe to its real-time updates and render the detailed auction UI (typically when the user opens a specific auction), use payments.getStarGiftAuctionState.

 Method schema is available as of layer 218. Switch »

Parameters

Name Type Description
hash long Hash generated as specified here »

Result

payments.StarGiftActiveAuctions

Only users can use this method

Related pages

Collectible gift auctions

New collectible gift releases are distributed through Stars auctions held over several rounds.

updateStarGiftAuctionState

Contains updates to auction state, see here » for more info on how to enable these updates.

payments.getStarGiftAuctionState

Returns info about a collectible gift auction »; also subscribes the user to auction updates, see here » for more info on the full flow.