Collections

API ver.: 2.0

Возвращает актуальную информацию по коллекциям Telegram подарков

HTTP запрос

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

Query параметры

Параметр	Описание
limit	UInt Количество элементов в data. Максимум: 500, по умолчанию: 200
offset	UInt Смещение данных для пагинации
fields	String (опционально) Список полей для возврата (через запятую). Если не указан, возвращаются все поля Пример: `fields=id,collection,star_price`

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

HTTP код: 200 - OK

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

Доступные поля

Поле	Описание
_id	String ID коллекции (строковое, алиас для str_id)
id	UInt ID коллекции (Целое число без знака)
str_id	String ID коллекции (Строка)
collection	String Название коллекции
collection_slug	String Слаг коллекции (название коллекции без пробелом и спесимволов)
star_price	UInt Базовая стоимость подарка в Telegram Stars
is_limited	Bool Ограничен ли тираж коллекции?
is_sold_out	Bool Распродана ли коллекция?
first_sale_date	DateTime Дата и время продажи первого подарка в коллекции (UTC +0)
last_sale_date	DateTime Дата и время продажи последнего доступного подарка в коллекции (UTC +0)
total_amount	UInt Объем выпуска коллекции
issued	UInt Максимально доступное количество подарков. Объем выпуска за вычетом подарков, обменянных на звезды и сожженных в результате крафта
minted	UInt Количество улучшенных подарков
non_minted	UInt Количество неулучшенных подарков issued - minted
burned	UInt Количество подарков, обменянных на звезды и сожженных в результате крафта total_amount - issued
blockchain_address	String Адрес коллекции в блокчейне TON

API ver.: 2.0

Была ли статья полезна?

Техническая документация

Collections Floor