GiftChecker

Use this to compare 2 to 5 collections ("Plush Pepe"), models ("Plush Pepe / Heart") or numbered gifts ("plushpepe-9998") by price estimate, rarity and supply in one call. An item that does not match is listed with suggestions. Do not use it for one item.

Use this for a backdrop colour such as "Black": rarity and observed prices. With a collection it gives that collection's backdrop; without one it lists every collection where the backdrop appears. Do not use it for models or symbols. The Telegram ask is a TON price (telegram_ask_ton); telegram_ask_stars is that ask at the display rate, approximate.

Use this for a Telegram gift collection such as "Plush Pepe": lowest published price estimate in Stars, TON and USD, supply, the 24h and 7d change of its lowest ask (there is no longer price history), and its models with their price estimates and rarity. Do not use it for market-wide rankings (top_collections) or for current listings (where_to_buy).

Use this to look up one numbered upgraded Telegram gift, for example Plush Pepe #9998: traits (model, backdrop, symbol), rarity, the published price estimate in Stars, TON and USD, recent sales and the active listing. Give collection and number, or a slug such as "plushpepe-9998". Do not use it for a whole collection (get_collection), to find the cheapest places to buy (where_to_buy) or to find who owns a gift (not available).

Use this for one model of a collection (for example Plush Pepe / Heart): rarity, lowest estimate in Stars, TON and USD, price estimate by backdrop and observed asks and sale floors. The Telegram ask is a TON price (telegram_ask_ton); telegram_ask_stars is that ask at the display rate, approximate. Do not use it for one numbered gift (get_gift).

Use this only when the user names a Telegram @username and wants the gifts that profile publicly shows on its GiftChecker page (/u/<username>): counts, the valuation in Stars and up to 20 numbered gifts. Users who hid their page or are not known answer not_found. Never returns wallets or balances. Do not use it to search for people or to list portfolios.

Use this for a gift symbol (the pattern on a gift, for example "Ruby") and its rarity, in one collection or across all. If symbol data is not stored yet the result says available=false; do not guess a rarity. Do not use it for models or backdrops.

Use this only to convert a price in Telegram Stars into TON or USD at the display rates GiftChecker uses. Do not use it to look up what a gift costs.

Use this for the latest completed sales of a collection or one model in the last 90 days, with price in TON, Stars and USD, the marketplace and the date. Do not use it for current asking prices (where_to_buy), for the price estimate (get_collection, get_model) or for the sales of one numbered gift (get_gift).

Use this when a name may be misspelled, is in Russian or you do not know the kind: fuzzy search over collection, model and backdrop names, returning the best matches with their giftcheckertg.com URLs. Do not use it for prices; open a match with get_collection or get_model. When the user already gave an exact English name, call the get_ tool directly instead.

Use this for the market overview: which collections trade most, have the lowest or highest ask, or the most listings, with the lowest ask in Stars, TON and USD, the number of Telegram listings and MRKT plus Portals sales and TON volume in the last 24 hours, plus the 24h and 7d change of the lowest ask (from the stored floor change log; null when a collection had no ask then). Do not use it for one named collection (get_collection).

Use this when the user wants to buy: the cheapest stored active listings of a collection, model, backdrop or one numbered gift, each with marketplace, price in Stars, TON and USD and the link that opens it, plus the stored Portals ask floor. It reads stored listings, not a live marketplace, and never places an order. Do not use it for what a gift is worth (get_gift) or for past sales (recent_sales).