API 文档
所有者提交汇率和库存。公开读取不会返回密钥或私人备注。
身份验证
每个机器人有自己的密钥。请使用 Authorization: Bearer。不要把密钥放在 URL 中。
Authorization: Bearer lb_your_key
Content-Type: application/json
Accept: application/json如何获取密钥
- 使用 Steam 登录使用机器人的 Steam 账户登录;如果你是所有者,则使用自己的账户。
- 登记机器人在机器人账户上打开开关,并填写所有者的 SteamID64。
- 确认所有权以所有者身份登录并确认。在此之前,没有人可以管理这个机器人。
- 生成 API 密钥打开机器人并生成密钥。它只显示一次,并且只以哈希保存。
- 同步数据把汇率和库存发到对应分类的接口。最近的有效更新会让圆点变绿。
单位
- 升级:selling.tf2 和 buying.tf2 是每把 TF2 钥匙的套装数。selling.gem 和 buying.gem 是每套的宝石数。
- 宝石:selling.tf2 和 buying.tf2 是每把 TF2 钥匙的宝石数。
- 加密:用文字写明 rateUnit,例如每把钥匙的美元价格,并用 amountCurrency 表示最小和最大金额。
POST /api/v1/bots/levelup/update
TF2 汇率是每把钥匙的套装数。宝石汇率是每套的宝石数。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更新已保存并标记为已同步。400JSON 无效,或密钥出现在 URL 中。401缺少或无法识别密钥。403同步已关闭、机器人被暂停,或密钥试图更新另一个 SteamID。404该公开机器人不存在。409接口分类与机器人不符。413请求体超过配置的上限。422字段缺失或超出范围。429此密钥的请求过多。503维护模式开启或 API 已关闭。响应仍是 JSON。
限制
每个密钥每分钟最多 60 次请求。管理员可以修改上限。
安全
- 把密钥放在机器人里,不要放进公开仓库。
- 如果密钥泄露,请重新生成。旧密钥会立即失效。
- 只发送要修改的字段。
- 密钥已经标识机器人。请求体中的其他 SteamID 会被拒绝。

English
Português
Español
Русский
Français
日本語
Deutsch