Collections Floor

API ver.: 2.0

Returns historical floor prices for Telegram gift collections

HTTP Request

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

Query Parameters

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

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

HTTP код: 200 - OK

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

Available Fields

Basic Fields (always available)

Field	Description
_id	String String ID
collection	String Collection name
slug	String Collection slug
dt	String Date (format YYYY-MM-DD) for scale=day
dttm	DateTime Date and time (UTC +0) for scale=hour
floor_price	Float Floor price in TON (rounded to 2 decimals)

Additional Fields (available only when marketplace=all)

Field	Description
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
ton_rate	Float TON exchange rate (rounded to 2 decimals)
mcap	Float Market capitalization (rounded to 2 decimals)

API ver.: 2.0

Was the article helpful?

Ton Rate