Documentación de la API
Los propietarios envían tarifas y stock. Las lecturas públicas nunca devuelven claves ni notas privadas.
Autenticación
Cada bot tiene su clave. Envía Authorization: Bearer. Nunca pongas la clave en la URL.
Authorization: Bearer lb_your_key
Content-Type: application/json
Accept: application/jsonCómo obtener una clave
- Entrar con SteamUsa la cuenta de Steam que es el bot, o la tuya si eres el propietario.
- Registrar el botEn la cuenta del bot, activa el interruptor e indica el SteamID64 del propietario.
- Confirmar la propiedadEntra como propietario y confirma la solicitud. Hasta entonces, nadie gestiona el bot.
- Generar una clave de APIAbre el bot y genera una clave. Se muestra una vez y solo se guarda el hash.
- Sincronizar los datosEnvía tarifas y stock al endpoint de la categoría. Una actualización reciente pone el indicador en verde.
Unidades
- Level up: selling.tf2 y buying.tf2 son sets por llave TF2. selling.gem y buying.gem son gems por set.
- Gems: selling.tf2 y buying.tf2 son gems por llave TF2.
- Crypto: describe rateUnit, por ejemplo USD por 1 llave, y amountCurrency para el mínimo y el máximo.
POST /api/v1/bots/levelup/update
Las tarifas TF2 son sets por 1 llave. Las tarifas en gems son gems por 1 set. maxStock es independiente del stock actual.
{
"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
Las tarifas de gems son gems por 1 llave TF2. Venta es lo que el bot entrega. Compra es lo que el bot pide.
{
"selling": { "tf2": 6500 },
"buying": { "tf2": 6800 },
"gemStock": 1000000,
"tf2Stock": 150
}POST /api/v1/bots/crypto/update
Indica rateUnit y amountCurrency. El directorio no supone un único modelo para todos los crypto bots.
{
"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
Envía un tipo, una lista de servicios y campos extra opcionales.
{
"type": "trading",
"services": ["buy", "sell"],
"fields": [{ "key": "fee", "label": "Fee", "value": "2%" }]
}Lecturas públicas
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
Las listas públicas aceptan q, sort, dir, page, per_page y synced. Los bots privados no aparecen.
Ejemplo con 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 })
});Ejemplo con 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}` }
});Éxito
{
"ok": true,
"steamid": "7656119...",
"category": "levelup",
"synced_at": "2026-11-20T13:00:00+00:00",
"sync": "synced"
}Errores
200Actualización guardada y marcada como sincronizada.400JSON no válido, o la clave se envió en la URL.401Falta la clave o no se reconoce.403La sincronización está apagada, el bot está suspendido o la clave intentó actualizar otro SteamID.404Ese bot público no existe.409La categoría del endpoint no coincide con el bot.413El cuerpo supera el límite configurado.422Falta un campo o está fuera de rango.429Demasiadas solicitudes para esta clave.503El mantenimiento está activo o la API está apagada. La respuesta sigue siendo JSON.
Límites
Cada clave puede enviar 60 solicitudes por minuto. Un administrador puede cambiar el límite.
Seguridad
- Guarda la clave en el bot, no en un repositorio público.
- Genera otra clave si esta se filtra. La anterior deja de funcionar al instante.
- Envía solo los campos que quieres cambiar.
- La clave identifica al bot. Otro SteamID en el cuerpo se rechaza.

English
Português
Русский
简体中文
Français
日本語
Deutsch