telegram-gifts-price: Telegram gift floor prices in Python

Get the floor price of any Telegram NFT gift (Plush Pepe, Durov's Cap, Lol Pop and 120 more collections) in GRAM, USD or EUR with one function call. No API key, no dependencies.

Data comes from a free static JSON API built from fragment.com once a day by the open dataset telegram-gifts-floor-price.

Install

pip install telegram-gifts-price

Use

import telegram_gifts_price as tgp

tgp.get_floor("plushpepe")                  # 7500.0   (GRAM)
tgp.get_floor("plushpepe", "usd")           # 8817.0   (at the latest day's rate)
tgp.get_floor("lolpop", fixed_only=True)    # ignore auctions
tgp.collections()                           # ['algorithmcup', 'artisanbrick', ...]
tgp.history("plushpepe")                    # daily points, oldest first
tgp.latest()                                # the whole latest snapshot

Values from 4 Nov 2026. get_floor returns None when there is nothing to report (no fixed-price lot, no stored rate) and raises GiftsError for an unknown collection or when the API is unreachable.

Command line:

gift-floor plushpepe            # 7500.0 GRAM
gift-floor plushpepe -c usd     # 8817.0 USD
gift-floor                      # list collections

What the numbers are

• A floor is the cheapest lot on Fragment, an asking price, not a sale price. Fees are not included.
• floor_gram can be an auction price; use fixed_only=True for the cheapest fixed-price lot.
• GRAM is the coin formerly called TON. USD and EUR use that day's rate from tonapi.io.
• History starts on 4 Nov 2026 and grows by one point a day.

Field definitions and raw CSV: telegram-gifts-floor-price. Live tool with rarity and a net-profit calculator: Telegram Gifts checker on Baltic Assets.

FAQ

Is it free? Yes. It reads static files from GitHub Pages.

How fresh is it? Updated once a day around 06:17 UTC.

Can I use the data in my bot or site? Yes. Data licence CC BY 4.0: credit "Telegram gifts floor prices, Baltic Assets" with a link to https://balticassets.eu. Code is MIT.

License

MIT (code). Data: CC BY 4.0.