Интеграция с AI-агентом
Если вы создаёте AI-агента или инструмент на базе LLM, самый быстрый способ дать ему доступ ко всей поверхности API — машиночитаемая спецификация по адресу/llms.txt. В этом файле содержится полный API в едином компактном документе — без необходимости парсинга.
Для агентов, поддерживающих Model Context Protocol (MCP), добавьте сервер CSBoard в конфигурацию MCP:
Опрос новых листингов
Чтобы обнаруживать новые листинги по мере их появления без пересканирования всего каталога, используйтеsort=newest в сочетании с курсорной пагинацией. На каждом цикле опроса пролистывайте страницы, пока не дойдёте до уже виденного ID листинга, и останавливайтесь.
Бот для мониторинга цен
ОпрашивайтеGET /v1/prices по расписанию, сравнивайте min_price_usd каждого предмета с вашим порогом и запускайте уведомление или автоматическую покупку, когда цена опускается ниже него.
min_price_usd из /v1/prices — это индикативный сгруппированный снапшот, он может отставать от живой цены по конкретному предмету. Всегда получайте конкретный листинг из /v1/listings и используйте его price_usd как авторитетную цену перед размещением ордера.Безопасная автоматизация покупок
Автоматическая покупка требует более защищённого кода, чем ручная. Соблюдайте эти четыре правила безусловно. 1. Всегда отправляйтеmax_price_usd
Ваш потолок применяется атомарно внутри списания с баланса. Без него скачок цены между получением листинга и исполнением ордера может привести к неожиданному списанию. Установите max_price_usd равным наблюдавшемуся price_usd плюс небольшой буфер, если вы готовы принять небольшое проскальзывание:
429 с учётом Retry-After
Ответы с лимитом запросов содержат заголовок Retry-After (в секундах). Всегда читайте это значение и спите ровно это время — не используйте фиксированный backoff, так как он может оказаться короче или длиннее необходимого.
4. Корректно обрабатывайте 409 price_moved
409 price_moved означает, что цена превысила ваш потолок — списание не было выполнено. Решайте: повторно получить листинг, обновить max_price_usd и повторить, или отказаться от сделки:
Массовый конвейер данных
Для сайтов сравнения, аналитических дашбордов и любых систем, которым нужен полный каталог, используйте эндпоинт снапшота вместо пагинации по/v1/prices.
ETag из каждого ответа 200 и отправляйте его обратно как If-None-Match в следующем запросе. Ответ 304 Not Modified означает, что ваша локальная копия по-прежнему актуальна.
Эндпоинт снапшота ограничен 1 запросом в минуту. Постройте конвейер так, чтобы использовать его как базовый слой, обновляемый каждые несколько минут, и накладывать сверху обновления в реальном времени из
/v1/prices для активно отслеживаемых предметов.