/api/endpoints are limited to 360 requests per minute per IP.helmet.404if the item or SKU is not found, and400for invalid input./api/graph/:skusupports?header=falseto hide the chart header (for embedding)./api/Health check. Returns status of API and database connectivity.
{
"status": "ok",
"db": "ok"
}Example:/api/
/api/itemsReturns a list of all unique items (name and SKU) in the database.
[
{
"name": "Strange Professional Killstreak Backburner",
"sku": "40;11;kt-3"
}
]Example:/api/items
/api/latest-pricesReturns the 10 most recent price entries from the database (not unique per SKU). For the latest price of each unique item, use /api/autob/items instead.
[
{
"name": "Strange Professional Killstreak Backburner",
"sku": "40;11;kt-3",
"source": "bptf",
"time": 1748874425,
"buy": {
"keys": 4,
"metal": 11.33
},
"sell": {
"keys": 4,
"metal": 69.22
}
}
]Example:/api/latest-prices
/api/pricesReturns paginated price history with metadata. Use limit and offset query parameters for pagination.
| Parameter | Type | Description |
|---|---|---|
limit | number | Maximum number of records to return (default: 100, max: 1000)(optional) |
offset | number | Number of records to skip (default: 0)(optional) |
[
{
"name": "Strange Professional Killstreak Backburner",
"sku": "40;11;kt-3",
"source": "bptf",
"time": 1748874425,
"buy": {
"keys": 4,
"metal": 11.33
},
"sell": {
"keys": 4,
"metal": 69.22
}
}
]Example:/api/prices?limit=50&offset=0
/api/item/:skuReturns the latest price for a specific item SKU.
| Parameter | Type | Description |
|---|---|---|
sku | string | The SKU of the item to look up |
{
"name": "Strange Professional Killstreak Backburner",
"sku": "40;11;kt-3",
"source": "bptf",
"time": 1748874425,
"buy": {
"keys": 4,
"metal": 11.33
},
"sell": {
"keys": 4,
"metal": 69.22
}
}Example:/api/item/40;11;kt-3
/api/item-history/:skuReturns the full price history for a specific item SKU as an array. Optionally filter by start and/or end unix timestamps.
| Parameter | Type | Description |
|---|---|---|
sku | string | The SKU of the item to look up |
start | number | (optional) Only include entries after this unix timestamp(optional) |
end | number | (optional) Only include entries before this unix timestamp(optional) |
[
{
"name": "Strange Professional Killstreak Backburner",
"sku": "40;11;kt-3",
"source": "bptf",
"time": 1748874425,
"buy": {
"keys": 4,
"metal": 11.33
},
"sell": {
"keys": 4,
"metal": 69.22
}
}
]Example:/api/item-history/40;11;kt-3?start=1700000000&end=1800000000
/api/item-stats/:skuReturns statistics for a specific item SKU (min, max, avg, count) for buy and sell prices.
| Parameter | Type | Description |
|---|---|---|
sku | string | The SKU of the item to look up |
{
"buy": {
"count": 12,
"keys": {
"min": 2,
"max": 4,
"avg": 3.1
},
"metal": {
"min": 11.33,
"max": 69.22,
"avg": 40.12
}
},
"sell": {
"count": 12,
"keys": {
"min": 2,
"max": 4,
"avg": 3.1
},
"metal": {
"min": 11.33,
"max": 69.22,
"avg": 40.12
}
}
}Example:/api/item-stats/40;11;kt-3
/api/graph/:skuReturns an HTML page with a price history chart for a specific item SKU.
| Parameter | Type | Description |
|---|---|---|
sku | string | The SKU of the item to look up |
header | boolean | (optional) Set to false to hide chart header for embedding (default: true)(optional) |
height | number | (optional) Chart height in pixels (default: 500 with header, 400 without)(optional) |
width | string | (optional) Chart width (default: 100%)(optional) |
HTML page with interactive chart/api/items-bulkReturns the latest price for each SKU in the provided array.
| Parameter | Type | Description |
|---|---|---|
skus | array | Array of SKU strings to look up |
{
"skus": [
"40;11;kt-3",
"202;11;australium"
]
}[
{
"name": "Strange Professional Killstreak Backburner",
"sku": "40;11;kt-3",
"source": "bptf",
"time": 1748874425,
"buy": {
"keys": 4,
"metal": 11.33
},
"sell": {
"keys": 4,
"metal": 69.22
}
}
]Example:/api/items-bulk
/api/snapshot/:timestampReturns the latest price for each SKU as of the given unix timestamp.
| Parameter | Type | Description |
|---|---|---|
timestamp | number | Unix timestamp (seconds) |
[
{
"name": "Strange Professional Killstreak Backburner",
"sku": "40;11;kt-3",
"source": "bptf",
"time": 1748874425,
"buy": {
"keys": 4,
"metal": 11.33
},
"sell": {
"keys": 4,
"metal": 69.22
}
}
]Example:/api/snapshot/1700000000
/api/searchFuzzy search for items by name. Returns up to 10 matching items ordered by relevance.
| Parameter | Type | Description |
|---|---|---|
q | string | Search query (minimum 2 characters) |
limit | number | Maximum results to return (default: 10, max: 50)(optional) |
{
"query": "backburner",
"results": [
{
"name": "Strange Professional Killstreak Backburner",
"sku": "40;11;kt-3",
"source": "bptf",
"time": 1748874425,
"buy": {
"keys": 4,
"metal": 11.33
},
"sell": {
"keys": 4,
"metal": 69.22
},
"relevance": 900
}
],
"total": 1,
"limit": 5
}Example:/api/search?q=backburner&limit=5
/api/compare/:sku1/:sku2Compare two items side by side with price differences and history.
| Parameter | Type | Description |
|---|---|---|
sku1 | string | SKU of the first item to compare |
sku2 | string | SKU of the second item to compare |
{
"items": {
"40;11;kt-3": {
"name": "Strange Professional Killstreak Backburner",
"sku": "40;11;kt-3",
"buy": {
"keys": 4,
"metal": 11.33
},
"sell": {
"keys": 4,
"metal": 69.22
}
},
"202;11;australium": {
"name": "Australium Rocket Launcher",
"sku": "202;11;australium",
"buy": {
"keys": 45,
"metal": 0
},
"sell": {
"keys": 50,
"metal": 0
}
}
},
"comparison": {
"buyDifference": {
"keys": -41,
"metal": 11.33
},
"sellDifference": {
"keys": -46,
"metal": 69.22
}
},
"history": {
"40;11;kt-3": [],
"202;11;australium": []
},
"meta": {
"compared": "2025-01-01T00:00:00.000Z",
"historyDays": 30
}
}/api/cache-statsReturns cache performance and system statistics.
{
"cache": {
"size": 42,
"maxSize": 1000,
"activeTimers": 15
},
"database": {
"totalPrices": 150000,
"uniqueItems": 5000,
"latestUpdate": 1748874425
}
}Example:/api/cache-stats
/api/autob/itemsReturns full pricelist for TF2Autobot integration. Returns the latest price for each unique SKU (similar to the previous /api/latest-prices behavior).
{
"success": true,
"currency": "metal",
"items": [
{
"name": "Strange Professional Killstreak Backburner",
"sku": "40;11;kt-3",
"source": "bptf",
"time": 1748874425,
"buy": {
"keys": 4,
"metal": 11.33
},
"sell": {
"keys": 4,
"metal": 69.22
}
}
]
}Example:/api/autob/items
/api/autob/items/:skuReturns single item price for TF2Autobot integration.
| Parameter | Type | Description |
|---|---|---|
sku | string | The SKU of the item to look up |
Example:/api/autob/items/40;11;kt-3
/api/autob/items/:skuPrice check endpoint for TF2Autobot integration.
| Parameter | Type | Description |
|---|---|---|
sku | string | The SKU of the item to check |
Example:/api/autob/items/40;11;kt-3
ws://ws.pricedb.io/price- Emitted when prices updateThe SKU Service provides item lookup and TF2 schema information. All endpoints are available athttps://sku.pricedb.io/api/
/sku/:skuLookup item by SKU and return properties including name, defindex, quality, and other metadata.
/name/:nameLookup item by name and return properties. Supports fuzzy matching for item names.
Example:https://sku.pricedb.io/api/name/Strange%20Backburner
/schemaGet the complete TF2 schema as JSON including all items, attributes, qualities, and effects.
/downloadDownload the complete TF2 schema as a JSON file. Identical to /schema but with Content-Disposition header for file download.