Для сайтов, блогов и ботов

API и виджет цен
NFT-подарков Telegram

Бесплатно, без ключей и регистрации. Цены на Portals, Fragment и маркетплейсе Starnbuy в рублях и GRAM, редкость моделей, динамика за 7 дней. Обновление каждые 30 минут.

Наведите на подарок:

Самая дорогая модель Plush Pepe Ninja Mike, а начать коллекцию можно с Plush Pepe или Durov’s Cap.

Виджет: карточка цены при наведении

Добавьте одну строку перед </body>. Все ссылки на страницы подарков Starnbuy сами станут карточками с ценами по площадкам, редкостью и графиком за неделю. Без JavaScript ссылки остаются обычными ссылками.

<script async src="https://starnbuy.com/embed/gifts.v1.js"></script>

<!-- Ссылка на коллекцию или модель — карточка появится сама -->
<a href="https://starnbuy.com/gifts/plush-pepe/ninja-mike">Ninja Mike</a>

<!-- Без ссылки -->
<span data-starnbuy-gift="plush-pepe/ninja-mike">Ninja Mike</span>

<!-- Живая цена прямо в тексте: «Plush Pepe · от 683 550 ₽» -->
<span data-starnbuy-price="plush-pepe">Plush Pepe</span>

Настройки

data-theme="auto|light|dark" на теге script — тема карточки. data-auto-links="false" — не трогать обычные ссылки, только элементы с data-starnbuy-gift.

Лёгкий и безопасный

5 КБ в gzip, загружается асинхронно и ничего не делает до первого наведения. Стили изолированы в Shadow DOM, без cookies и трекинга.

Удобно везде

На компьютере — при наведении, на телефоне — по первому тапу снизу экрана, с клавиатуры — по фокусу, Esc закрывает.

Динамический контент

Если ссылки появляются после загрузки страницы, вызовите StarnbuyGifts.refresh().

JSON API

Открытый API без ключа, CORS разрешён, ответы кэшируются 5 минут. Коллекцию и модель можно указать слагом (plush-pepe) или названием (Plush%20Pepe).

GET /api/v1/giftsВсе коллекции: флор по площадкам, лоты, продажи за 24 ч, изменение за 7 дней
GET /api/v1/gifts/{collection}Коллекция и все модели с ценами. ?models=0 — без моделей, ?history=7|30|90|365 — история
GET /api/v1/gifts/{collection}/{model}Модель: редкость, место, цены, ссылки на картинку и анимацию, ?history=…
GET /api/v1/gifts/{collection}[/{model}]/cardКомпактная карточка (~1 КБ) — то, что показывает виджет
GET /api/v1/ratesКурсы: 1 GRAM (TON) и 1 звезда в рублях
 
fetch('https://starnbuy.com/api/v1/gifts/plush-pepe/ninja-mike/card')
  .then(r => r.json())
  .then(gift => console.log(gift.floor.rub, gift.offers));

// {
//   "collection": "Plush Pepe", "model": "Ninja Mike",
//   "url": "https://starnbuy.com/gifts/plush-pepe/ninja-mike",
//   "rarity_pct": 1, "rarity_rank": 1, "models": 50,
//   "floor": { "rub": 8456334, "market": "portals", "price": 92784, "currency": "GRAM" },
//   "offers": [{ "market": "portals", "price": 92784, "currency": "GRAM", "rub": 8456334,
//                "lots": null, "status": "ok", "url": "…", "updated_at": "…" }],
//   "spark": [ … ], "change_7d": 3.4, "updated_at": "…"
// }

Лимиты

До 1 200 запросов в минуту с одного IP. Сверх — ответ 429 с заголовком Retry-After.

Статусы цен

ok — цена свежая, stale — площадка давно не отвечала, no_lots — лотов сейчас нет.

Атрибуция

Будем рады ссылке на starnbuy.com/gifts рядом с данными. Формат стабилен в рамках v1.