Документация API
Владельцы отправляют курсы и запас. Публичные ответы никогда не содержат ключи и частные заметки.
Аутентификация
У каждого бота свой ключ. Отправляйте Authorization: Bearer. Не помещайте ключ в URL.
Authorization: Bearer lb_your_key
Content-Type: application/json
Accept: application/jsonКак получить ключ
- Войти через SteamВойдите аккаунтом бота или своим, если вы владелец.
- Зарегистрировать ботаНа аккаунте бота включите переключатель и укажите SteamID64 владельца.
- Подтвердить владениеВойдите как владелец и подтвердите. До этого ботом никто не управляет.
- Создать ключ APIОткройте бота и создайте ключ. Он показывается один раз и хранится только как хеш.
- Синхронизировать данныеОтправьте курсы и запас на адрес категории. Свежее обновление делает точку зелёной.
Единицы
- Level up: selling.tf2 и buying.tf2 — сеты за ключ TF2. selling.gem и buying.gem — гемы за сет.
- Гемы: selling.tf2 и buying.tf2 — гемы за ключ TF2.
- Крипто: опишите rateUnit, например USD за 1 ключ, и amountCurrency для минимума и максимума.
POST /api/v1/bots/levelup/update
Курсы TF2 — сеты за 1 ключ. Курсы гемов — гемы за 1 сет. maxStock не равен текущему запасу.
{
"selling": { "tf2": 20, "gem": 12000 },
"buying": { "tf2": 22, "gem": 13000 },
"sets": { "730": 10, "570": 5 },
"stockSets": 1500,
"maxStock": 3000,
"maxLevel": 250
}POST /api/v1/bots/gems/update
Курсы гемов — гемы за 1 ключ TF2. Продажа — что бот отдаёт. Покупка — что бот просит.
{
"selling": { "tf2": 6500 },
"buying": { "tf2": 6800 },
"gemStock": 1000000,
"tf2Stock": 150
}POST /api/v1/bots/crypto/update
Укажите rateUnit и amountCurrency. Каталог не предполагает одну модель для всех криптоботов.
{
"rateUnit": "USD per 1 key",
"amountCurrency": "USD",
"currencies": [
{ "symbol": "BTC", "network": "Bitcoin", "enabled": true },
{ "symbol": "USDT", "network": "TRC20", "enabled": true }
],
"services": ["buy", "sell"],
"rates": { "buy": 0.98, "sell": 1.02 },
"fees": { "buyPercent": 2, "sellPercent": 2 },
"minAmount": 5,
"maxAmount": 500,
"available": true
}POST /api/v1/bots/misc/update
Отправьте тип, список услуг и необязательные поля.
{
"type": "trading",
"services": ["buy", "sell"],
"fields": [{ "key": "fee", "label": "Fee", "value": "2%" }]
}Публичное чтение
GET /api/v1/botsGET /api/v1/bots/{steamId}GET /api/v1/bots/levelupGET /api/v1/bots/gemsGET /api/v1/bots/cryptoGET /api/v1/bots/misc
Публичные списки принимают q, sort, dir, page, per_page и synced. Приватные боты скрыты.
Пример fetch
await fetch('https://dev.lvlupbot.com/api/v1/bots/levelup/update', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + process.env.DIRECTORY_KEY,
'Content-Type': 'application/json'
},
body: JSON.stringify({ stockSets: 1500, maxStock: 3000, maxLevel: 250 })
});Пример axios
import axios from 'axios';
await axios.post('https://dev.lvlupbot.com/api/v1/bots/gems/update', {
selling: { tf2: 6500 },
buying: { tf2: 6800 },
gemStock: 1000000,
tf2Stock: 150
}, {
headers: { Authorization: `Bearer ${process.env.DIRECTORY_KEY}` }
});Успех
{
"ok": true,
"steamid": "7656119...",
"category": "levelup",
"synced_at": "2026-11-20T13:00:00+00:00",
"sync": "synced"
}Ошибки
200Обновление сохранено и отмечено как синхронизированное.400Неверный JSON, или ключ передан в URL.401Ключ отсутствует или неизвестен.403Синхронизация выключена, бот заморожен, или ключ пытался обновить другой SteamID.404Такого публичного бота нет.409Категория адреса не совпадает с ботом.413Тело запроса больше заданного предела.422Поле отсутствует или вне диапазона.429Слишком много запросов для этого ключа.503Идёт обслуживание или API выключен. Ответ остаётся JSON.
Лимиты
Каждый ключ может отправить 60 запросов в минуту. Администратор может изменить лимит.
Безопасность
- Храните ключ в боте, не в публичном репозитории.
- Если ключ утёк, выпустите новый. Старый перестаёт работать сразу.
- Отправляйте только изменяемые поля.
- Ключ определяет бота. Другой SteamID в теле будет отклонён.

English
Português
Español
简体中文
Français
日本語
Deutsch