Collections Floor

API ver.: 2.0

Returns current floor prices for Telegram gift collections

HTTP Request

GET https://api.giftstat.app/current/collections/floor

Query Parameters

Parameter	Description
limit	UInt Number of elements in data. Maximum: 500, default: 200
offset	UInt Data offset for pagination
marketplace	String (optional) Filter by marketplace. Default: `all` Available values: `all`, `portals`, `tonnel`, `fragment`, `getgems`, `mrkt`
fields	String (optional) Comma-separated list of fields to return. If not specified, all fields are returned

Структура ответа

HTTP код: 200 - OK

{
    "data": [],
    "meta": {
        "limit": 200, 
        "offset": 0,
        "count": 0,
        "api_path": "/current/collections/floor",
    }
}

Available Fields

Basic Fields (always available)

Field	Description
_id	String String collection ID
collection	String Collection name
slug	String Collection slug (name without spaces and special characters)
floor_price	Float Current floor price in TON (rounded to 2 decimals)
floor_price_prev1day	Float Floor price 1 day ago
floor_price_prev7day	Float Floor price 7 days ago
floor_price_prev30day	Float Floor price 30 days ago
marketplace	String Marketplace name (available for `portals`, `tonnel`, `fragment`, `getgems`, `mrkt`)

Additional Fields (available only when marketplace=all)

Field	Description
star_price	UInt Gift price in stars
is_limited	Bool Is the collection limited edition?
is_sold_out	Bool Is the collection sold out?
first_sale_date	DateTime First sale date
last_sale_date	DateTime Last sale date
total_amount	UInt Total collection supply
issued	UInt Maximum available quantity
minted	UInt Number of minted gifts
non_minted	UInt Number of non-minted gifts
burned	UInt Exchanged for stars
mcap	Float Market capitalization (rounded to 2 decimals)
mcap_prev1day	Float Market capitalization 1 day ago
mcap_prev7day	Float Market capitalization 7 days ago
mcap_prev30day	Float Market capitalization 30 days ago
ton_rate	Float TON exchange rate (rounded to 2 decimals)
ton_rate_prev1day	Float TON rate 1 day ago
ton_rate_prev7day	Float TON rate 7 days ago
ton_rate_prev30day	Float TON rate 30 days ago
tonnel_floor_price	Float Floor price on Tonnel
portals_floor_price	Float Floor price on Portals
mrkt_floor_price	Float Floor price on MRKT
fragment_floor_price	Float Floor price on Fragment
getgems_floor_price	Float Floor price on Getgems

API ver.: 2.0

Was the article helpful?

Collections

Gifts