Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mannco.store/llms.txt

Use this file to discover all available pages before exploring further.

Base URL: https://api.mannco.store. All endpoints require Connected + API (JWT from POST /user/login).

​
Create buy order

POST /item/buyorder
Permission: Connected + API Creates a buy order for a specific item at a specified price. Only one buy order per item per user; use update to change an existing one.

​
Body Parameters

​
itemid
integer
required
Item ID for which to create a buy order
​
value
integer
required
Buy order price in cents (must be positive)
​
amount
integer
required
Number of items to buy (max 499999 per create; max 4999 per update)

​
Request Example

{
  "itemid": 12345,
  "value": 15000,
  "amount": 3
}

​
Response

Success
{
  "err": false,
  "success": true,
  "content": {
    "details": "Inserted"
  }
}

​
Error Responses

StatusMessageDescription
errorNot enough balanceUser doesn’t have enough balance (value × amount reserved)
errorYou already have buy order on this item please remove them in your profile page!One buy order per item per user
errorMax 5000 itemsAmount exceeds limit (create: under 500000, update: under 5000)
errorValue/Amount/Itemid must be a (positive) numberInvalid or missing body parameters
The total (value × amount) is reserved from your balance when creating a buy order.

​
Update buy order

POST /item/buyorder/update
Permission: Connected + API Replaces your existing buy order for the same item with a new price and/or quantity. You must already have a buy order on the item.

​
Body Parameters

​
itemid
integer
required
Item ID of the buy order to update
​
value
integer
required
New price in cents (must be positive)
​
amount
integer
required
New quantity (max 4999)

​
Request Example

{
  "itemid": 12345,
  "value": 16000,
  "amount": 5
}

​
Response

Success
{
  "err": false,
  "success": true,
  "content": "Buy order updated"
}

​
Error Responses

StatusMessageDescription
errorNot enough balanceInsufficient balance for value × amount
errorYou dont have buy order on this item !No existing buy order for this item
errorNo buy order foundRemove failed internally
errorMax 5000 itemsAmount exceeds 4999
Updating reserves the new total (value × amount) from your balance; the previous reservation is released.

​
Remove buy order

POST /item/buyorder/remove
Permission: Connected + API Cancels and removes your buy order for an item, releasing the reserved balance.

​
Body Parameters

​
itemid
integer
required
Item ID of the buy order to remove

​
Request Example

{
  "itemid": 12345
}

​
Response

Success
{
  "err": false,
  "success": true,
  "content": {
    "details": "Removed"
  }
}

​
Error Responses

StatusMessageDescription
errorNo buy order foundNo buy order for this item for the current user

​
Get user’s buy orders for an item

GET /user/buyorder/{item}
Permission: Connected + API
​
item
string
required
Item identifier (numeric ID)
Returns all active buy orders for a specific item created by the authenticated user.

​
Response

{
  "err": false,
  "success": true,
  "content": {
    "informations": {
      "id": 98765,
      "steamid": "76561198000000000",
      "itemid": 12345,
      "price": 15000,
      "amount": 3,
      "timestamp": "1706745600"
    }
  }
}

​
Buy Order Fields

FieldTypeDescription
idintegerBuy order ID
steamidstringUser’s Steam ID
itemidintegerItem ID
priceintegerBuy order price in cents
amountintegerQuantity of items to buy
timestampstringUnix timestamp of creation

​
Get all user’s buy orders

GET /user/getBuyorder
Permission: Connected + API Returns active buy orders for the authenticated user across all items.

​
Query Parameters

​
page
integer
default:"0"
Page number for pagination (offset = page × count)
​
count
integer
default:"10"
Number of results per page (max 1000, must be > 0)
​
search
string
Optional search term to filter by item effect or name
​
undercut
boolean
If true or 1, filter to buy orders that are below the current lowest sale price

​
Response

{
  "err": false,
  "success": true,
  "content": {
    "values": [
      {
        "id": 98765,
        "steamid": "76561198000000000",
        "itemid": 12345,
        "price": 15000,
        "amount": 3,
        "name": "Burning Flames Team Captain",
        "effect": "Burning Flames",
        "url": "unusual_team_captain",
        "game": 440,
        "quality": "Unusual",
        "image": "https://...",
        "type": "Hat",
        "craftable": 1,
        "SKU": "",
        "type_steam": null,
        "class": null,
        "imagePertinence": 1,
        "rarity": "",
        "featured": 0,
        "deal": null,
        "color": "",
        "slot": "",
        "hero": null,
        "weapon": null,
        "exterior": null,
        "description": null,
        "tf2shop": null
      }
    ],
    "count": {
      "nb": 15
    }
  }
}

​
Response Fields

Returns joined data from buyorder and items tables: Buy Order Fields:
FieldTypeDescription
idnumberBuy order ID
steamidstringUser’s Steam ID
itemidnumberItem ID
pricenumberBuy order price in cents
amountnumberQuantity remaining
namestringBuy order custom name (or item name)
Item Fields (from items table): All fields from the items table are joined, including effect, name, url, game, quality, image, type, craftable, etc. Count Object:
FieldTypeDescription
count.nbnumberTotal number of buy orders
  • Results are ordered by buyorder.id DESC
  • Only returns buy orders where amount != 0
  • Search functionality requires at least 3 characters
  • The count object contains the total number of buy orders for pagination
Buy orders are automatically filled when matching items are listed at or below your buy order price. You’ll receive a notification when a buy order is filled.