Report a bot's status, prices and stock

Every field is optional and a missing field keeps its stored value. That holds down to each price side and stock count, and 0 removes one: {"sets": {"prices": {"tf2": {"buy": 0}}}} stops buying sets for TF2 keys and changes nothing else. sets.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

cryptoBotPushCrypto

Cryptocurrency prices per set.

Show properties

pricesBotPushCryptoPrice[] | null

One entry per coin.

Show properties

Array of BotPushCryptoPrice

buystring

Coins the bot pays for one set, as a decimal string. "0" stops buying for this coin.

coinstringrequired

Ticker, such as btc, eth or ltc.

sellstring

Coins the bot sells one set for, as a decimal string such as "0.0000038". "0" stops selling for this coin.

gemsBotPushGems

The gem market.

Show properties

pricesBotPushGemPrices

Gems per key or ticket.

Show properties

cs2BotPushRate

Gems per CS2 key.

Show properties

buynumber<double>

What the bot buys at. 0 means it stopped buying.

sellnumber<double>

What the bot sells at. 0 means it stopped selling.

hydraBotPushRate

Gems per Hydra key.

tf2BotPushRate

Gems per TF2 key.

todBotPushRate

Gems per Tour of Duty ticket.

stockinteger<int64>

Gems the bot holds.

min 0

keysBotPushKeys

Keys and tickets the bot holds. 0 clears a count.

Show properties

cs2integer<int32>

CS2 keys the bot holds.

min 0

hydrainteger<int32>

Hydra keys the bot holds.

min 0

tf2integer<int32>

TF2 keys the bot holds.

min 0

todinteger<int32>

Tour of Duty tickets the bot holds.

min 0

onlineboolean

Whether the bot is accepting trades.

setsBotPushSets

Card sets: stock, limits and prices.

Show properties

limitsBotPushLimits

Limits on what the bot sells.

Show properties

maxPerAppinteger<int32>

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

min 0

pricesBotPushSetPrices

Set prices per currency.

Show properties

cs2BotPushRate

Sets per CS2 key.

gemsBotPushRate

Gems per set.

hydraBotPushRate

Sets per Hydra key.

tf2BotPushRate

Sets per TF2 key.

todBotPushRate

Sets per Tour of Duty ticket.

stockBotPushStock

The bot's full set 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

{
  "crypto": {
    "prices": [
      {
        "buy": "string",
        "coin": "string",
        "sell": "string"
      }
    ]
  },
  "gems": {
    "prices": {
      "cs2": {
        "buy": 0.1,
        "sell": 0.1
      },
      "hydra": {
        "buy": 0.1,
        "sell": 0.1
      },
      "tf2": {
        "buy": 0.1,
        "sell": 0.1
      },
      "tod": {
        "buy": 0.1,
        "sell": 0.1
      }
    },
    "stock": 0
  },
  "keys": {
    "cs2": 0,
    "hydra": 0,
    "tf2": 0,
    "tod": 0
  },
  "online": true,
  "sets": {
    "limits": {
      "maxPerApp": 0
    },
    "prices": {
      "cs2": {
        "buy": 0.1,
        "sell": 0.1
      },
      "gems": {
        "buy": 0.1,
        "sell": 0.1
      },
      "hydra": {
        "buy": 0.1,
        "sell": 0.1
      },
      "tf2": {
        "buy": 0.1,
        "sell": 0.1
      },
      "tod": {
        "buy": 0.1,
        "sell": 0.1
      }
    },
    "stock": {
      "foil": {
        "property1": 0,
        "property2": 0
      },
      "normal": {
        "property1": 0,
        "property2": 0
      }
    }
  }
}

Request

curl -X POST 'https://api.steamsets.com/v1/bot.update' \
  -H 'Authorization: string' \
  -H 'Content-Type: application/json' \
  -d '{
  "crypto": {
    "prices": [
      {
        "buy": "string",
        "coin": "string",
        "sell": "string"
      }
    ]
  },
  "gems": {
    "prices": {
      "cs2": {
        "buy": 0.1,
        "sell": 0.1
      },
      "hydra": {
        "buy": 0.1,
        "sell": 0.1
      },
      "tf2": {
        "buy": 0.1,
        "sell": 0.1
      },
      "tod": {
        "buy": 0.1,
        "sell": 0.1
      }
    },
    "stock": 0
  },
  "keys": {
    "cs2": 0,
    "hydra": 0,
    "tf2": 0,
    "tod": 0
  },
  "online": true,
  "sets": {
    "limits": {
      "maxPerApp": 0
    },
    "prices": {
      "cs2": {
        "buy": 0.1,
        "sell": 0.1
      },
      "gems": {
        "buy": 0.1,
        "sell": 0.1
      },
      "hydra": {
        "buy": 0.1,
        "sell": 0.1
      },
      "tf2": {
        "buy": 0.1,
        "sell": 0.1
      },
      "tod": {
        "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  \"crypto\": {\n    \"prices\": [\n      {\n        \"buy\": \"string\",\n        \"coin\": \"string\",\n        \"sell\": \"string\"\n      }\n    ]\n  },\n  \"gems\": {\n    \"prices\": {\n      \"cs2\": {\n        \"buy\": 0.1,\n        \"sell\": 0.1\n      },\n      \"hydra\": {\n        \"buy\": 0.1,\n        \"sell\": 0.1\n      },\n      \"tf2\": {\n        \"buy\": 0.1,\n        \"sell\": 0.1\n      },\n      \"tod\": {\n        \"buy\": 0.1,\n        \"sell\": 0.1\n      }\n    },\n    \"stock\": 0\n  },\n  \"keys\": {\n    \"cs2\": 0,\n    \"hydra\": 0,\n    \"tf2\": 0,\n    \"tod\": 0\n  },\n  \"online\": true,\n  \"sets\": {\n    \"limits\": {\n      \"maxPerApp\": 0\n    },\n    \"prices\": {\n      \"cs2\": {\n        \"buy\": 0.1,\n        \"sell\": 0.1\n      },\n      \"gems\": {\n        \"buy\": 0.1,\n        \"sell\": 0.1\n      },\n      \"hydra\": {\n        \"buy\": 0.1,\n        \"sell\": 0.1\n      },\n      \"tf2\": {\n        \"buy\": 0.1,\n        \"sell\": 0.1\n      },\n      \"tod\": {\n        \"buy\": 0.1,\n        \"sell\": 0.1\n      }\n    },\n    \"stock\": {\n      \"foil\": {\n        \"property1\": 0,\n        \"property2\": 0\n      },\n      \"normal\": {\n        \"property1\": 0,\n        \"property2\": 0\n      }\n    }\n  }\n}"
});

import requests

response = requests.post(
    "https://api.steamsets.com/v1/bot.update",
    headers={
        "Authorization": "string",
        "Content-Type": "application/json"
    },
    data="{\n  \"crypto\": {\n    \"prices\": [\n      {\n        \"buy\": \"string\",\n        \"coin\": \"string\",\n        \"sell\": \"string\"\n      }\n    ]\n  },\n  \"gems\": {\n    \"prices\": {\n      \"cs2\": {\n        \"buy\": 0.1,\n        \"sell\": 0.1\n      },\n      \"hydra\": {\n        \"buy\": 0.1,\n        \"sell\": 0.1\n      },\n      \"tf2\": {\n        \"buy\": 0.1,\n        \"sell\": 0.1\n      },\n      \"tod\": {\n        \"buy\": 0.1,\n        \"sell\": 0.1\n      }\n    },\n    \"stock\": 0\n  },\n  \"keys\": {\n    \"cs2\": 0,\n    \"hydra\": 0,\n    \"tf2\": 0,\n    \"tod\": 0\n  },\n  \"online\": true,\n  \"sets\": {\n    \"limits\": {\n      \"maxPerApp\": 0\n    },\n    \"prices\": {\n      \"cs2\": {\n        \"buy\": 0.1,\n        \"sell\": 0.1\n      },\n      \"gems\": {\n        \"buy\": 0.1,\n        \"sell\": 0.1\n      },\n      \"hydra\": {\n        \"buy\": 0.1,\n        \"sell\": 0.1\n      },\n      \"tf2\": {\n        \"buy\": 0.1,\n        \"sell\": 0.1\n      },\n      \"tod\": {\n        \"buy\": 0.1,\n        \"sell\": 0.1\n      }\n    },\n    \"stock\": {\n      \"foil\": {\n        \"property1\": 0,\n        \"property2\": 0\n      },\n      \"normal\": {\n        \"property1\": 0,\n        \"property2\": 0\n      }\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"
}