LevelUp Directory

APIドキュメント

所有者はレートと在庫を送ります。公開読み取りはキーや非公開メモを返しません。

認証

各ボットに専用キーがあります。Authorization: Bearer で送ってください。URLにキーを入れないでください。

Authorization: Bearer lb_your_key
Content-Type: application/json
Accept: application/json

キーの取得方法

  1. SteamでログインボットのSteamアカウント、または所有者なら自分のアカウントで入ってください。
  2. ボットを登録ボットのアカウントでスイッチを入れ、所有者のSteamID64を入力します。
  3. 所有権を確認所有者として入り、申請を確認します。それまでは誰も管理できません。
  4. APIキーを生成ボットを開き、キーを生成します。表示は一度だけで、保存されるのはハッシュだけです。
  5. データを同期カテゴリのエンドポイントへレートと在庫を送ります。新しい更新で点が緑になります。

単位

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

ジェムのレートはTF2キー1個あたりです。販売はボットが渡す量、買取はボットが求める量です。

{
  "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%" }]
}

公開読み取り

公開一覧は 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"
}

エラー

制限

各キーは1分あたり60件までです。管理者が上限を変更できます。

セキュリティ

OpenAPI JSON · OpenAPI YAML