Get collectible gifts of a specific type currently on resale, see here » for more info.
sort_by_price and sort_by_num are mutually exclusive, if neither are set results are sorted by the unixtime (descending) when their resell price was last changed.
Method schema is available as of layer 203. Switch »
| Name | Type | Description |
|---|---|---|
| flags | # | Flags, see TL conditional fields |
| sort_by_price | flags.1?true | Sort gifts by price (ascending). |
| sort_by_num | flags.2?true | Sort gifts by number (ascending). |
| attributes_hash | flags.0?long | If a previous call to the method was made and payments.resaleStarGifts.attributes_hash was set, pass it here to avoid returning any results if they haven't changed. Otherwise, set this flag and pass 0 to return payments.resaleStarGifts.attributes_hash and payments.resaleStarGifts.attributes, these two fields will not be set if this flag is not set. |
| gift_id | long | Mandatory identifier of the base gift from which the collectible gift was upgraded. |
| attributes | flags.3?Vector<StarGiftAttributeId> | Optionally filter gifts with the specified attributes. If no attributes of a specific type are specified, all attributes of that type are allowed. |
| offset | string | Offset for pagination. If not equal to an empty string, payments.resaleStarGifts.counters will not be set to avoid returning the counters every time a new page is fetched. |
| limit | int | Maximum number of results to return, see pagination |
| Code | Type | Description |
|---|---|---|
| 400 | STARGIFT_INVALID | The passed gift is invalid. |
List of gifts currently on resale ».
How to fetch results from large lists of objects.
Users can send Gifts to their friends. The recipients of gifts can display them on their profile pages or turn them into Telegram Stars ». Telegram Stars can be used for many things, including supporting creators and buying services in mini apps.