GIFTGRAM API

Как пользоваться API

Скопируйте пример ниже и отправьте запрос. Регистрация и ключ API не нужны.

1. Выберите подарок

Из ссылки t.me/nft/PlushPepe-161 возьмите PlushPepe-161. Название коллекции можно найти в .

2. Отправьте запрос

3. Обработайте ответ

data — данные, meta — время ответа, error — ошибка. Цены передаются строками. Валюта указана в currency.

price: null — цены пока нет. currency: null — валюта неизвестна. Текущее состояние указано в status.

ЗАПРОСЫ К API

Методы API

Выберите, что хотите узнать: цены, характеристики подарка или его историю.

Когда обновлялись цены

Дата рядом с ценой показывает, когда её обновили. Предложения старше часа отмечены stale: true и не входят в текущую минимальную цену.

«Модель + фон» — цена именно этого сочетания. Если свежей цены нет, последняя известная цена приходит в last_known вместе с датой.

ПОПРОБУЙТЕ API

Попробуйте прямо здесь

Выберите запрос, укажите подарок и нажмите кнопку. Ответ появится ниже.

GET

Ожидание запроса

// Нажмите «Выполнить запрос».
// Здесь появится реальный JSON-ответ.

Лимит: 1 000 / сутки на IP

ПРОСТЫЕ ПРАВИЛА

Бесплатно для старта

Начните бесплатно. Ключ API и банковская карта не нужны.

БЕСПЛАТНЫЙ ДОСТУП

0 ₽ / месяц

Для первых версий ботов и сайтов
и личных проектов.

1 000 запросов в сутки на IP
30 запросов в минуту на IP
До 100 записей в одном ответе
Все пять методов API

Как считаются запросы

Каждый день в 00:00 UTC снова доступны 1 000 запросов. Лимит общий для одного IP: например, у пользователей одной сети Wi-Fi. Считается каждый запрос к /v1/, даже если в нём ошибка. Читать сайт можно без ограничений.

X-RateLimit-RemainingСколько запросов осталось на сегодня.

X-RateLimit-ResetКогда снова будут доступны 1 000 запросов. Время в секундах Unix.

Retry-AfterСколько секунд подождать перед следующим запросом.

Коды ответов

200Запрос выполнен.

400Проверьте название подарка и поля запроса.

404Подарок, коллекция или адрес запроса не найдены.

405Отправьте GET-запрос.

429Запросы закончились. Попробуйте позже.

503Не удалось получить данные. Попробуйте ещё раз позже.

Какие данные доступны

API показывает подарки, цены и продажи. Владельцы, кошельки и балансы не передаются. Лимит запросов считается по IP.

Если данных нет, API вернёт null. При ошибке 429 подождите до сброса лимита, при 503 повторите запрос позже.