LevelUp Directory

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/json

How to get a key

  1. Sign in with SteamUse the Steam account that is the bot, or your own account if you are the owner.
  2. Register the botOn the bot account, turn on the bot toggle and enter the owner SteamID64.
  3. Confirm ownershipSign in as the owner and confirm the request. Until then, nobody can manage the bot.
  4. Generate an API keyOpen the bot and generate a key. It is shown once and stored only as a hash.
  5. Sync the dataPost rates and stock to the category endpoint. A fresh update turns the sync dot green.

Units

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

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

Rate limits

Authenticated updates are limited to 60 requests per minute per key. The limit can be changed by an admin.

Security

OpenAPI JSON · OpenAPI YAML