Reading Telegram's gift catalogue with the Bot API: getAvailableGifts, prices and supply
A bot can read Telegram's gift catalogue with one parameterless call, getAvailableGifts , and the answer carries each gift's price in Stars and, for limited gifts, how many are left. As of November 2026 the regular gifts in our data cost between 15 and 100 Stars each, and the limited ones go far higher. This post turns the raw response into a sorted price list with sold-out percentages, and shows…
A Telegram bot can obtain a list of gifts with a single call to getAvailableGifts, which provides each gift's price in Stars and, for limited gifts, the remaining count. As of November 2026, regular gifts range from 15 to 100 Stars, while limited gifts can have much higher prices. This post converts the raw response into a sorted price list with sold-out percentages and demonstrates how to validate it against a reference.
The getAvailableGifts function returns a Gifts object containing an array of Gift objects. Each Gift has an id, star_count, and optional upgrade_star_count, is_premium, total_count, remaining_count, and unique_gift_variant_count. The id is a 19-digit string, so it must be kept as a string. The response is mapped to a Row object, which includes the gift's id, stars, upgrade count, limited status, premiumOnly flag, and optional soldPct.
The function sorts the rows by price and returns an array of Row objects. The code demonstrates how to test the function with a fetch-like argument and a sample payload containing three real gift IDs and prices.
Rewritten by urgent.news; may contain errors — check the original.