Report a bot's status, rates and stock

Every field is optional and a missing field keeps its stored value. stock, when sent, replaces the whole stock. Push at least every 30 minutes: a bot silent for an hour shows as stale, and after a day it is hidden.

POST/v1/bot.update

Authorization

AuthorizationBearer token · headerrequired

Header parameters

Authorizationstringrequired

Bearer <bot key>

Request body

requiredapplication/json

maxSetsPerAppinteger<int32>

Most sets of one app the bot sells to one user. 0 means no limit.

min 0

onlineboolean

Whether the bot is accepting trades.

ratesBotPushRates

Prices in sets per TF2 key.

Show properties

buynumber<float>

Sets the bot wants for one of its TF2 keys. 0 means it does not buy.

sellnumber<float>

Sets the bot sells for one TF2 key. 0 means it does not sell.

stockBotPushStock

The bot's full stock. Replaces the stored stock.

Show properties

foilobject

App ID to complete foil sets.

normalobject

App ID to complete normal sets.

Responses

204

No Content

400

Bad Request

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties

Array of ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"

401

Unauthorized

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties

Array of ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"

422

Unprocessable Entity

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties

Array of ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"

500

Internal Server Error

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[] | null

Optional list of individual error details

Show properties

Array of ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueany

The value at the given location

instancestring<uri>

A URI reference that identifies the specific occurrence of the problem.

statusinteger<int64>

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring<uri>

A URI reference to human-readable documentation for the error.

default: "about:blank"

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Parameters

Authorizationheader*Bearer <bot key>

Bodyapplication/json

Request body

Request

curl -X POST 'https://api.steamsets.com/v1/bot.update' \
  -H 'Authorization: string' \
  -H 'Content-Type: application/json' \
  -d '{
  "maxSetsPerApp": 0,
  "online": true,
  "rates": {
    "buy": 0.1,
    "sell": 0.1
  },
  "stock": {
    "foil": {
      "property1": 0,
      "property2": 0
    },
    "normal": {
      "property1": 0,
      "property2": 0
    }
  }
}'

const response = await fetch("https://api.steamsets.com/v1/bot.update", {
  method: "POST",
  headers: {
    "Authorization": "string",
    "Content-Type": "application/json"
  },
  body: "{\n  \"maxSetsPerApp\": 0,\n  \"online\": true,\n  \"rates\": {\n    \"buy\": 0.1,\n    \"sell\": 0.1\n  },\n  \"stock\": {\n    \"foil\": {\n      \"property1\": 0,\n      \"property2\": 0\n    },\n    \"normal\": {\n      \"property1\": 0,\n      \"property2\": 0\n    }\n  }\n}"
});

import requests

response = requests.post(
    "https://api.steamsets.com/v1/bot.update",
    headers={
        "Authorization": "string",
        "Content-Type": "application/json"
    },
    data="{\n  \"maxSetsPerApp\": 0,\n  \"online\": true,\n  \"rates\": {\n    \"buy\": 0.1,\n    \"sell\": 0.1\n  },\n  \"stock\": {\n    \"foil\": {\n      \"property1\": 0,\n      \"property2\": 0\n    },\n    \"normal\": {\n      \"property1\": 0,\n      \"property2\": 0\n    }\n  }\n}",
)

Response

No Content

{
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

{
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

{
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}

{
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}