API documentation
Bot owners push rates and stock to this directory. Public reads never return API keys or private notes.
Authentication
Each bot has its own API key. Send it as Authorization: Bearer. Never put the key in the URL.
Authorization: Bearer lb_your_key
Content-Type: application/json
Accept: application/jsonHow to get a key
- Sign in with SteamUse the Steam account that is the bot, or your own account if you are the owner.
- Register the botOn the bot account, turn on the bot toggle and enter the owner SteamID64.
- Confirm ownershipSign in as the owner and confirm the request. Until then, nobody can manage the bot.
- Generate an API keyOpen the bot and generate a key. It is shown once and stored only as a hash.
- Sync the dataPost rates and stock to the category endpoint. A fresh update turns the sync dot green.
Units
- Level up: selling.tf2 and buying.tf2 are sets per TF2 key. selling.gem and buying.gem are gems per set.
- Gems: selling.tf2 and buying.tf2 are gems per TF2 key.
- Crypto: set rateUnit in words, for example USD per 1 key, and amountCurrency for min and max.
POST /api/v1/bots/levelup/update
TF2 rates are sets per 1 TF2 key. Gem rates are gems per 1 set. maxStock is separate from the sets currently in stock.
{
"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
Gem rates use gems per 1 TF2 key. Selling is what the bot pays out. Buying is what the bot asks for.
{
"selling": { "tf2": 6500 },
"buying": { "tf2": 6800 },
"gemStock": 1000000,
"tf2Stock": 150
}POST /api/v1/bots/crypto/update
Declare rateUnit and amountCurrency. The directory does not assume one model for every crypto bot.
{
"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
Send a type, a list of services, and optional custom fields.
{
"type": "trading",
"services": ["buy", "sell"],
"fields": [{ "key": "fee", "label": "Fee", "value": "2%" }]
}Public reads
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
Public lists accept q, sort, dir, page, per_page and synced. Private bots are omitted.
fetch example
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 example
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}` }
});Success
{
"ok": true,
"steamid": "7656119...",
"category": "levelup",
"synced_at": "2026-11-20T13:00:00+00:00",
"sync": "synced"
}Errors
200Update stored and marked synced.400The JSON is invalid, or the key was sent in the URL.401Missing or unknown API key.403Sync is disabled, the bot is suspended, or the key tried to update another SteamID.404That public bot does not exist.409The endpoint category does not match the bot.413The body is larger than the configured limit.422A field is missing or out of range.429Too many requests for this key.503Maintenance is on, or the API is disabled. The body stays JSON.
Rate limits
Authenticated updates are limited to 60 requests per minute per key. The limit can be changed by an admin.
Security
- Keep the key on the bot, not in a screenshot or a public repository.
- Regenerate the key if it leaks. The previous key stops working immediately.
- Send only the fields you want to change.
- The key identifies the bot. A different SteamID in the body is rejected.

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