{"openapi":"3.1.0","info":{"title":"rust.wiki API","description":"Everything on rust.wiki as JSON: the full Rust item catalogue with recipes, recycle yields, loot sources and blueprints; every Rust skin with live Steam prices, sale history, third-party marketplace prices, deals, the market index and market cap; the current and past Rust item store; the Steam Workshop; monuments, loot tables, commands, CCTV codes, world entities, building pieces, the tech tree, calculators and Facepunch updates; Rust player stats from the official Steam Web API; Steam inventory valuations; rendered PNG charts; the Rust server directory; rustprofit.com casino rounds, provably-fair data and your own game history; network status; and the paper-trading funds leaderboard.\n\nAuthenticate with an API key in the `X-API-Key` header. Keys are free: sign in with Steam at https://rust.wiki/api-keys and create one. Each key has a generous daily quota per category (see the `x-quotas` extension and the docs) plus a burst limit of 300 requests per minute. Prices are integer USD cents unless stated; timestamps are UTC ISO-8601.","contact":{"name":"RustProfit","url":"https://rust.wiki/docs"},"license":{"name":"Free for any use with attribution","url":"https://rust.wiki/docs#terms"},"version":"1.0.0"},"servers":[{"url":"https://rust.wiki/api/v1"}],"paths":{"/me":{"get":{"tags":["account"],"summary":"Your key's usage and remaining quota for today","description":"Returns the key's name and prefix, the SteamID64 of the account that owns it, and for every category the\ndaily `limit`, `used` and `remaining` counts (UTC day), plus the per-minute burst window, the forced\ninventory-refresh allowance and `resets_in_seconds`. This call is not counted against any quota, so poll it\nfreely. Every other response also carries the same numbers for its own category in the `X-RateLimit-*` headers.","operationId":"me_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"key":{"name":"Docs examples (Claude, 2026-10-01)","prefix":"rw_live_fd645f","owner_steamid":"76561198869732295","created_at":"2026-10-01T06:39:16.630147","last_used_at":"2026-10-03T00:09:02.349619"},"free":true,"day":"2026-10-03","resets_in_seconds":85372,"resets_at":"2026-10-03T23:59:59Z","categories":{"items":{"label":"Items","limit":25000,"used":0,"remaining":25000},"skins":{"label":"Skins","limit":25000,"used":0,"remaining":25000},"market":{"label":"Market & prices","limit":10000,"used":0,"remaining":10000},"…":"10 more keys"},"burst":{"limit_per_minute":300,"used_this_minute":0,"remaining_this_minute":300},"inventory_refreshes":{"limit":100,"used":0}}}}}}}},"/items":{"get":{"tags":["items"],"summary":"Browse or search the item catalogue","description":"One page of live items (seasonal, obsolete and unreleased items are excluded from browsing but still\nresolve by shortname). Each result carries `shortname`, `display_name`, `category`, `icon_url` and\n`is_craftable`; fetch `/items/{shortname}` for everything else. Same ordering and cache as the /items page\non the site (15 minutes).","operationId":"list_items_items_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"enum":["weapon","construction","general","resource","attire","tool","medical","food","ammo","trap","component","electrical","fun","misc"],"type":"string"},{"type":"null"}],"description":"Restrict to one of the 14 wiki.facepunch.com item categories.","examples":["weapon"],"title":"Category"},"description":"Restrict to one of the 14 wiki.facepunch.com item categories."},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}],"description":"Fuzzy name search: substring match plus trigram similarity, so a typo like `asault` still finds the Assault Rifle. Results are ranked by similarity unless `sort=category`.","examples":["assault"],"title":"Search"},"description":"Fuzzy name search: substring match plus trigram similarity, so a typo like `asault` still finds the Assault Rifle. Results are ranked by similarity unless `sort=category`."},{"name":"sort","in":"query","required":false,"schema":{"enum":["name","category"],"type":"string","description":"`name` = alphabetical (similarity-ranked while searching); `category` = grouped by category, then name.","default":"name","title":"Sort"},"description":"`name` = alphabetical (similarity-ranked while searching); `category` = grouped by category, then name."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number.","default":1,"title":"Page"},"description":"1-based page number."},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page (max 200).","default":50,"title":"Per Page"},"description":"Results per page (max 200)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":50,"total":3,"pages":1,"results":[{"shortname":"rifle.ak","display_name":"Assault Rifle","category":"weapon","icon_url":"https://files.facepunch.com/rust/item/rifle.ak_512.png","is_craftable":true},{"shortname":"rifle.lr300","display_name":"LR-300 Assault Rifle","category":"weapon","icon_url":"https://files.facepunch.com/rust/item/rifle.lr300_512.png","is_craftable":false},{"shortname":"rifle.lr300.space","display_name":"Space LR-300 Assault Rifle","category":"weapon","icon_url":"https://rust.wiki/static/assets/rusthelp/items/rifle.lr300.space.png","is_craftable":false}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/items/categories":{"get":{"tags":["items"],"summary":"Item categories with item counts","description":"The 14 categories in the site's display order (wiki.facepunch.com's own sidebar order, not alphabetical),\neach with the number of live items in it, plus `total`. Use the `category` value as the `category` filter of\n`/items`. Cached for one hour.","operationId":"list_categories_items_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"total":1098,"results":[{"category":"weapon","count":99},{"category":"construction","count":69},{"category":"general","count":202},"… 11 more"]}}}}}}},"/items/search":{"get":{"tags":["items"],"summary":"Item name / shortname typeahead","description":"Up to 25 live items matching `q`, best match first: a case-insensitive substring match on the display\nname OR the shortname, plus trigram similarity on the display name so typos still resolve (`asault` finds\nthe Assault Rifle) - the same ILIKE + similarity search the site's item pickers use. Each result is\n`{shortname, display_name, category, icon_url}`; use the shortname with `/items/{shortname}`. For filtered,\npaginated results use `/items?search=` instead. Cached for 5 minutes per query.","operationId":"search_items_items_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":80,"description":"Part of an item's display name or shortname (2+ characters).","examples":["assault"],"title":"Q"},"description":"Part of an item's display name or shortname (2+ characters)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"query":"assault","results":[{"shortname":"rifle.ak","display_name":"Assault Rifle","category":"weapon","icon_url":"https://files.facepunch.com/rust/item/rifle.ak_512.png"},{"shortname":"rifle.lr300","display_name":"LR-300 Assault Rifle","category":"weapon","icon_url":"https://files.facepunch.com/rust/item/rifle.lr300_512.png"},{"shortname":"rifle.lr300.space","display_name":"Space LR-300 Assault Rifle","category":"weapon","icon_url":"https://rust.wiki/static/assets/rusthelp/items/rifle.lr300.space.png"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/items/{shortname}":{"get":{"tags":["items"],"summary":"Full item detail bundle","description":"Everything the item page shows, in one response: `item` (name, description, category, icon, stack size,\ndespawn seconds, craftable flag), `recipe` (components with quantities), `blueprint_costs` (unlock source,\nscrap cost, workbench tier), `recycle` (yields per recycler type with chance), `repair`, `loot_sources`\n(every crate/NPC/barrel that drops it, with `chance_pct` and `amount`, highest chance first), `used_in`\n(items this one is an ingredient of), `skins` (the first 24 skins by price, each with `price` and\n`store_price` in USD cents, `subscriptions` and `released`), `skins_total` and `similar` (six items from the\nsame category). Page through all skins with `/items/{shortname}/skins`. Cached for 15 minutes.","operationId":"item_detail_items__shortname__get","parameters":[{"name":"shortname","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":80,"description":"The item's shortname, e.g. `rifle.ak` or `metal.fragments`.","examples":["rifle.ak"],"title":"Shortname"},"description":"The item's shortname, e.g. `rifle.ak` or `metal.fragments`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"item":{"shortname":"rifle.ak","display_name":"Assault Rifle","description":"High damage machine rifle.","category":"weapon","icon_url":"https://files.facepunch.com/rust/item/rifle.ak_512.png","stack_size":1,"despawn_seconds":3600,"is_craftable":true},"recipe":[{"shortname":"wood","display_name":"Wood","icon_url":"https://files.facepunch.com/rust/item/wood_512.png","quantity":200},{"shortname":"metal.refined","display_name":"High Quality Metal","icon_url":"https://files.facepunch.com/rust/item/metal.refined_512.png","quantity":50},{"shortname":"metalspring","display_name":"Metal Spring","icon_url":"https://files.facepunch.com/rust/item/metalspring_512.png","quantity":4},"… 1 more"],"blueprint_costs":[{"unlock_source":"research_table","scrap_cost":120,"workbench_tier":null},{"unlock_source":"tech_tree","scrap_cost":500,"workbench_tier":3}],"recycle":[{"recycler_type":"recycler","shortname":"wood","display_name":"Wood","icon_url":"https://files.facepunch.com/rust/item/wood_512.png","quantity":120,"chance":1.0},{"recycler_type":"recycler","shortname":"metal.refined","display_name":"High Quality Metal","icon_url":"https://files.facepunch.com/rust/item/metal.refined_512.png","quantity":30,"chance":1.0},{"recycler_type":"recycler","shortname":"metalspring","display_name":"Metal Spring","icon_url":"https://files.facepunch.com/rust/item/metalspring_512.png","quantity":2,"chance":1.0},"… 7 more"],"repair":[{"shortname":"metal.refined","display_name":"High Quality Metal","icon_url":"https://files.facepunch.com/rust/item/metal.refined_512.png","quantity":13,"condition_restored_pct":20},{"shortname":"wood","display_name":"Wood","icon_url":"https://files.facepunch.com/rust/item/wood_512.png","quantity":40,"condition_restored_pct":20}],"loot_sources":[{"source_id":6,"source_name":"Locked Crate (Ghost Ship)","amount":1,"chance_pct":31.6},{"source_id":86,"source_name":"Locked Crate (Oil Rig)","amount":1,"chance_pct":31.6},{"source_id":156,"source_name":"Locked Crate - Oilrig","amount":1,"chance_pct":28.451},"… 19 more"],"used_in":[],"skins":[{"itemdefid":22003,"itemshortname":"rifle.ak","name":"Glory AK47","…":"19 more keys"},{"itemdefid":21008,"itemshortname":"rifle.ak","name":"Alien Red","…":"19 more keys"},{"itemdefid":64708,"itemshortname":"rifle.ak","name":"After Death AR","…":"19 more keys"},"… 21 more"],"skins_total":339,"similar":[{"shortname":"weapon.mod.small.scope","display_name":"8x Zoom Scope","icon_url":"https://files.facepunch.com/rust/item/weapon.mod.small.scope_512.png"},{"shortname":"ballista.static","display_name":"Ballista","icon_url":"https://files.facepunch.com/rust/item/ballista.static_512.png"},{"shortname":"mace.baseballbat","display_name":"Baseball Bat","icon_url":"https://rust.wiki/static/assets/rusthelp/items/mace.baseballbat.png"},"… 3 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/items/{shortname}/skins":{"get":{"tags":["items"],"summary":"All skins for an item, priced","description":"Every skin for one base item, most expensive first (unpriced skins last, then by name) - the same list\nand order as the Skins tab on the item page. Each skin carries `itemdefid`, `name`, `icon_url`,\n`market_hash_name`, `item_collection`, `workshopid`, `price` (canonical wiki price, USD cents, null when\nnothing is listed), `store_price` (its original Rust item-store price, USD cents), `store_change_pct`,\n`subscriptions` (Workshop subscriber count), `released` and the tradable/marketable/banned flags. Prices\nrefresh about every 12 minutes; this list is cached for 15.","operationId":"item_skins_items__shortname__skins_get","parameters":[{"name":"shortname","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":80,"description":"The item's shortname, e.g. `rifle.ak`.","examples":["rifle.ak"],"title":"Shortname"},"description":"The item's shortname, e.g. `rifle.ak`."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number.","default":1,"title":"Page"},"description":"1-based page number."},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page (max 200).","default":50,"title":"Per Page"},"description":"Results per page (max 200)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":50,"total":339,"pages":7,"results":[{"itemdefid":22003,"itemshortname":"rifle.ak","name":"Glory AK47","…":"19 more keys"},{"itemdefid":21008,"itemshortname":"rifle.ak","name":"Alien Red","…":"19 more keys"},{"itemdefid":64708,"itemshortname":"rifle.ak","name":"After Death AR","…":"19 more keys"},"… 47 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/skins":{"get":{"tags":["skins"],"summary":"Browse skins with the site's filters and sorts","description":"One page of skin cards exactly as the /skins browser shows them: `itemdefid`, `name`, icons, `category`,\n`item_collection`, `market_hash_name`, flags (`is_twitch_drop`, `is_limited_time`, `marketable`, `tradable`,\n`is_permanent`...), `price` (canonical wiki price in cents, null when Steam has no listing), `subscriptions`\n(Workshop subscribers, the site's supply proxy), `store_price` (the original item-store price in cents),\n`store_change_pct` (market price vs store price) and `released` (date accepted into the store). Filters combine\nwith AND. `total` is the filtered count; results are cached for 120 seconds per filter combination.","operationId":"list_skins_skins_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"enum":["weapon","clothing","deployable","decoration","crate","resource","mask","none"],"type":"string"},{"type":"null"}],"description":"Skin category.","examples":["weapon"],"title":"Category"},"description":"Skin category."},{"name":"collection","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"description":"Exact collection name, e.g. `Forest Raiders` (see /skins/collections).","title":"Collection"},"description":"Exact collection name, e.g. `Forest Raiders` (see /skins/collections)."},{"name":"item","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"description":"Base item shortname, e.g. `rifle.ak` - every skin of that one item.","title":"Item"},"description":"Base item shortname, e.g. `rifle.ak` - every skin of that one item."},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":100},{"type":"null"}],"description":"Fuzzy name search (trigram similarity; with sort=name results are relevance-ordered). Searches are never cached server-side.","title":"Search"},"description":"Fuzzy name search (trigram similarity; with sort=name results are relevance-ordered). Searches are never cached server-side."},{"name":"creator","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"description":"Workshop creator: a 17-digit SteamID64 for an exact match, or part of the creator's display name.","title":"Creator"},"description":"Workshop creator: a 17-digit SteamID64 for an exact match, or part of the creator's display name."},{"name":"color","in":"query","required":false,"schema":{"anyOf":[{"enum":["red","orange","yellow","green","cyan","blue","purple","pink","brown","white","gray","black","tan","olive","navy","maroon","silver"],"type":"string"},{"type":"null"}],"description":"Dominant icon colour bucket; matches any of a skin's up to five dominant colours.","title":"Color"},"description":"Dominant icon colour bucket; matches any of a skin's up to five dominant colours."},{"name":"limited_time","in":"query","required":false,"schema":{"type":"boolean","description":"Only limited-time store items.","default":false,"title":"Limited Time"},"description":"Only limited-time store items."},{"name":"permanent","in":"query","required":false,"schema":{"type":"boolean","description":"Only permanent store items.","default":false,"title":"Permanent"},"description":"Only permanent store items."},{"name":"marketable","in":"query","required":false,"schema":{"type":"boolean","description":"Only Steam-marketable skins.","default":false,"title":"Marketable"},"description":"Only Steam-marketable skins."},{"name":"tradable","in":"query","required":false,"schema":{"type":"boolean","description":"Only tradable skins.","default":false,"title":"Tradable"},"description":"Only tradable skins."},{"name":"breakable","in":"query","required":false,"schema":{"type":"boolean","description":"Only skins with a recycle yield (`recycle_hint`).","default":false,"title":"Breakable"},"description":"Only skins with a recycle yield (`recycle_hint`)."},{"name":"glows","in":"query","required":false,"schema":{"type":"boolean","description":"Only skins with glow-in-the-dark elements.","default":false,"title":"Glows"},"description":"Only skins with glow-in-the-dark elements."},{"name":"commodity","in":"query","required":false,"schema":{"type":"boolean","description":"Only Steam commodity items.","default":false,"title":"Commodity"},"description":"Only Steam commodity items."},{"name":"hide_drops","in":"query","required":false,"schema":{"type":"boolean","description":"Hide loot-crate drops, publisher drops and Twitch drops (what the site calls DLCs and drops).","default":false,"title":"Hide Drops"},"description":"Hide loot-crate drops, publisher drops and Twitch drops (what the site calls DLCs and drops)."},{"name":"min_subs","in":"query","required":false,"schema":{"anyOf":[{"enum":["1000","5000","10000","25000","50000"],"type":"string"},{"type":"null"}],"description":"Minimum Steam Workshop subscriber count of the skin's original submission.","title":"Min Subs"},"description":"Minimum Steam Workshop subscriber count of the skin's original submission."},{"name":"released","in":"query","required":false,"schema":{"anyOf":[{"enum":["2026","2025","2024","2023","2022","2021","2020","2019","2018","2017","2016","2015"],"type":"string"},{"type":"null"}],"description":"Year the skin was accepted into the item store.","title":"Released"},"description":"Year the skin was accepted into the item store."},{"name":"sort","in":"query","required":false,"schema":{"enum":["price_desc","price_asc","name","popularity","supply_asc","released_desc","released_asc","trending","marketcap_desc"],"type":"string","description":"Ordering. `popularity` and `supply_asc` use Workshop subscribers; `trending` is the 7-day price change; `marketcap_desc` is price x subscribers.","examples":["price_desc"],"default":"price_desc","title":"Sort"},"description":"Ordering. `popularity` and `supply_asc` use Workshop subscribers; `trending` is the 7-day price change; `marketcap_desc` is price x subscribers."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number.","default":1,"title":"Page"},"description":"1-based page number."},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page (max 200).","default":50,"title":"Per Page"},"description":"Results per page (max 200)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":50,"total":1984,"pages":40,"results":[{"itemdefid":67303,"itemshortname":"rifle.sks","name":"Limited Edition Training SKS","…":"19 more keys"},{"itemdefid":20413,"itemshortname":"smg.2","name":"Alien Relic SMG","…":"19 more keys"},{"itemdefid":54500,"itemshortname":"pistol.revolver","name":"No Mercy Revolver - E Class","…":"19 more keys"},"… 47 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/skins/search":{"get":{"tags":["skins"],"summary":"Skin name typeahead","description":"Up to 10 skins whose name matches `q`, best match first (the same ILIKE + trigram search the site's search\nboxes use). Each result is `{itemdefid, name, icon_url}`; use the `itemdefid` with the other skin endpoints.\nFor filtered, paginated results use GET /skins with `search=` instead.","operationId":"search_skins_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":100,"description":"Part of a skin name (2+ characters).","examples":["tempered"],"title":"Q"},"description":"Part of a skin name (2+ characters)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"query":"tempered","results":[{"itemdefid":66507,"name":"Tempered Bed","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/66507_small.png?530873102"},{"itemdefid":29206,"name":"Tempered SMG","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/29206_small.png?1811368173"},{"itemdefid":41907,"name":"Tempered BAR","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/41907_small.png?4108887431"},"… 7 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/skins/collections":{"get":{"tags":["skins"],"summary":"Skin collections with counts and values","description":"Every skin collection (about 750, e.g. `Forest Raiders`, `Abyss`): `name`, `count` (members), `total_value`\nand `avg_value` (cents, over the priced members only; null when nothing in it is priced) and `icons`, one\n`{url, name}` per member skin. The collection's URL slug is its lower-cased name with non-alphanumerics\ncollapsed to `-` (`Forest Raiders` -> `forest-raiders`), which is what GET /skins/collections/{slug} takes.\nCached for 30 minutes.","operationId":"list_collections_skins_collections_get","parameters":[{"name":"sort","in":"query","required":false,"schema":{"enum":["value_desc","value_asc","count_desc","count_asc","name"],"type":"string","description":"`value_*` sorts by the summed wiki price of the collection's skins, `count_*` by member count.","examples":["value_desc"],"default":"value_desc","title":"Sort"},"description":"`value_*` sorts by the summed wiki price of the collection's skins, `count_*` by member count."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number.","default":1,"title":"Page"},"description":"1-based page number."},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page (max 200).","default":50,"title":"Per Page"},"description":"Results per page (max 200)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":50,"total":962,"pages":20,"results":[{"name":"Training","count":25,"total_value":207747,"avg_value":8310,"icons":[{"url":"https://files.facepunch.com/rust/icons/inventory/rust/67303_small.png?2937526183","name":"Limited Edition Training SKS"},{"url":"https://files.facepunch.com/rust/icons/inventory/rust/36500_small.png?1193358283","name":"Training AR"},{"url":"https://files.facepunch.com/rust/icons/inventory/rust/64407_small.png?3469452427","name":"Training Backpack"},"… 22 more"]},{"name":"No Mercy","count":53,"total_value":152285,"avg_value":2929,"icons":[{"url":"https://files.facepunch.com/rust/icons/inventory/rust/33107_small.png?17669496","name":"No Mercy AK47"},{"url":"https://files.facepunch.com/rust/icons/inventory/rust/50802_small.png?1195794693","name":"No Mercy Armored Door"},{"url":"https://files.facepunch.com/rust/icons/inventory/rust/69300_small.png?241887439","name":"No Mercy Auto Turret"},"… 50 more"]},{"name":"Horror","count":5,"total_value":126688,"avg_value":25338,"icons":[{"url":"https://files.facepunch.com/rust/icons/inventory/rust/10107_small.png?717639237","name":"Horror Bag"},{"url":"https://files.facepunch.com/rust/icons/inventory/rust/66110_small.png?788791927","name":"Horror Bed"},{"url":"https://files.facepunch.com/rust/icons/inventory/rust/34708_small.png?1517349008","name":"Horror Chest Plate"},"… 2 more"]},"… 47 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/skins/collections/{slug}":{"get":{"tags":["skins"],"summary":"One collection with all its skins","description":"The collection's `name`, `slug`, `count`, `total_value` and `avg_value` (cents), `released` (the earliest\nmember's store-acceptance date) and `skins`: every member as `{itemdefid, name, icon_url, rarity, category,\nprice}` ordered by price, highest first. The collection's value-over-time series is GET\n/market/collection-value. Cached for 30 minutes.","operationId":"collection_skins_collections__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","maxLength":120,"description":"Collection slug (lower-case, hyphenated name), e.g. `forest-raiders`.","examples":["forest-raiders"],"title":"Slug"},"description":"Collection slug (lower-case, hyphenated name), e.g. `forest-raiders`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"name":"Forest Raiders","slug":"forest-raiders","skins":[{"itemdefid":44201,"name":"Forest Raiders Roadsign Pants","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/44201_small.png?685985818","rarity":"a7ec2e","category":"clothing","price":9193},{"itemdefid":44202,"name":"Forest Raiders Roadsign Vest","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/44202_small.png?1414360230","rarity":"a7ec2e","category":"clothing","price":6072},{"itemdefid":44203,"name":"Forest Raiders Helmet","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/44203_small.png?1493227454","rarity":"a7ec2e","category":"clothing","price":6024},"… 9 more"],"count":12,"total_value":36852,"avg_value":3071,"released":"2021-07-29"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/skins/{itemdefid}":{"get":{"tags":["skins"],"summary":"Full skin detail: price, order book, history, cross-market prices","description":"Everything the skin's wiki page shows, as data. `skin` is the full catalogue record (creator, workshop\ntitle and dates, collection, flags, store price and availability, crafting components, glow/cutout ratios,\ncolours). `price` is the canonical wiki price in cents and `price_source` says which side of the book it came\nfrom. `orderbook` is Steam's live book: lowest sell order, highest buy order, order counts, the `buy_orders`\nand `sell_orders` depth ladders (`{price, quantity}`, best first) and `fetched_at`; the headline price\nrefreshes more often than the ladders, so they can briefly trail it. `steam_history` is the last year of\nSteam's own sale history (`recorded_at`, median sale `price`, `volume`; `sale_basis` false means Steam has no\nsale series and the points are our ask-price readings instead) - wider ranges via /skins/{itemdefid}/history.\n`market_stats` is the page's Community & Market Stats card: an archived SCMM snapshot (frozen September 2026)\nof `supply_total`/`supply_total_estimated`/`supply_total_owners_estimated`, Workshop `subscriptions_current`/\n`subscriptions_lifetime`, `favourited_current`, `views`, `votes_up`/`votes_down`, `market_24hr_value`,\n`market_168hr_value`, `market_last_30d_sales`, `market_rank_index`, `market_liquidity_score`, the market\nhigh/low with their dates, `change_7d_percent`/`change_30d_percent`/`change_90d_percent` and `ath_percent`;\nnull for skins SCMM never covered. `cross_market` is live and always present: `market_prices`, the current\nprice and stock on each third-party marketplace we poll (`marketType`, `price` in cents, `supply`; names only,\nno links), plus the cheapest as `buy_now_price`/`buy_now_from`. `est_supply` (Workshop subscribers or SCMM\nestimate) and `est_market_cap` (price x supply) are the site's stated approximations. Also `store_rotations`\nthe skin appeared in, `collection_items` and `other_item_skins` (sibling cards), `description`, and\n`tracked_holders` (`holders`/`units` seen in scanned inventories). Cached for 15 minutes; the cross-market\nblock refreshes every ~5.","operationId":"skin_skins__itemdefid__get","parameters":[{"name":"itemdefid","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"The skin's Steam item definition id (also its rust.wiki URL: /skin/{itemdefid}).","examples":[10138],"title":"Itemdefid"},"description":"The skin's Steam item definition id (also its rust.wiki URL: /skin/{itemdefid})."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"skin":{"itemdefid":10138,"itemshortname":"rifle.ak","name":"Tempered AK47","…":"38 more keys"},"price":999,"steam_history":[{"recorded_at":"2025-10-03","price":970,"volume":28},{"recorded_at":"2025-10-04","price":896,"volume":24},{"recorded_at":"2025-10-05","price":946,"volume":22},"… 362 more"],"sale_basis":true,"orderbook":{"lowest_sell_order":999,"highest_buy_order":952,"sell_order_count":96,"buy_order_count":731,"buy_orders":[{"price":952,"quantity":4},{"price":951,"quantity":2},{"price":947,"quantity":6},"… 137 more"],"sell_orders":[{"price":999,"quantity":1},{"price":1010,"quantity":1},{"price":1021,"quantity":1},"… 65 more"],"fetched_at":"2026-10-03T00:04:16.404971"},"sale_updated":"2026-10-03T00:04:17.363621","market_stats":{"supply_total":4889,"supply_total_estimated":4889,"supply_total_owners_estimated":null,"…":"23 more keys"},"description":"A tempered metal AK47\n\nThis is a skin for the Assault Rifle item. You will be able to apply this skin at a repair bench or when you craft the item in game.\n\nBre…","est_supply":4889,"est_market_cap":4884111,"store_rotations":[],"collection_items":[{"itemdefid":20083,"itemshortname":"smg.mp5","name":"Tempered Mp5","…":"19 more keys"},{"itemdefid":20082,"itemshortname":"metal.facemask","name":"Tempered Mask","…":"19 more keys"},{"itemdefid":50803,"itemshortname":"wall.frame.garagedoor","name":"Tempered Garage Door","…":"19 more keys"},"… 21 more"],"…":"8 more keys"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/skins/{itemdefid}/orderbook":{"get":{"tags":["skins"],"summary":"Full Steam order book for one skin","description":"Steam Community Market's current order book for the skin, straight from our scraper's latest snapshot:\n`lowest_sell_order` and `highest_buy_order` (cents; null when that side is empty), `sell_order_count` and\n`buy_order_count`, the COMPLETE `sell_orders` and `buy_orders` depth ladders as `[{price, quantity}, ...]`\nbest price first (every level Steam publishes, not a top-N cut), and `fetched_at`, when the snapshot was taken.\nThe headline ask is refreshed by a market-wide sweep every ~12 minutes; the depth ladders come from the\nper-item rotation (every few hours), so they can trail it slightly. 404 when the skin has no Steam order book\n(unmarketable items). Not cached: this is one indexed row.","operationId":"orderbook_skins__itemdefid__orderbook_get","parameters":[{"name":"itemdefid","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"The skin's item definition id.","examples":[10138],"title":"Itemdefid"},"description":"The skin's item definition id."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"itemdefid":10138,"market_hash_name":"Tempered AK47","unit":"cents","lowest_sell_order":999,"highest_buy_order":952,"sell_order_count":96,"buy_order_count":731,"sell_orders":[{"price":999,"quantity":1},{"price":1010,"quantity":1},{"price":1021,"quantity":1},"… 65 more"],"buy_orders":[{"price":952,"quantity":4},{"price":951,"quantity":2},{"price":947,"quantity":6},"… 137 more"],"fetched_at":"2026-10-03T00:04:16.404971"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/skins/{itemdefid}/history":{"get":{"tags":["skins"],"summary":"Steam sale history for one skin","description":"Steam Community Market's own sale history for the skin, scraped from Steam's listing page: `points` of\n`{recorded_at, price, volume}` where `price` is Steam's median sale price for that interval in cents and\n`volume` the number of sales. Steam reports roughly hourly points for the recent month and daily beyond; ranges\nof a year or more are condensed to one point per day (median price, summed volume). Empty when Steam has no\nsale series for the item (unmarketable skins). History goes back to the skin's first sale, as far as 2015.\nRefreshed continuously; the full series is cached for an hour.","operationId":"history_skins__itemdefid__history_get","parameters":[{"name":"itemdefid","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"The skin's item definition id.","examples":[10138],"title":"Itemdefid"},"description":"The skin's item definition id."},{"name":"range","in":"query","required":false,"schema":{"enum":["1d","1w","1m","3m","6m","1y","2y","5y","all"],"type":"string","description":"How far back: `1d`, `1w`, `1m`, `3m`, `6m`, `1y`, `2y`, `5y` or `all`.","examples":["1y"],"default":"1y","title":"Range"},"description":"How far back: `1d`, `1w`, `1m`, `3m`, `6m`, `1y`, `2y`, `5y` or `all`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"itemdefid":10138,"range":"1y","points":[{"recorded_at":"2025-10-03","price":970,"volume":28},{"recorded_at":"2025-10-04","price":896,"volume":24},{"recorded_at":"2025-10-05","price":946,"volume":22},"… 362 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/skins/{itemdefid}/price":{"get":{"tags":["skins"],"summary":"Live price, order book depth, extremes and 7d/30d change for one skin","description":"The compact price card the rust.wiki Discord bot's /price command shows, as data. All prices are integer USD\ncents: `price_cents` (the canonical wiki price - Steam's lowest sell order, or the highest buy order when\nnothing is listed), `ask_cents` and `bid_cents` (the two sides of Steam's book), `sell_orders`/`buy_orders`\n(how many orders stand on each side), `sell_ladder` and `buy_ladder` (the top five price levels on each side,\nbest first, as `{price, quantity}`), `ath_cents`/`atl_cents` (the skin's all-time high and low from Steam's\nsale history), `change_7d`/`change_30d` (percent move of today's price against our closest Steam price reading\n7 and 30 days back; null without enough history) and `sales_30d` (units sold on Steam in the last 30 days,\nnull when none). Plus `name`, `icon_url`, `market_hash_name` and `category`. Cached for 5 minutes.","operationId":"price_bundle_skins__itemdefid__price_get","parameters":[{"name":"itemdefid","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"The skin's item definition id.","examples":[10138],"title":"Itemdefid"},"description":"The skin's item definition id."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"itemdefid":10138,"name":"Tempered AK47","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/10138_small.png?1255120650","market_hash_name":"Tempered AK47","category":"weapon","price_cents":999,"ask_cents":999,"bid_cents":952,"sell_orders":96,"buy_orders":731,"sell_ladder":[{"price":999,"quantity":1},{"price":1010,"quantity":1},{"price":1021,"quantity":1},"… 2 more"],"buy_ladder":[{"price":952,"quantity":4},{"price":951,"quantity":2},{"price":947,"quantity":6},"… 2 more"],"…":"5 more keys"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/skins/{itemdefid}/holders":{"get":{"tags":["skins"],"summary":"Who holds this skin (scanned inventories)","description":"The largest known holders of the skin, most units first: `{steamid64, display_name, avatar_url, quantity}`.\nThis is the same public Top Holders list the skin page shows, built only from inventories that someone has run\nthrough the rust.wiki/inventory lookup - `total` is the number of such holders and `tracked_units` the units they\nhold between them, not the skin's circulating supply. Cached for 30 minutes.","operationId":"holders_skins__itemdefid__holders_get","parameters":[{"name":"itemdefid","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"The skin's item definition id.","examples":[10138],"title":"Itemdefid"},"description":"The skin's item definition id."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number.","default":1,"title":"Page"},"description":"1-based page number."},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page (max 200).","default":50,"title":"Per Page"},"description":"Results per page (max 200)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":50,"total":1777,"pages":36,"results":[{"steamid64":"76561198297663226","display_name":"TRADEIT MultiTrade BOT #1","avatar_url":"https://avatars.steamstatic.com/ac9abb720c0244baaefe7422d59d5bb55bebd643_full.jpg","quantity":129},{"steamid64":"76561198181645734","display_name":"$HAI","avatar_url":"https://avatars.steamstatic.com/a0e47c77e305e51dee64f931952a1df08cda655d_full.jpg","quantity":100},{"steamid64":"76561199273425385","display_name":"east","avatar_url":"https://avatars.steamstatic.com/abca83d1b8eaad487b2f5d10fb803a7316c61f9f_full.jpg","quantity":91},"… 47 more"],"tracked_units":2482}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/market/prices":{"get":{"tags":["market"],"summary":"Steam price of every skin, in one response","description":"Every skin's Steam Community Market price in one blob (about 6,000 priced skins; ~0.7 MB in `full`, ~0.2 MB\nin `simple`): `prices` is keyed by Steam `market_hash_name`, values in integer USD cents. `price` is the\ncanonical wiki price - the lowest sell order, or the highest buy order when nothing is listed for sale -\nexactly what every rust.wiki page displays. Steam only; third-party marketplace prices live at\nGET /market/marketplaces. Regenerated at most every 5 minutes (`generated_at`); the underlying Steam order\nbooks refresh every ~12 minutes, so polling faster than that gains nothing. Send `Accept-Encoding: gzip`.\nSingle skins: GET /market/prices/{itemdefid}.","operationId":"prices_market_prices_get","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","description":"`full` (default): `{itemdefid, price, lowest_sell_order, highest_buy_order}` per skin. `simple`: just `{market_hash_name: price}` - the smallest possible price list.","examples":["simple"],"default":"full","title":"Format"},"description":"`full` (default): `{itemdefid, price, lowest_sell_order, highest_buy_order}` per skin. `simple`: just `{market_hash_name: price}` - the smallest possible price list."},{"name":"include_unpriced","in":"query","required":false,"schema":{"type":"boolean","description":"Also list skins Steam has no order book for (price null). Off by default, so every entry has a price.","default":false,"title":"Include Unpriced"},"description":"Also list skins Steam has no order book for (price null). Off by default, so every entry has a price."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"generated_at":"2026-10-03T00:17:08.579780Z","unit":"cents","source":"steam","format":"simple","count":5523,"prices":{"Red Tshirt":15,"Demonic Pistol":5996,"Blue Jeans":15,"…":"5520 more keys"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/market/prices/{itemdefid}":{"get":{"tags":["market"],"summary":"Canonical wiki price for one skin","description":"One entry of /market/prices: `market_hash_name`, `price` (canonical wiki price, cents, null when Steam has\nno order book for it), `lowest_sell_order`, `highest_buy_order` and the blob's `generated_at`. Served from the\nsame 5-minute blob, so it costs nothing extra to call per skin. 404 for an unknown id or a skin with no Steam\nmarket name.","operationId":"price_market_prices__itemdefid__get","parameters":[{"name":"itemdefid","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"The skin's item definition id.","examples":[10337],"title":"Itemdefid"},"description":"The skin's item definition id."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"generated_at":"2026-10-03T00:17:08.579780Z","unit":"cents","itemdefid":10337,"market_hash_name":"RPG Launcher","price":null,"lowest_sell_order":null,"highest_buy_order":null}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/market/marketplaces":{"get":{"tags":["market"],"summary":"Every skin's price on every third-party marketplace","description":"Current listing prices on the third-party marketplaces we poll directly (Skinport, CS.Deals, DMarket,\nRust.tm, CS.Trade, Waxpeer, LIS-Skins, Mannco.store, Swap.gg, Tradeit.gg, RapidSkins, Loot.farm, RustSkins):\n`prices` is keyed by Steam `market_hash_name`, each value a `{marketplace: price}` map. UNLIKE the rest of the\nAPI these prices are USD floats (`unit: \"usd\"`, e.g. 12.34) - this payload predates the API and outside\ntooling already reads it. Only marketplaces whose poller is currently alive are included (`sources`, with each\none's `polled_at`); a source that stopped polling is listed in `excluded_sources` with its last poll time\ninstead of serving stale prices. Listings a marketplace reports as out of stock are omitted. Cached 5 minutes,\nmatching the ~5-minute poll cycle.","operationId":"marketplaces_market_marketplaces_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"generated_at":"2026-10-03T00:17:09.389917Z","unit":"usd","sources":["CSDealsMarketplace","CSTrade","DMarket","… 10 more"],"polled_at":{"CSDealsMarketplace":"2026-10-03T00:11:41.877823","CSTrade":"2026-10-03T00:11:45.218818","DMarket":"2026-10-03T00:12:02.903897","…":"10 more keys"},"excluded_sources":{},"prices":{"Freshly Dug Grave":{"RapidSkins":400.95,"Waxpeer":533.28,"ManncoStore":585.99,"RustSkins":389.62,"Skinport":422.25,"CSDealsMarketplace":449.89,"DMarket":402.96},"Banana Leaf Bandana":{"RustSkins":1.24,"TradeitGG":1.89,"DMarket":1.33,"ManncoStore":6.79,"CSDealsMarketplace":1.29,"Waxpeer":1.34,"Skinport":1.23,"RustTM":1.52,"LISSkins":1.28},"Large Fruit Pit Hatchet":{"Skinport":5.95,"RapidSkins":1.61,"LISSkins":1.59,"RustTM":1.62,"DMarket":7.0,"Waxpeer":1.62,"CSDealsMarketplace":2.98,"CSTrade":1.22},"…":"5505 more keys"}}}}}}}},"/market/index":{"get":{"tags":["market"],"summary":"Skin market index series","description":"The rust.wiki Market Index: a basket of skins rebased to 100 at the start of the window, like a stock\nindex, built from Steam's daily price history (one point per day; weekly beyond two years). Returns `dates`\n(ISO dates), `values` (index level, 100 = the window's first day), `constituent_count` (skins that had a price\nat the baseline; baskets are capped at 300 constituents) and `label`. A skin whose history starts inside the\nwindow joins from its first price. Cached for 24 hours per parameter combination (history only gains a point\nevery 6 hours); the full catalogue, every category and every collection are kept warm server-side.","operationId":"index_market_index_get","parameters":[{"name":"basket_type","in":"query","required":false,"schema":{"enum":["all","high_value","low_value","category","collection","color","item","custom"],"type":"string","description":"Which skins form the index: `all`, `high_value`/`low_value` (300 priciest/cheapest), `category`, `collection`, `color`, `item` (one base item's skins) or `custom` (your own list).","examples":["category"],"default":"all","title":"Basket Type"},"description":"Which skins form the index: `all`, `high_value`/`low_value` (300 priciest/cheapest), `category`, `collection`, `color`, `item` (one base item's skins) or `custom` (your own list)."},{"name":"basket_value","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"description":"The category, collection name, colour, item shortname, or for `custom` a comma-separated list of up to 300 itemdefids. Ignored for all/high_value/low_value.","examples":["weapon"],"title":"Basket Value"},"description":"The category, collection name, colour, item shortname, or for `custom` a comma-separated list of up to 300 itemdefids. Ignored for all/high_value/low_value."},{"name":"range","in":"query","required":false,"schema":{"enum":["7d","30d","90d","1y","2y","3y","4y","5y","all","custom"],"type":"string","description":"Window: `7d`, `30d`, `90d`, `1y`, `2y`, `3y`, `4y`, `5y`, `all`, or `custom` with `start_date`/`end_date`. Spans over two years are downsampled to one point per week.","examples":["90d"],"default":"90d","title":"Range"},"description":"Window: `7d`, `30d`, `90d`, `1y`, `2y`, `3y`, `4y`, `5y`, `all`, or `custom` with `start_date`/`end_date`. Spans over two years are downsampled to one point per week."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}],"description":"Custom range start (YYYY-MM-DD, inclusive). Only read when range=custom.","title":"Start Date"},"description":"Custom range start (YYYY-MM-DD, inclusive). Only read when range=custom."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}],"description":"Custom range end (YYYY-MM-DD, inclusive). Only read when range=custom.","title":"End Date"},"description":"Custom range end (YYYY-MM-DD, inclusive). Only read when range=custom."},{"name":"weight_mode","in":"query","required":false,"schema":{"enum":["equal","marketcap"],"type":"string","description":"`equal`: every constituent's % move counts the same. `marketcap`: weighted by price x Workshop subscribers, like an S&P-style index.","default":"equal","title":"Weight Mode"},"description":"`equal`: every constituent's % move counts the same. `marketcap`: weighted by price x Workshop subscribers, like an S&P-style index."},{"name":"smooth","in":"query","required":false,"schema":{"type":"boolean","description":"Apply a trailing 30-day moving average.","default":false,"title":"Smooth"},"description":"Apply a trailing 30-day moving average."},{"name":"trim_days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":0,"description":"Mask each constituent's first N days of history (0-90) to drop launch-week volatility.","default":0,"title":"Trim Days"},"description":"Mask each constituent's first N days of history (0-90) to drop launch-week volatility."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"dates":["2026-07-04","2026-07-05","2026-07-06","… 88 more"],"values":[100.0,100.01,100.2,"… 88 more"],"constituent_count":300,"label":"Weapon Skins"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/market/compare":{"get":{"tags":["market"],"summary":"Overlay skins, baskets and indices on one date axis","description":"The data behind rust.wiki/skins/compare: one shared `dates` axis and a `series` entry per token with\n`key`, `name`, `icon_url`, `is_basket`, `is_index` and `prices` aligned to the axis (null where that entry has\nno data yet). Skin and basket entries are prices in cents (a basket is the plain average of its members'\nprices); index entries are index levels rebased to 100. Spans over two years are downsampled to weekly points.\nCached for 24 hours per parameter combination.","operationId":"compare_market_compare_get","parameters":[{"name":"entries","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":400,"description":"Comma-separated, up to 8: an `itemdefid` (that skin's price), `category:weapon` / `collection:Forest Raiders` / `item:shoes.boots` (the basket's average price) or `index:all` / `index:category:weapon` / `index:custom:123.456` (an index entry; custom ids joined with `.`).","examples":["10337,10148,category:weapon"],"title":"Entries"},"description":"Comma-separated, up to 8: an `itemdefid` (that skin's price), `category:weapon` / `collection:Forest Raiders` / `item:shoes.boots` (the basket's average price) or `index:all` / `index:category:weapon` / `index:custom:123.456` (an index entry; custom ids joined with `.`)."},{"name":"range","in":"query","required":false,"schema":{"enum":["7d","30d","90d","1y","2y","3y","4y","5y","all","custom"],"type":"string","description":"Window: `7d`, `30d`, `90d`, `1y`, `2y`, `3y`, `4y`, `5y`, `all`, or `custom` with `start_date`/`end_date`. Spans over two years are downsampled to one point per week.","examples":["90d"],"default":"90d","title":"Range"},"description":"Window: `7d`, `30d`, `90d`, `1y`, `2y`, `3y`, `4y`, `5y`, `all`, or `custom` with `start_date`/`end_date`. Spans over two years are downsampled to one point per week."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}],"description":"Custom range start (YYYY-MM-DD, inclusive). Only read when range=custom.","title":"Start Date"},"description":"Custom range start (YYYY-MM-DD, inclusive). Only read when range=custom."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}],"description":"Custom range end (YYYY-MM-DD, inclusive). Only read when range=custom.","title":"End Date"},"description":"Custom range end (YYYY-MM-DD, inclusive). Only read when range=custom."},{"name":"smooth","in":"query","required":false,"schema":{"type":"boolean","description":"Apply a trailing 30-day moving average.","default":false,"title":"Smooth"},"description":"Apply a trailing 30-day moving average."},{"name":"trim_days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":0,"description":"Mask each constituent's first N days of history (0-90) to drop launch-week volatility.","default":0,"title":"Trim Days"},"description":"Mask each constituent's first N days of history (0-90) to drop launch-week volatility."},{"name":"index_weight_mode","in":"query","required":false,"schema":{"enum":["equal","marketcap"],"type":"string","description":"Weighting for any `index:` entries (see /market/index).","default":"equal","title":"Index Weight Mode"},"description":"Weighting for any `index:` entries (see /market/index)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"dates":["2026-07-05","2026-07-06","2026-07-07","… 87 more"],"series":[{"key":"skin:10337","name":"RPG Launcher","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/10337_small.png?2934967024","is_basket":false,"is_index":false,"prices":[]},{"key":"skin:10148","name":"Snowman","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/10148_small.png?2638033461","is_basket":false,"is_index":false,"prices":[120.0,117.0,111.0,"… 87 more"]},{"key":"category:weapon","name":"Weapon Skins (avg)","icon_url":null,"is_basket":true,"is_index":false,"prices":[239.75,239.74,239.8,"… 87 more"]}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/market/events":{"get":{"tags":["market"],"summary":"Collection and skin release dates for a chart's window","description":"Release markers to draw on an index or compare chart: `events` of `{date, label, icon_url, kind}` where\n`kind` is `collection` (the day a collection's first skin was accepted into the item store, labelled with the\ncollection name) or `item` (an individual skin's acceptance date, only when scoped). Scoped to the skins of\nthe given basket or compare entries so only releases related to what is plotted are returned; unscoped returns\nevery collection release in the window. There is no DLC concept in Steam's data - store-acceptance dates are\nthe release signal. Cached for an hour (5 minutes when scoped by `entries`).","operationId":"events_market_events_get","parameters":[{"name":"range","in":"query","required":false,"schema":{"enum":["7d","30d","90d","1y","2y","3y","4y","5y","all","custom"],"type":"string","description":"Window: `7d`, `30d`, `90d`, `1y`, `2y`, `3y`, `4y`, `5y`, `all`, or `custom` with `start_date`/`end_date`. Spans over two years are downsampled to one point per week.","examples":["1y"],"default":"90d","title":"Range"},"description":"Window: `7d`, `30d`, `90d`, `1y`, `2y`, `3y`, `4y`, `5y`, `all`, or `custom` with `start_date`/`end_date`. Spans over two years are downsampled to one point per week."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}],"description":"Custom range start (YYYY-MM-DD, inclusive). Only read when range=custom.","title":"Start Date"},"description":"Custom range start (YYYY-MM-DD, inclusive). Only read when range=custom."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}],"description":"Custom range end (YYYY-MM-DD, inclusive). Only read when range=custom.","title":"End Date"},"description":"Custom range end (YYYY-MM-DD, inclusive). Only read when range=custom."},{"name":"basket_type","in":"query","required":false,"schema":{"anyOf":[{"enum":["all","high_value","low_value","category","collection","color","item","custom"],"type":"string"},{"type":"null"}],"description":"Scope to an index basket (same meaning as /market/index). Omit both this and `entries` for every collection's release.","examples":["category"],"title":"Basket Type"},"description":"Scope to an index basket (same meaning as /market/index). Omit both this and `entries` for every collection's release."},{"name":"basket_value","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"description":"The basket's value (see /market/index).","examples":["weapon"],"title":"Basket Value"},"description":"The basket's value (see /market/index)."},{"name":"entries","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":400},{"type":"null"}],"description":"Scope to a /market/compare token list instead of a basket.","title":"Entries"},"description":"Scope to a /market/compare token list instead of a basket."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"range":"1y","start_date":null,"end_date":null,"count":70,"events":[{"date":"2025-10-09","label":"Black Ops","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/65807_small.png?1267695810","kind":"collection"},{"date":"2025-10-30","label":"From Hell","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/66115_small.png?491818776","kind":"collection"},{"date":"2025-11-06","label":"Abyss","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/66200_small.png?679648054","kind":"collection"},"… 67 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/market/collection-value":{"get":{"tags":["market"],"summary":"Total value of a collection over time","description":"The cost of owning one of every skin in the collection, day by day: `dates` and `values` (total in cents)\nplus `count`, the number of member skins with price history in the window. A skin whose history starts\nmid-window contributes its first known price backwards, so early totals are not \"the sum of fewer skins\".\nThis is the chart on rust.wiki/collections/{slug}. Cached 15 minutes so today's point tracks the scraper.","operationId":"collection_value_market_collection_value_get","parameters":[{"name":"collection","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":120,"description":"Exact collection name (see /skins/collections).","examples":["Forest Raiders"],"title":"Collection"},"description":"Exact collection name (see /skins/collections)."},{"name":"range","in":"query","required":false,"schema":{"enum":["7d","30d","90d","1y","2y","3y","4y","5y","all"],"type":"string","description":"Window: `7d`, `30d`, `90d`, `1y`, `2y`, `3y`, `4y`, `5y` or `all`.","examples":["90d"],"default":"90d","title":"Range"},"description":"Window: `7d`, `30d`, `90d`, `1y`, `2y`, `3y`, `4y`, `5y` or `all`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"collection":"Forest Raiders","range":"90d","dates":["2026-07-05","2026-07-06","2026-07-07","… 87 more"],"values":[40976,40870,42149,"… 87 more"],"count":12}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/market/deals":{"get":{"tags":["market"],"summary":"Executable buy-on-marketplace, sell-on-Steam flips","description":"Every skin that can be bought on a third-party marketplace for less than it nets on Steam Community Market\nright now, as rust.wiki/skins/deals computes it. Per deal: `buy_market` and `buy_price` (the cheapest in-stock\nlisting we poll, cents), `sell_url` (the Steam listing page), the two Steam references `bid_gross`/`bid_net`\n(highest buy order, and what you actually receive after Steam's 15% fee) and `ask_gross`/`ask_net` (lowest\nsell order, same), then for the chosen `steam_ref`: `sell_price` (the net proceeds), `sell_gross`,\n`spread_abs` (cents) and `spread_pct`. Only rows profitable under the chosen reference are returned. A stale\nbuy order above a fresher ask is capped at the ask. Filters combine with AND; `search` matches the skin name\ncase-insensitively. Marketplace links are not included. Recomputed every ~5 minutes from the marketplace\npoll.","operationId":"deals_market_deals_get","parameters":[{"name":"steam_ref","in":"query","required":false,"schema":{"enum":["buy","sell"],"type":"string","description":"Steam exit price: `buy` = sell instantly into the highest buy order (default), `sell` = list just under the lowest sell order.","examples":["buy"],"default":"buy","title":"Steam Ref"},"description":"Steam exit price: `buy` = sell instantly into the highest buy order (default), `sell` = list just under the lowest sell order."},{"name":"sort","in":"query","required":false,"schema":{"enum":["pct","abs"],"type":"string","description":"Best `pct` (spread as % of buy price) or `abs` (spread in cents) first.","examples":["pct"],"default":"pct","title":"Sort"},"description":"Best `pct` (spread as % of buy price) or `abs` (spread in cents) first."},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"enum":["weapon","clothing","deployable","decoration","crate","resource","mask","none"],"type":"string"},{"type":"null"}],"description":"Only skins of this category.","title":"Category"},"description":"Only skins of this category."},{"name":"marketplace","in":"query","required":false,"schema":{"type":"array","items":{"enum":["Skinport","CSDealsMarketplace","DMarket","RustTM","CSTrade","Waxpeer","LISSkins","ManncoStore","SwapGGTrade","TradeitGG","RapidSkins","LootFarm","RustSkins"],"type":"string"},"description":"Only deals whose cheapest listing is on one of these marketplaces (repeat the parameter).","default":[],"title":"Marketplace"},"description":"Only deals whose cheapest listing is on one of these marketplaces (repeat the parameter)."},{"name":"min_price","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"description":"Minimum buy price in cents.","title":"Min Price"},"description":"Minimum buy price in cents."},{"name":"max_price","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"description":"Maximum buy price in cents.","title":"Max Price"},"description":"Maximum buy price in cents."},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":100},{"type":"null"}],"description":"Case-insensitive substring of the skin name (or Steam market name).","title":"Search"},"description":"Case-insensitive substring of the skin name (or Steam market name)."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number.","default":1,"title":"Page"},"description":"1-based page number."},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page (max 200).","default":50,"title":"Per Page"},"description":"Results per page (max 200)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":50,"total":4254,"pages":86,"results":[{"itemdefid":32507,"name":"Metal Lord Crossbow","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/32507_small.png?4134877346","…":"12 more keys"},{"itemdefid":10031,"name":"Cloth","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/10031_small.png?1987935665","…":"12 more keys"},{"itemdefid":10068,"name":"Forest Camo Balaclava","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/10068_small.png?3640106314","…":"12 more keys"},"… 47 more"],"steam_ref":"buy"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/market/cap":{"get":{"tags":["market"],"summary":"Market cap of the Rust skin market","description":"The rust.wiki Market Cap page as data: `total_value` (cents), `skin_count`, `unit_count`, `by_category`\n(`{category, value}`) and `top`, every skin ranked by value with `{itemdefid, name, icon_url, price, amount,\nvalue}`. Supply is not something Steam exposes, so `amount` is the skin's Steam Workshop subscriber count -\na stated approximation (subscribing is not owning) - and `value` is price x amount. Only marketable skins with\na live Steam price and a linked Workshop submission are included. Cached for 15 minutes.","operationId":"market_cap_market_cap_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"skin_count":5343,"unit_count":58325075,"total_value":15635120354,"by_category":[{"category":"clothing","value":7068897948},{"category":"deployable","value":4722663129},{"category":"weapon","value":3653697670},"… 2 more"],"top":[{"itemdefid":44201,"name":"Forest Raiders Roadsign Pants","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/44201_small.png?685985818","price":9193,"amount":27400,"value":251888200},{"itemdefid":42007,"name":"Whiteout Hoodie","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/42007_small.png?864959197","price":1976,"amount":75680,"value":149543680},{"itemdefid":42305,"name":"Whiteout Facemask","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/42305_small.png?4013001147","price":2050,"amount":71971,"value":147540550},"… 5340 more"]}}}}}}},"/market/insights":{"get":{"tags":["market"],"summary":"Stonking, crashing and most-anticipated skins","description":"The rust.wiki Insights page: `stonking` - the 10 skins trading closest to (or above) their all-time high,\n`crashing` - the 10 closest to their all-time low (each `{itemdefid, name, icon_url, price, reference_price}`,\ncents; the reference is that skin's own all-time high or low from Steam's multi-year history, skins with under\n30 history points excluded), and `anticipated` - the 50 marketable skins with the most Steam Workshop\nsubscribers (`{itemdefid, name, icon_url, subscriptions}`). Refreshed with each price-history run, about every\n6 hours.","operationId":"insights_market_insights_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"stonking":[{"itemdefid":30806,"name":"Regeneration Program","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/30806_small.png?2589253865","price":5975,"reference_price":1034},{"itemdefid":41203,"name":"Pharaoh's Bow","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/41203_small.png?1859011566","price":501,"reference_price":226},{"itemdefid":54500,"name":"No Mercy Revolver - E Class","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/54500_small.png?3706509287","price":128116,"reference_price":75045},"… 7 more"],"crashing":[{"itemdefid":48200,"name":"Graffiti Metal Storage","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/48200_small.png?1681191300","price":69,"reference_price":101},{"itemdefid":60502,"name":"Bombshell SAR","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/60502_small.png?3162369524","price":110,"reference_price":107},{"itemdefid":29303,"name":"Tempered Python","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/29303_small.png?4110162725","price":217,"reference_price":208},"… 7 more"],"anticipated":[{"itemdefid":41401,"name":"Tempered Thompson","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/41401_small.png?2193805946","subscriptions":82512},{"itemdefid":42007,"name":"Whiteout Hoodie","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/42007_small.png?864959197","subscriptions":75680},{"itemdefid":42006,"name":"Whiteout Pants","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/42006_small.png?1423357804","subscriptions":74407},"… 47 more"]}}}}}}},"/charts/price/{itemdefid}.png":{"get":{"tags":["charts"],"summary":"Price history chart for one skin (line or candlestick)","description":"Renders the skin's Steam sale-price history over the window as a PNG: a filled line of daily prices, or\nweekly candlesticks with `style=candle`. The axis is in the requested currency. 404 when the skin is unknown\nor has fewer than two history points in the window.","operationId":"price_chart_charts_price__itemdefid__png_get","parameters":[{"name":"itemdefid","in":"path","required":true,"schema":{"type":"integer","description":"Steam itemdefid of the skin.","examples":[10138],"title":"Itemdefid"},"description":"Steam itemdefid of the skin."},{"name":"range","in":"query","required":false,"schema":{"type":"string","description":"Window: 1d, 1w, 1m, 3m, 6m, 1y, 2y, 5y or all.","examples":["3m"],"default":"3m","title":"Range"},"description":"Window: 1d, 1w, 1m, 3m, 6m, 1y, 2y, 5y or all."},{"name":"style","in":"query","required":false,"schema":{"type":"string","description":"`line` (daily closes) or `candle` (weekly OHLC candlesticks).","examples":["line"],"default":"line","title":"Style"},"description":"`line` (daily closes) or `candle` (weekly OHLC candlesticks)."},{"name":"currency","in":"query","required":false,"schema":{"type":"string","description":"ISO currency code for the y-axis (converted with the site's live rates); USD by default.","examples":["USD"],"default":"USD","title":"Currency"},"description":"ISO currency code for the y-axis (converted with the site's live rates); USD by default."}],"responses":{"200":{"description":"image/png image (about 42 KB)","content":{"image/png":{}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/charts/index.png":{"get":{"tags":["charts"],"summary":"Market index chart","description":"The same index the /skins/index page and GET /market/index compute (baseline 100 at the start of the\nwindow, equal- or market-cap-weighted), drawn as a single filled line. Pair it with GET /market/index for\nthe numbers and constituent count.","operationId":"index_chart_charts_index_png_get","parameters":[{"name":"basket_type","in":"query","required":false,"schema":{"type":"string","description":"all, high_value, low_value, category, collection, item or custom (comma-separated itemdefids in basket_value).","examples":["all"],"default":"all","title":"Basket Type"},"description":"all, high_value, low_value, category, collection, item or custom (comma-separated itemdefids in basket_value)."},{"name":"basket_value","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The category / collection name / item shortname / itemdefid list for that basket type.","examples":["weapon"],"title":"Basket Value"},"description":"The category / collection name / item shortname / itemdefid list for that basket type."},{"name":"range","in":"query","required":false,"schema":{"type":"string","description":"Window: 7d, 30d, 90d, 1y, 2y, 3y, 4y, 5y or all.","examples":["90d"],"default":"90d","title":"Range"},"description":"Window: 7d, 30d, 90d, 1y, 2y, 3y, 4y, 5y or all."},{"name":"weight_mode","in":"query","required":false,"schema":{"type":"string","description":"`equal` or `marketcap` weighting of constituents.","examples":["equal"],"default":"equal","title":"Weight Mode"},"description":"`equal` or `marketcap` weighting of constituents."}],"responses":{"200":{"description":"image/png image (about 32 KB)","content":{"image/png":{}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/charts/collection.png":{"get":{"tags":["charts"],"summary":"Collection value chart","description":"Equal-weighted index of every skin in the collection over the window, the chart the bot's /collection\ncommand posts. 404 for an unknown collection or too little history.","operationId":"collection_chart_charts_collection_png_get","parameters":[{"name":"collection","in":"query","required":true,"schema":{"type":"string","description":"Collection name exactly as GET /skins/collections lists it.","examples":["Forest Raiders"],"title":"Collection"},"description":"Collection name exactly as GET /skins/collections lists it."},{"name":"range","in":"query","required":false,"schema":{"type":"string","description":"Window: 7d, 30d, 90d, 1y, 2y, 3y, 4y, 5y or all.","examples":["90d"],"default":"90d","title":"Range"},"description":"Window: 7d, 30d, 90d, 1y, 2y, 3y, 4y, 5y or all."}],"responses":{"200":{"description":"image/png image (about 42 KB)","content":{"image/png":{}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/charts/compare.png":{"get":{"tags":["charts"],"summary":"Compare up to four skins, baskets or indexes on one chart","description":"Overlays the entries' daily price series (baskets as their average, indexes as index points) exactly as\nthe /skins/compare page does, rendered with a legend. `indexed` is the only mode where a $0.30 and a $300\nskin read on one axis.","operationId":"compare_chart_charts_compare_png_get","parameters":[{"name":"entries","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated entries, the same tokens GET /market/compare accepts: an itemdefid, `category:<name>`, `collection:<name>`, `item:<shortname>` or `index:all`. First four are drawn.","examples":["10138,42007"],"title":"Entries"},"description":"Comma-separated entries, the same tokens GET /market/compare accepts: an itemdefid, `category:<name>`, `collection:<name>`, `item:<shortname>` or `index:all`. First four are drawn."},{"name":"range","in":"query","required":false,"schema":{"type":"string","description":"Window: 7d, 30d, 90d, 1y, 2y, 3y, 4y, 5y or all.","examples":["90d"],"default":"90d","title":"Range"},"description":"Window: 7d, 30d, 90d, 1y, 2y, 3y, 4y, 5y or all."},{"name":"mode","in":"query","required":false,"schema":{"type":"string","description":"`indexed` rebases every line to 100 at its first point (comparable); `price` draws raw USD prices.","examples":["indexed"],"default":"indexed","title":"Mode"},"description":"`indexed` rebases every line to 100 at its first point (comparable); `price` draws raw USD prices."}],"responses":{"200":{"description":"image/png image (about 58 KB)","content":{"image/png":{}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/store":{"get":{"tags":["store"],"summary":"The current Rust item store","description":"What is purchasable in Rust's item store right now, in the three sections the wiki shows: `limited_time`\n(this week's rotation, most Workshop subscribers first), `general` (the permanent catalogue) and `dlc_packs`\n(bundles, by name). Each item carries `itemdefid`, `name`, `icon_url`, `category`, `store_price` (cents),\n`market_price` (its Steam Community Market price in cents, null when unlisted), `rarity`, `item_collection`,\n`creator_name`/`creator_avatar_url`, `subscriptions`, `est_supply` with `est_supply_source` (`workshop`\nsubscribers for brand-new items, the market estimate otherwise), `base_item_name` and the usual flags. Also\n`recent_rotations` (the last six, newest first, `is_current` marks the open one), `active_rotation_id` and\n`next_rotation_at` (the open rotation's start + 7 days; rotations land on Thursdays). Steam's own purchase URL\nfor any item is `https://store.steampowered.com/buyitem/252490/{itemdefid}/{quantity}`. Cached 30 minutes.","operationId":"current_store_store_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"limited_time":[{"itemdefid":70910,"name":"No Mercy Wood Gloves","icon_url":"https://community.akamai.steamstatic.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Re7WPFfCk4nReh8DEiv5dYPqE_qrU-Sf9hl…","…":"20 more keys"},{"itemdefid":70901,"name":"Molten Visage Triangle Hatch","icon_url":"https://community.akamai.steamstatic.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Re7WLEfCk4nReh8DEiv5dbP6A8r70wSPu3M…","…":"20 more keys"},{"itemdefid":70903,"name":"Antique Salvaged Icepick","icon_url":"https://community.akamai.steamstatic.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Re7WLGfCk4nReh8DEiv5daMag7qbwyQv65i…","…":"20 more keys"},"… 9 more"],"general":[{"itemdefid":10220,"name":"Adobe Building Skin","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/10220_small.png?1330644722","…":"20 more keys"},{"itemdefid":10492,"name":"Bowless Crossbow","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/10492_small.png?103559818","…":"20 more keys"},{"itemdefid":10223,"name":"Brick Building Skin","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/10223_small.png?2770892197","…":"20 more keys"},"… 19 more"],"dlc_packs":[{"itemdefid":10222,"name":"Abyss Pack","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/10222_small.png?2950078003","…":"20 more keys"},{"itemdefid":10304,"name":"Adobe Gate and Wall Pack","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/10304_small.png?554334055","…":"20 more keys"},{"itemdefid":10207,"name":"Arctic Pack","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/10207_small.png?4009280131","…":"20 more keys"},"… 18 more"],"recent_rotations":[{"id":"2026-10-01-1807","name":null,"start":"2026-10-01T18:07:55.360751","is_current":true},{"id":"2026-10-01-1638","name":null,"start":"2026-10-01T16:38:00.255252","is_current":false},{"id":"2026-09-24-2214","name":null,"start":"2026-09-24T22:14:08.112206","is_current":false},"… 3 more"],"next_rotation_at":"2026-10-08T18:07:55.360751","active_rotation_id":"2026-10-01-1807"}}}}}}},"/store/history":{"get":{"tags":["store"],"summary":"Past item-store rotations","description":"Every weekly rotation, newest first (the open one included): `id` (the rotation slug, `YYYY-MM-DD-HHMM`, or\n`General` for the permanent catalogue), `name` (Facepunch's label when it had one, usually null), `start`,\n`end` (null while current), `itemdefid_count` and `icons` - every skin in it as `{url, name}`, DLC packs\nexcluded. With `search`, only the rotations that sold a matching skin are returned (same shape, newest first),\nwhich answers \"when was X in the store?\". Full item lists via GET /store/rotations/{rotation_id}. Cached for an\nhour; searches are computed live.","operationId":"history_store_history_get","parameters":[{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":100},{"type":"null"}],"description":"Only rotations that contained a skin whose name matches this (case-insensitive substring), e.g. `Tempered`.","title":"Search"},"description":"Only rotations that contained a skin whose name matches this (case-insensitive substring), e.g. `Tempered`."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number.","default":1,"title":"Page"},"description":"1-based page number."},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page (max 200).","default":50,"title":"Per Page"},"description":"Results per page (max 200)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":50,"total":521,"pages":11,"results":[{"id":"2026-10-01-1807","name":null,"start":"2026-10-01T18:07:55.360751","end":null,"itemdefid_count":12,"icons":[{"url":"https://community.akamai.steamstatic.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Re7WLBfCk4nReh8DEiv5dYMK07pbY0SfC20…","name":"Antique Salvaged Axe"},{"url":"https://community.akamai.steamstatic.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Re7WLGfCk4nReh8DEiv5daMag7qbwyQv65i…","name":"Antique Salvaged Icepick"},{"url":"https://community.akamai.steamstatic.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Re7WPEfCk4nReh8DEiv5ddO683r7IwRv--X…","name":"Apotheosis of War Small Box"},"… 9 more"]},{"id":"2026-10-01-1638","name":null,"start":"2026-10-01T16:38:00.255252","end":"2026-10-01T18:07:55.360751","itemdefid_count":13,"icons":[{"url":"https://community.akamai.steamstatic.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Re7WPHfCk4nReh8DEiv5daP686qbw_RPm4a…","name":"*S* Door"},{"url":"https://community.akamai.steamstatic.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Re7WLBfCk4nReh8DEiv5dYMK07pbY0SfC20…","name":"Antique Salvaged Axe"},{"url":"https://community.akamai.steamstatic.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Re7WLGfCk4nReh8DEiv5daMag7qbwyQv65i…","name":"Antique Salvaged Icepick"},"… 10 more"]},{"id":"2026-09-24-2214","name":null,"start":"2026-09-24T22:14:08.112206","end":"2026-10-01T16:38:00.255252","itemdefid_count":20,"icons":[{"url":"https://community.akamai.steamstatic.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Re7GLEfCk4nReh8DEiv5deOaw9qrQ0R_BR5…","name":"Boots from Hell"},{"url":"https://community.akamai.steamstatic.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Re7GLAfCk4nReh8DEiv5daP6k4q702R_y75…","name":"Cobalt Jungle Container Armored Door"},{"url":"https://community.akamai.steamstatic.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Re7GPHfCk4nReh8DEiv5dQO6s8rL0_RvjUk…","name":"Doodle SAP"},"… 17 more"]},"… 47 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/store/rotations/{rotation_id}":{"get":{"tags":["store"],"summary":"One rotation's full item list","description":"One rotation as the wiki's /store/rotation page shows it: `rotation` (`id`, `name`, `start`, `end`,\n`itemdefid_count` - the number of items that still resolve in the catalogue) and its items split into\n`limited_time`, `general` and `dlc_packs`, each item in the same shape as GET /store, including today's\n`market_price` and `is_available_on_store` (a past rotation can still contain evergreen catalogue items).\nCached for an hour.","operationId":"rotation_store_rotations__rotation_id__get","parameters":[{"name":"rotation_id","in":"path","required":true,"schema":{"type":"string","maxLength":40,"description":"Rotation id from /store/history, e.g. `2017-07-13-2006`, or `General`.","examples":["2017-07-13-2006"],"title":"Rotation Id"},"description":"Rotation id from /store/history, e.g. `2017-07-13-2006`, or `General`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"rotation":{"id":"2017-07-13-2006","name":"","start":"2017-07-13T20:06:07","end":"2017-07-20T18:23:11","itemdefid_count":19},"limited_time":[],"general":[{"itemdefid":23201,"name":"Apocalypse Kilt","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/23201_small.png?2982679604","…":"20 more keys"},{"itemdefid":23200,"name":"Apocalypse Vest","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/23200_small.png?4215416301","…":"20 more keys"},{"itemdefid":23218,"name":"Forest Guardian Revolver","icon_url":"https://files.facepunch.com/rust/icons/inventory/rust/23218_small.png?3987841886","…":"20 more keys"},"… 16 more"],"dlc_packs":[]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/workshop":{"get":{"tags":["workshop"],"summary":"Browse or search Workshop submissions","description":"One page of submissions. Each carries `workshopid` (the Steam published-file id), `title`,\n`author_steamid64`, `preview_image_url`, `submitted_at` (UTC ISO-8601, may be null), `accepted` and\n`accepted_itemdefid` (the in-game item definition id when Facepunch accepted it - use it with\n`/skins/{itemdefid}`), `target_item_tag`, `subscriptions` and `vote_score` (Steam's 0-1 score; both null\nwhen Steam has not reported them). Same filters, ordering and cache as the /workshop page.","operationId":"list_submissions_workshop_get","parameters":[{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":120},{"type":"null"}],"description":"Case-insensitive substring match on the submission title.","examples":["dragon"],"title":"Search"},"description":"Case-insensitive substring match on the submission title."},{"name":"target","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}],"description":"Only submissions for this target item, exactly as the Workshop tags it (e.g. `AK47`, `Garage Door`); `/workshop/targets` lists every value.","examples":["AK47"],"title":"Target"},"description":"Only submissions for this target item, exactly as the Workshop tags it (e.g. `AK47`, `Garage Door`); `/workshop/targets` lists every value."},{"name":"sort","in":"query","required":false,"schema":{"enum":["newest","popular"],"type":"string","description":"`newest` = most recently submitted first; `popular` = most subscribers first.","default":"newest","title":"Sort"},"description":"`newest` = most recently submitted first; `popular` = most subscribers first."},{"name":"accepted","in":"query","required":false,"schema":{"enum":["any","yes","no"],"type":"string","description":"`yes` = only submissions Facepunch accepted into the game; `no` = only ones it has not.","default":"any","title":"Accepted"},"description":"`yes` = only submissions Facepunch accepted into the game; `no` = only ones it has not."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number.","default":1,"title":"Page"},"description":"1-based page number."},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page (max 200).","default":50,"title":"Per Page"},"description":"Results per page (max 200)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":50,"total":83,"pages":2,"results":[{"workshopid":3772647985,"title":"Young Dragon | AR (V2) (Cut Sights)","author_steamid64":"76561198262840821","preview_image_url":"https://images.steamusercontent.com/ugc/14315349540881935116/0D85A1FFB86C08D48BB17374EFD9CFE069C451E8/","submitted_at":"2026-07-27T10:10:10","accepted":true,"accepted_itemdefid":70108,"target_item_tag":"AK47","subscriptions":19135,"vote_score":0.6380090713500977},{"workshopid":3772631404,"title":"Young Dragon | AR (V2)","author_steamid64":"76561198262840821","preview_image_url":"https://images.steamusercontent.com/ugc/15445615739190898617/048B90C1A427AF522BB59AF7A1577F390EF49E03/","submitted_at":"2026-07-27T09:19:37","accepted":false,"accepted_itemdefid":null,"target_item_tag":"AK47","subscriptions":0,"vote_score":0.6000000238418579},{"workshopid":3749721305,"title":"Young Dragon | AR (NoStock)","author_steamid64":"76561198262840821","preview_image_url":"https://images.steamusercontent.com/ugc/15922966841576236374/9AEE07E4DDAEF06D4EE138E4310201770551FA8C/","submitted_at":"2026-06-22T12:36:57","accepted":false,"accepted_itemdefid":null,"target_item_tag":"AK47","subscriptions":0,"vote_score":0.6319290399551392},"… 47 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/workshop/targets":{"get":{"tags":["workshop"],"summary":"Every target-item tag in use","description":"The distinct `target_item_tag` values (alphabetical) - Steam's own Workshop tag text for the item a skin\nis made for, e.g. `AK47`, `Garage Door`. Pass one as the `target` filter of `/workshop`. The set only grows\nwhen Facepunch makes a new item skinnable; cached for 15 minutes.","operationId":"list_targets_workshop_targets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"total":154,"results":["Acoustic Guitar","AK47","AK47 Skin","… 151 more"]}}}}}}},"/commands":{"get":{"tags":["reference"],"summary":"Console and server commands","description":"One page of Rust console/server commands, alphabetical. Each carries `command`, `syntax`, `description`,\n`category` (Rust's own ConVar namespace, e.g. `server`, `gather`), `command_type` (`command` or `variable`),\n`default_value` (variables only) and `permission_required` (null when any player can run it). Cached for\n30 minutes.","operationId":"list_commands_commands_get","parameters":[{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}],"description":"Case-insensitive substring match on the command name, its description OR its category (so `workbench` finds every workbench ConVar).","examples":["gather"],"title":"Search"},"description":"Case-insensitive substring match on the command name, its description OR its category (so `workbench` finds every workbench ConVar)."},{"name":"admin_only","in":"query","required":false,"schema":{"type":"boolean","description":"`true` = only commands that need admin/moderator permission.","default":false,"title":"Admin Only"},"description":"`true` = only commands that need admin/moderator permission."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number.","default":1,"title":"Page"},"description":"1-based page number."},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page (max 200).","default":50,"title":"Per Page"},"description":"Results per page (max 200)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":50,"total":4,"pages":1,"results":[{"command":"ai.npc_cover_info_tick_rate_multiplier","syntax":null,"description":"The rate at which we gather information about available cover points. Minimum value is 1, as it multiplies with the tick-rate of the fixed AI tick rate of 0.1 (…","category":"ai","command_type":"variable","default_value":"20","permission_required":"Admin"},{"command":"gamemodesoftcore.gather_rate","syntax":null,"description":"(Generated) Global multiplier for resources gathered in Softcore mode from ores, trees, logs, wild plants and animals; 1.0 = default, 2.0 = double yield","category":"gamemodesoftcore","command_type":"variable","default_value":"2","permission_required":"Admin"},{"command":"server.occlusiongatherbatchplayercount","syntax":null,"description":"UsePlayerUpdateJobs 4 related - how many players to gather occlusion pairs for per task","category":"server","command_type":"variable","default_value":"64","permission_required":"Admin"},"… 1 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/commands/give-items":{"get":{"tags":["reference"],"summary":"Item shortnames for the give command","description":"Live items as a copy-paste reference for `give <shortname> <amount>` and `inventory.giveto <player>\n<shortname> <amount>`: `shortname` is the exact string those commands expect, plus `display_name`,\n`category`, `icon_url` and `stack_size` (the maximum one stack holds). Alphabetical by display name;\ncached for 30 minutes.","operationId":"list_give_items_commands_give_items_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"enum":["weapon","construction","general","resource","attire","tool","medical","food","ammo","trap","component","electrical","fun","misc"],"type":"string"},{"type":"null"}],"description":"Restrict to one item category.","examples":["weapon"],"title":"Category"},"description":"Restrict to one item category."},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}],"description":"Case-insensitive substring match on the display name or shortname.","examples":["rifle"],"title":"Search"},"description":"Case-insensitive substring match on the display name or shortname."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number.","default":1,"title":"Page"},"description":"1-based page number."},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page (max 200).","default":50,"title":"Per Page"},"description":"Results per page (max 200)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":50,"total":13,"pages":1,"results":[{"shortname":"rifle.ak","display_name":"Assault Rifle","category":"weapon","icon_url":"https://files.facepunch.com/rust/item/rifle.ak_512.png","stack_size":1},{"shortname":"rifle.bolt","display_name":"Bolt Action Rifle","category":"weapon","icon_url":"https://files.facepunch.com/rust/item/rifle.bolt_512.png","stack_size":1},{"shortname":"rifle.ak.glass","display_name":"Crystal AR Diamond","category":"weapon","icon_url":"https://rust.wiki/static/assets/rusthelp/items/rifle.ak.glass.png","stack_size":1},"… 10 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/monuments":{"get":{"tags":["reference"],"summary":"All 60 fixed monuments","description":"Every fixed-location monument, alphabetical, in one response (no pagination - the set is 60 and static).\nEach carries `slug`, `name`, `tier` (1-3, null for safe zones and minor monuments), `is_safezone`,\n`has_radiation` and `radiation_level`, `recyclers` (count on site), `has_tunnel_entrance` (underground rail),\n`has_chinook_drop_zone`, `allows_patrol_heli_crash`, `no_build_area_sqm` and `icon_url`. Moving monuments\n(Cargo Ship) are not included. Cached for one hour.","operationId":"list_monuments_monuments_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"total":60,"results":[{"slug":"abandoned-cabins","name":"Abandoned Cabins","tier":"1","is_safezone":false,"has_tunnel_entrance":false,"has_chinook_drop_zone":false,"allows_patrol_heli_crash":true,"no_build_area_sqm":1256,"recyclers":"None","has_radiation":false,"radiation_level":null,"icon_url":"https://rust.wiki/static/assets/rusthelp/monuments/abandoned-cabins.png"},{"slug":"abandoned-military-base","name":"Abandoned Military Base","tier":"1/2/3","is_safezone":false,"has_tunnel_entrance":false,"has_chinook_drop_zone":false,"allows_patrol_heli_crash":false,"no_build_area_sqm":70685,"recyclers":"None","has_radiation":false,"radiation_level":null,"icon_url":"https://rust.wiki/static/assets/rusthelp/monuments/abandoned-military-base.png"},{"slug":"abandoned-supermarket","name":"Abandoned Supermarket","tier":"1/2/3","is_safezone":false,"has_tunnel_entrance":false,"has_chinook_drop_zone":false,"allows_patrol_heli_crash":true,"no_build_area_sqm":45238,"recyclers":"1","has_radiation":false,"radiation_level":null,"icon_url":"https://rust.wiki/static/assets/rusthelp/monuments/abandoned-supermarket.png"},"… 57 more"]}}}}}}},"/monuments/{slug}":{"get":{"tags":["reference"],"summary":"One monument with its loot sources","description":"The same fields as `/monuments` for one monument plus `loot_sources`: every crate/NPC loot table that\nspawns at it (`id`, `name`, `drop_count`), alphabetical - fetch each with `/loot-tables/{id}`. Cached for\none hour.","operationId":"monument_detail_monuments__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":80,"description":"Monument slug from `/monuments`, e.g. `airfield`.","examples":["airfield"],"title":"Slug"},"description":"Monument slug from `/monuments`, e.g. `airfield`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"slug":"airfield","name":"Airfield","tier":"2","is_safezone":false,"has_tunnel_entrance":true,"has_chinook_drop_zone":true,"allows_patrol_heli_crash":true,"no_build_area_sqm":49152,"recyclers":"2","has_radiation":true,"radiation_level":"11","icon_url":"https://rust.wiki/static/assets/rusthelp/monuments/airfield.png","…":"1 more keys"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/loot-tables":{"get":{"tags":["reference"],"summary":"Every loot source (crates, NPCs, barrels)","description":"One page of loot sources, alphabetical. Each carries `id`, `name` (Facepunch's own loot-table name, e.g.\n`Elite Tier Crate`), `drop_count` (how many distinct items it can drop) and `icons` (the icons of its four\nlikeliest drops). Fetch the full drop table with `/loot-tables/{id}`. Cached for 30 minutes.","operationId":"list_loot_tables_loot_tables_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number.","default":1,"title":"Page"},"description":"1-based page number."},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page (max 200).","default":50,"title":"Per Page"},"description":"Results per page (max 200)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":50,"total":158,"pages":4,"results":[{"id":87,"name":"Abandoned Military Base Scientist","drop_count":211,"icons":["https://files.facepunch.com/rust/item/ammo.pistol_512.png","https://files.facepunch.com/rust/item/ammo.rifle_512.png","https://files.facepunch.com/rust/item/syringe.medical_512.png","… 1 more"]},{"id":76,"name":"airdrop","drop_count":16,"icons":["https://files.facepunch.com/rust/item/explosive.satchel_512.png","https://files.facepunch.com/rust/item/explosive.timed_512.png","https://files.facepunch.com/rust/item/chainsaw_512.png","… 1 more"]},{"id":88,"name":"Airfield Scientist","drop_count":211,"icons":["https://files.facepunch.com/rust/item/ammo.pistol_512.png","https://files.facepunch.com/rust/item/ammo.rifle_512.png","https://files.facepunch.com/rust/item/syringe.medical_512.png","… 1 more"]},"… 47 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/loot-tables/{source_id}":{"get":{"tags":["reference"],"summary":"One loot table with every drop","description":"The loot source's `id` and `name` plus `drops`, highest chance first: for each item `shortname`,\n`display_name`, `icon_url`, `chance_pct` (0-100), `amount_min`/`amount_max` and, for items that spawn\ndamaged, `condition_min_pct`/`condition_max_pct`. Scraped from wiki.facepunch.com; cached for 30 minutes.","operationId":"loot_table_detail_loot_tables__source_id__get","parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"Loot source id from `/loot-tables`, `/monuments/{slug}` or an item's `loot_sources`.","examples":[1],"title":"Source Id"},"description":"Loot source id from `/loot-tables`, `/monuments/{slug}` or an item's `loot_sources`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"id":1,"name":"Medical Crate","drop_count":3,"drops":[{"shortname":"bandage","display_name":"Bandage","icon_url":"https://files.facepunch.com/rust/item/bandage_512.png","chance_pct":50.0,"amount_min":1,"amount_max":1,"condition_min_pct":null,"condition_max_pct":null},{"shortname":"largemedkit","display_name":"Large Medkit","icon_url":"https://files.facepunch.com/rust/item/largemedkit_512.png","chance_pct":25.0,"amount_min":1,"amount_max":1,"condition_min_pct":null,"condition_max_pct":null},{"shortname":"syringe.medical","display_name":"Medical Syringe","icon_url":"https://files.facepunch.com/rust/item/syringe.medical_512.png","chance_pct":25.0,"amount_min":1,"amount_max":1,"condition_min_pct":null,"condition_max_pct":null}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/cctv-codes":{"get":{"tags":["reference"],"summary":"CCTV camera codes by monument","description":"The 12 monuments with working CCTV cameras and their Computer Station identifiers (60 codes). `codes`\nare the literal in-game console codes; when `randomized` is true the trailing `****` is a per-wipe random\n4-digit suffix posted near the camera in-game, not a fixed code. `slug` links to `/monuments/{slug}` (null for\nCargo Ship, which is a moving monument). Fixed reference data.","operationId":"cctv_codes_cctv_codes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"total":12,"code_count":60,"results":[{"name":"Airfield","codes":["AIRFIELDHELIPAD"],"randomized":false,"slug":"airfield"},{"name":"Bandit Camp","codes":["CASINO","TOWNWEAPONS"],"randomized":false,"slug":"bandit-camp"},{"name":"Cargo Ship","codes":["CARGODECK","CARGOBRIDGE","CARGOSTERN","… 2 more"],"randomized":false,"slug":null},"… 9 more"]}}}}}}},"/world":{"get":{"tags":["reference"],"summary":"World entities: animals, NPCs, resource nodes","description":"One page of world entities (anything not tied to one monument), alphabetical. Each carries `slug`,\n`display_name`, `is_npc`, `npc_hp` (null for resources) and `icon_url`. Cached for one hour.","operationId":"list_world_world_get","parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"enum":["npc","resource"],"type":"string"},{"type":"null"}],"description":"`npc` = anything with hit points (animals, scientists, bosses, vehicles); `resource` = nodes, trees, barrels and other harvestables.","examples":["npc"],"title":"Kind"},"description":"`npc` = anything with hit points (animals, scientists, bosses, vehicles); `resource` = nodes, trees, barrels and other harvestables."},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}],"description":"Case-insensitive substring match on the display name.","examples":["scientist"],"title":"Search"},"description":"Case-insensitive substring match on the display name."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number.","default":1,"title":"Page"},"description":"1-based page number."},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page (max 200).","default":50,"title":"Per Page"},"description":"Results per page (max 200)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":50,"total":25,"pages":1,"results":[{"slug":"abandoned-military-base-scientist","display_name":"Abandoned Military Base Scientist","is_npc":true,"npc_hp":150.0,"icon_url":"https://rust.wiki/static/assets/rusthelp/world/abandoned-military-base-scientist.png"},{"slug":"airfield-scientist","display_name":"Airfield Scientist","is_npc":true,"npc_hp":150.0,"icon_url":"https://rust.wiki/static/assets/rusthelp/world/airfield-scientist.png"},{"slug":"arctic-research-base-scientist","display_name":"Arctic Research Base Scientist","is_npc":true,"npc_hp":150.0,"icon_url":"https://rust.wiki/static/assets/rusthelp/world/arctic-research-base-scientist.png"},"… 22 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/world/{slug}":{"get":{"tags":["reference"],"summary":"One world entity with its loot","description":"The entity's `slug`, `display_name`, `is_npc`, `npc_hp`, `icon_url` and `loot_source_id` (null when it\ndrops nothing), plus `drops` - its five likeliest drops (`shortname`, `display_name`, `icon_url`,\n`chance_pct`, `amount_min`, `amount_max`) - and `drop_count`, the full number of distinct drops. The complete\ntable is `/loot-tables/{loot_source_id}`. Cached for one hour.","operationId":"world_detail_world__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":80,"description":"Entity slug from `/world`, e.g. `bear`.","examples":["bear"],"title":"Slug"},"description":"Entity slug from `/world`, e.g. `bear`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"slug":"bear","display_name":"Bear","is_npc":false,"npc_hp":null,"loot_source_id":94,"icon_url":"https://rust.wiki/static/assets/rusthelp/world/bear.png","drops":[],"drop_count":0}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/building":{"get":{"tags":["reference"],"summary":"Building pieces by grade","description":"One page of building pieces (every grade of every block: foundations, walls, floors, doorways, stairs,\nroofs, ...), alphabetical. Each carries `slug`, `display_name`, `grade` (Twig, Wood, Stone, Metal, Armored\nor Boat), `health` and `decay_hours` (how long an unmaintained piece takes to decay fully). Cached for one\nhour.","operationId":"list_building_building_get","parameters":[{"name":"grade","in":"query","required":false,"schema":{"anyOf":[{"enum":["Twig","Wood","Stone","Metal","Armored","Boat"],"type":"string"},{"type":"null"}],"description":"Restrict to one building grade.","examples":["Stone"],"title":"Grade"},"description":"Restrict to one building grade."},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}],"description":"Case-insensitive substring match on the display name.","examples":["wall"],"title":"Search"},"description":"Case-insensitive substring match on the display name."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number.","default":1,"title":"Page"},"description":"1-based page number."},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page (max 200).","default":50,"title":"Per Page"},"description":"Results per page (max 200)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":50,"total":6,"pages":1,"results":[{"slug":"stone-wall","display_name":"Stone Wall","grade":"Stone","health":500.0,"decay_hours":5.0},{"slug":"stone-wall-doorway","display_name":"Stone Wall Doorway","grade":"Stone","health":500.0,"decay_hours":5.0},{"slug":"stone-wall-frame","display_name":"Stone Wall Frame","grade":"Stone","health":500.0,"decay_hours":5.0},"… 3 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/building/{slug}":{"get":{"tags":["reference"],"summary":"One building piece: costs, durability, siblings","description":"The piece's `slug`, `display_name`, `grade`, `health` and `decay_hours`, plus `costs` (`build`, `repair`\nand `upkeep` lists of `item_name`, `amount` or `min_amount`/`max_amount`, with `shortname`/`icon_url` when\nthe material maps to a catalogue item), `durability` (up to ten entries each for `explosive`, `melee` and\n`bullet` damage: `item_name`, `seconds_taken` to destroy, `required_items` = how many of that weapon/explosive)\nand `siblings` - the same piece at every other grade, Twig to Armored. Cached for one hour.","operationId":"building_detail_building__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":80,"description":"Piece slug from `/building`, e.g. `stone-wall`.","examples":["stone-wall"],"title":"Slug"},"description":"Piece slug from `/building`, e.g. `stone-wall`."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"slug":"stone-wall","display_name":"Stone Wall","grade":"Stone","health":500.0,"decay_hours":5.0,"costs":{"build":[{"item_name":"Stones","amount":300.0,"min_amount":null,"max_amount":null,"shortname":"stones","icon_url":"https://files.facepunch.com/rust/item/stones_512.png"}],"repair":[{"item_name":"Stones","amount":300.0,"min_amount":null,"max_amount":null,"shortname":"stones","icon_url":"https://files.facepunch.com/rust/item/stones_512.png"},{"item_name":"Stones","amount":300.0,"min_amount":null,"max_amount":null,"shortname":"stones","icon_url":"https://files.facepunch.com/rust/item/stones_512.png"}],"upkeep":[{"item_name":"Stones","amount":null,"min_amount":30.0,"max_amount":99.0,"shortname":"stones","icon_url":"https://files.facepunch.com/rust/item/stones_512.png"}]},"durability":{"explosive":[{"item_name":"Timed Explosive Charge","seconds_taken":14.0,"required_items":2.0,"shortname":"explosive.timed","icon_url":"https://files.facepunch.com/rust/item/explosive.timed_512.png"},{"item_name":"Rocket","seconds_taken":18.0,"required_items":4.0,"shortname":"ammo.rocket.basic","icon_url":"https://files.facepunch.com/rust/item/ammo.rocket.basic_512.png"},{"item_name":"Satchel Charge","seconds_taken":34.0,"required_items":10.0,"shortname":"explosive.satchel","icon_url":"https://files.facepunch.com/rust/item/explosive.satchel_512.png"},"… 7 more"],"melee":[{"item_name":"Jackhammer","seconds_taken":101.0,"required_items":1.0,"shortname":"jackhammer","icon_url":"https://files.facepunch.com/rust/item/jackhammer_512.png"},{"item_name":"Combat Knife","seconds_taken":318.0,"required_items":32.0,"shortname":"knife.combat","icon_url":"https://rust.wiki/static/assets/rusthelp/items/knife.combat.png"},{"item_name":"Salvaged Icepick","seconds_taken":454.0,"required_items":7.0,"shortname":"icepick.salvaged","icon_url":"https://files.facepunch.com/rust/item/icepick.salvaged_512.png"},"… 7 more"],"bullet":[{"item_name":"Multiple Grenade Launcher","seconds_taken":17.0,"required_items":27.0,"shortname":"multiplegrenadelauncher","icon_url":"https://files.facepunch.com/rust/item/multiplegrenadelauncher_512.png"},{"item_name":"M249","seconds_taken":28.0,"required_items":159.0,"shortname":"lmg.m249","icon_url":"https://files.facepunch.com/rust/item/lmg.m249_512.png"},{"item_name":"HMLMG","seconds_taken":35.0,"required_items":163.0,"shortname":"hmlmg","icon_url":"https://files.facepunch.com/rust/item/hmlmg_512.png"},"… 7 more"]},"siblings":[{"slug":"twig-wall","grade":"Twig"},{"slug":"wood-wall","grade":"Wood"},{"slug":"stone-wall","grade":"Stone"},"… 3 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/tech-tree/{tree}":{"get":{"tags":["reference"],"summary":"One tech tree: nodes and prerequisite edges","description":"The full research graph for one workbench. `nodes` carry `id`, `shortname` and `name` of the unlockable\nitem, `icon_url`, `cost` (scrap to unlock that node) and `total_cost` (cumulative scrap along the cheapest\npath from the root), plus `x`/`y`: these are LAYOUT PIXELS from the site's own tree renderer (the top-left of\na 110x78 card, see `card_size`), not game data. `edges` are the prerequisite links, each with `from_id`/\n`to_id` (research `from` before `to`) and the card-centre pixel endpoints `x1`,`y1`,`x2`,`y2` the page draws.\nNode ids are only stable until the tree is re-seeded. Cached for one hour.","operationId":"tech_tree_tech_tree__tree__get","parameters":[{"name":"tree","in":"path","required":true,"schema":{"enum":["workbench1","workbench2","workbench3","engineering"],"type":"string","description":"Which research graph: Workbench Level 1/2/3 or the Engineering Workbench.","examples":["workbench1"],"title":"Tree"},"description":"Which research graph: Workbench Level 1/2/3 or the Engineering Workbench."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"tree":"workbench1","label":"Workbench Level 1","card_size":{"width":110,"height":78},"node_count":94,"edge_count":92,"nodes":[{"id":53,"shortname":"knife.combat","name":"Combat Knife","icon_url":"https://rust.wiki/static/assets/rusthelp/items/knife.combat.png","x":1984.0,"y":2048.0,"cost":30,"total_cost":375},{"id":52,"shortname":"shotgun.double","name":"Double Barrel Shotgun","icon_url":"https://rust.wiki/static/assets/rusthelp/items/shotgun.double.png","x":1600.0,"y":2048.0,"cost":60,"total_cost":405},{"id":29,"shortname":"hatchet","name":"Hatchet","icon_url":"https://rust.wiki/static/assets/rusthelp/items/hatchet.png","x":1408.0,"y":320.0,"cost":30,"total_cost":60},"… 91 more"],"edges":[{"from_id":18,"to_id":1,"x1":1655.0,"y1":167.0,"x2":503.0,"y2":359.0},{"from_id":84,"to_id":2,"x1":695.0,"y1":551.0,"x2":503.0,"y2":743.0},{"from_id":2,"to_id":3,"x1":503.0,"y1":743.0,"x2":503.0,"y2":935.0},"… 89 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/design-notes":{"get":{"tags":["reference"],"summary":"Design notes from The Art of Rust","description":"Curated trivia paraphrased from The Art of Rust (Facepunch Studios / Dark Horse Books, January 2026):\ndesign inspirations, cut content and in-universe lore. Each note carries `id`, `chapter`, `title`, `text`\n(an original paraphrase, never a quotation), `page` (the book page cited), `tags` (the wiki pages it\nbelongs to) and `cut_content`. Text only - the book's artwork is never reproduced. Fixed editorial data.","operationId":"design_notes_design_notes_get","parameters":[{"name":"chapter","in":"query","required":false,"schema":{"anyOf":[{"enum":["Characters","Bases & World","Weapons & Tech","Vehicles","Events & DLC"],"type":"string"},{"type":"null"}],"description":"Restrict to one chapter of the book.","examples":["Weapons & Tech"],"title":"Chapter"},"description":"Restrict to one chapter of the book."},{"name":"tag","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}],"description":"Only notes tagged for one wiki page: `item:<shortname>`, `monument:<slug>`, `building:<slug>` or `world:<slug>`.","examples":["item:rifle.ak"],"title":"Tag"},"description":"Only notes tagged for one wiki page: `item:<shortname>`, `monument:<slug>`, `building:<slug>` or `world:<slug>`."},{"name":"cut","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"`true` = only notes about cut/unshipped content; `false` = only notes about shipped content.","title":"Cut"},"description":"`true` = only notes about cut/unshipped content; `false` = only notes about shipped content."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"book":"The Art of Rust (Facepunch Studios / Dark Horse Books, January 2026)","chapters":["Characters","Bases & World","Weapons & Tech","… 2 more"],"total":1,"results":[{"id":"assault-rifle-ak47","chapter":"Weapons & Tech","title":"The Assault Rifle's AK-47 roots","text":"Rust's most iconic weapon started from a familiar shape: early Assault Rifle sketches took the classic AK-47 silhouette and reimagined it through scavenging, im…","page":119,"tags":["item:rifle.ak"],"cut_content":false}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/calculators/craft":{"get":{"tags":["reference"],"summary":"Craft calculator dataset: every recipe","description":"The dataset behind the craft calculator: `items` maps every item shortname to `name`, `icon_url`,\n`craftable` and `recipe` (direct components as `shortname` + `quantity`; empty for non-craftables). Resolve a\nrecipe recursively through the same map to get raw-material totals, exactly as the page's accumulator does.\nCached for 30 minutes.","operationId":"craft_dataset_calculators_craft_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"total":1101,"items":{"metal.facemask":{"name":"Metal Facemask","icon_url":"https://files.facepunch.com/rust/item/metal.facemask_512.png","craftable":false,"recipe":[]},"metal.plate.torso":{"name":"Metal Chest Plate","icon_url":"https://files.facepunch.com/rust/item/metal.plate.torso_512.png","craftable":false,"recipe":[]},"coffeecan.helmet":{"name":"Coffee Can Helmet","icon_url":"https://files.facepunch.com/rust/item/coffeecan.helmet_512.png","craftable":false,"recipe":[]},"…":"1098 more keys"}}}}}}}},"/calculators/recycle":{"get":{"tags":["reference"],"summary":"Recycle calculator dataset: every recycler yield","description":"The dataset behind the recycle calculator: `items` maps every recyclable item's shortname to `name`,\n`icon_url` and `yields`, split by `recycler` (the standard monument recycler) and `safe_zone` (the reduced-\nyield Outpost/Bandit Camp recycler). Each yield is `shortname`, `name`, `icon_url`, `quantity` and `chance`\n(0-1 probability of that output). Cached for 30 minutes.","operationId":"recycle_dataset_calculators_recycle_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"total":843,"items":{"ammo.shotgun":{"name":"12 Gauge Buckshot","icon_url":"https://files.facepunch.com/rust/item/ammo.shotgun_512.png","yields":{"recycler":[{"shortname":"metal.fragments","name":"Metal Fragments","icon_url":"https://files.facepunch.com/rust/item/metal.fragments_512.png","quantity":1,"chance":1.0},{"shortname":"metal.fragments","name":"Metal Fragments","icon_url":"https://files.facepunch.com/rust/item/metal.fragments_512.png","quantity":1,"chance":0.5},{"shortname":"gunpowder","name":"Gun Powder","icon_url":"https://files.facepunch.com/rust/item/gunpowder_512.png","quantity":3,"chance":1.0}],"safe_zone":[{"shortname":"gunpowder","name":"Gun Powder","icon_url":"https://files.facepunch.com/rust/item/gunpowder_512.png","quantity":2,"chance":1.0},{"shortname":"metal.fragments","name":"Metal Fragments","icon_url":"https://files.facepunch.com/rust/item/metal.fragments_512.png","quantity":1,"chance":1.0}]}},"ammo.shotgun.fire":{"name":"12 Gauge Incendiary Shell","icon_url":"https://files.facepunch.com/rust/item/ammo.shotgun.fire_512.png","yields":{"recycler":[{"shortname":"sulfur","name":"Sulfur","icon_url":"https://files.facepunch.com/rust/item/sulfur_512.png","quantity":6,"chance":1.0},{"shortname":"metal.fragments","name":"Metal Fragments","icon_url":"https://files.facepunch.com/rust/item/metal.fragments_512.png","quantity":1,"chance":0.5},{"shortname":"metal.fragments","name":"Metal Fragments","icon_url":"https://files.facepunch.com/rust/item/metal.fragments_512.png","quantity":1,"chance":1.0},"… 1 more"],"safe_zone":[{"shortname":"sulfur","name":"Sulfur","icon_url":"https://files.facepunch.com/rust/item/sulfur_512.png","quantity":4,"chance":1.0},{"shortname":"metal.fragments","name":"Metal Fragments","icon_url":"https://files.facepunch.com/rust/item/metal.fragments_512.png","quantity":1,"chance":1.0},{"shortname":"gunpowder","name":"Gun Powder","icon_url":"https://files.facepunch.com/rust/item/gunpowder_512.png","quantity":2,"chance":1.0}]}},"ammo.shotgun.slug":{"name":"12 Gauge Slug","icon_url":"https://files.facepunch.com/rust/item/ammo.shotgun.slug_512.png","yields":{"recycler":[{"shortname":"metal.fragments","name":"Metal Fragments","icon_url":"https://files.facepunch.com/rust/item/metal.fragments_512.png","quantity":1,"chance":0.5},{"shortname":"metal.fragments","name":"Metal Fragments","icon_url":"https://files.facepunch.com/rust/item/metal.fragments_512.png","quantity":1,"chance":1.0},{"shortname":"gunpowder","name":"Gun Powder","icon_url":"https://files.facepunch.com/rust/item/gunpowder_512.png","quantity":3,"chance":1.0}],"safe_zone":[{"shortname":"metal.fragments","name":"Metal Fragments","icon_url":"https://files.facepunch.com/rust/item/metal.fragments_512.png","quantity":1,"chance":1.0},{"shortname":"gunpowder","name":"Gun Powder","icon_url":"https://files.facepunch.com/rust/item/gunpowder_512.png","quantity":2,"chance":1.0}]}},"…":"840 more keys"}}}}}}}},"/calculators/blueprints":{"get":{"tags":["reference"],"summary":"Blueprint tracker dataset: unlock costs by source","description":"The dataset behind the blueprint tracker: `groups` maps an unlock source (`Research Table`,\n`Workbench Level 1 - Tech Tree`, `Workbench Level 2 - Tech Tree`, `Workbench Level 3 - Tech Tree`, or plain\n`Tech Tree` where the tier is unknown) to its items (`shortname`, `name`, `icon_url`, `scrap_cost`). An item\nappears under every source it can be learned from. Cached for 30 minutes.","operationId":"blueprints_dataset_calculators_blueprints_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"total":856,"groups":{"Research Table":[{"shortname":"ammo.shotgun","name":"12 Gauge Buckshot","icon_url":"https://files.facepunch.com/rust/item/ammo.shotgun_512.png","scrap_cost":30},{"shortname":"ammo.shotgun.fire","name":"12 Gauge Incendiary Shell","icon_url":"https://files.facepunch.com/rust/item/ammo.shotgun.fire_512.png","scrap_cost":30},{"shortname":"ammo.shotgun.slug","name":"12 Gauge Slug","icon_url":"https://files.facepunch.com/rust/item/ammo.shotgun.slug_512.png","scrap_cost":30},"… 576 more"],"Workbench Level 2 - Tech Tree":[{"shortname":"ammo.shotgun","name":"12 Gauge Buckshot","icon_url":"https://files.facepunch.com/rust/item/ammo.shotgun_512.png","scrap_cost":250},{"shortname":"ammo.shotgun.fire","name":"12 Gauge Incendiary Shell","icon_url":"https://files.facepunch.com/rust/item/ammo.shotgun.fire_512.png","scrap_cost":250},{"shortname":"ammo.shotgun.slug","name":"12 Gauge Slug","icon_url":"https://files.facepunch.com/rust/item/ammo.shotgun.slug_512.png","scrap_cost":250},"… 74 more"],"Workbench Level 3 - Tech Tree":[{"shortname":"weapon.mod.small.scope","name":"8x Zoom Scope","icon_url":"https://files.facepunch.com/rust/item/weapon.mod.small.scope_512.png","scrap_cost":500},{"shortname":"door.hinged.toptier","name":"Armored Door","icon_url":"https://files.facepunch.com/rust/item/door.hinged.toptier_512.png","scrap_cost":500},{"shortname":"door.double.hinged.toptier","name":"Armored Double Door","icon_url":"https://files.facepunch.com/rust/item/door.double.hinged.toptier_512.png","scrap_cost":500},"… 17 more"],"Workbench Level 1 - Tech Tree":[{"shortname":"fun.guitar","name":"Acoustic Guitar","icon_url":"https://files.facepunch.com/rust/item/fun.guitar_512.png","scrap_cost":125},{"shortname":"anchor","name":"Anchor","icon_url":"https://files.facepunch.com/rust/item/anchor_512.png","scrap_cost":125},{"shortname":"barricade.woodwire","name":"Barbed Wooden Barricade","icon_url":"https://files.facepunch.com/rust/item/barricade.woodwire_512.png","scrap_cost":125},"… 84 more"],"Tech Tree":[{"shortname":"electric.andswitch","name":"AND Switch","icon_url":"https://files.facepunch.com/rust/item/electric.andswitch_512.png","scrap_cost":250},{"shortname":"vehicle.1mod.cockpit.armored","name":"Armored Cockpit Vehicle Module","icon_url":"https://files.facepunch.com/rust/item/vehicle.1mod.cockpit.armored_512.png","scrap_cost":500},{"shortname":"vehicle.1mod.passengers.armored","name":"Armored Passenger Vehicle Module","icon_url":"https://files.facepunch.com/rust/item/vehicle.1mod.passengers.armored_512.png","scrap_cost":500},"… 90 more"]}}}}}}}},"/calculators/upkeep":{"get":{"tags":["reference"],"summary":"Upkeep decay brackets and decay times","description":"Rust's dedicated-server upkeep defaults (the `decay.bracket_*` and `decay.duration_*` ConVars, as most\nservers run them). `brackets` are applied in order to a base's block count: the first 15 blocks cost 10% of\ntheir build cost per day, the next 35 cost 15%, the next 75 cost 20%, and every block beyond 125 costs 33.3%\n(`blocks` null = unbounded); a base's blended daily rate is the block-weighted average of the brackets it\nfills, paid in the resources each piece was built from. `decay_hours` is how long an unmaintained piece of\neach grade takes to decay completely. Fixed constants, no computation happens server-side.","operationId":"upkeep_constants_calculators_upkeep_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"brackets":[{"blocks":15,"rate":0.1},{"blocks":35,"rate":0.15},{"blocks":75,"rate":0.2},"… 1 more"],"decay_hours":[{"grade":"Twig","hours":1.0},{"grade":"Wood","hours":3.0},{"grade":"Stone","hours":5.0},"… 2 more"],"formula":"rate = sum(min(remaining, bracket.blocks) * bracket.rate) / total_blocks, walking the brackets in order; daily upkeep of each resource = total spent building * …","source":"Rust dedicated-server ConVar defaults (decay.bracket_0..3_blockcount/costfraction, decay.duration_*)."}}}}}}},"/calculators/raid":{"get":{"tags":["reference"],"summary":"Raid cost table: explosives and sulfur per building piece","description":"The dataset behind the raid calculator. `explosives` lists every explosive the building durability data\ncovers: `shortname`, `name`, `icon_url`, `group` (`staples`, `other` or `siege`), `staple` (true for rockets,\nC4, satchel charges, explosive 5.56 ammo and beancans - the page's default set), `sulfur_per_unit` and\n`raw_cost_per_unit` (the crafting recipe resolved down to raw resources such as sulfur, charcoal, metal\nfragments and low grade fuel, per single unit; both null for loot-only explosives like MLRS rockets), `batch`\n(units one craft makes: explosive ammo 2, mortar shells 2) and `recipe_source` (`wiki` = the wiki's own\ncrafting data, `fallback` = Rust's standard recipe where that data has none yet, e.g. rockets). `targets` is\nevery building piece with explosive data (`slug`, `name`, `grade`, `health`), each with `costs` - for every\nexplosive that can damage it, `required` (how many destroy one piece), `damage_per_unit` and `sulfur` (null\nfor loot-only) - and `cheapest_staple`, the single staple explosive that destroys it for the least sulfur.\nDamage from different explosives adds up, so a cheaper mix can be computed from `damage_per_unit`. Doors and\ndeployables are not covered yet. Cached for 24 hours.","operationId":"raid_dataset_calculators_raid_get","parameters":[{"name":"grade","in":"query","required":false,"schema":{"anyOf":[{"enum":["Twig","Wood","Stone","Metal","Armored","Boat"],"type":"string"},{"type":"null"}],"description":"Restrict `targets` to one building grade.","examples":["Stone"],"title":"Grade"},"description":"Restrict `targets` to one building grade."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"explosives":[{"shortname":"ammo.rocket.basic","name":"Rocket","icon_url":"https://files.facepunch.com/rust/item/ammo.rocket.basic_512.png","group":"staples","staple":true,"sulfur_per_unit":1400,"raw_cost_per_unit":{"charcoal":1950,"sulfur":1400,"metal.fragments":100,"lowgradefuel":30,"metalpipe":2},"batch":1,"recipe_source":"fallback"},{"shortname":"explosive.timed","name":"Timed Explosive Charge","icon_url":"https://files.facepunch.com/rust/item/explosive.timed_512.png","group":"staples","staple":true,"sulfur_per_unit":2200,"raw_cost_per_unit":{"charcoal":3000,"sulfur":2200,"metal.fragments":200,"lowgradefuel":60,"cloth":5,"techparts":2},"batch":1,"recipe_source":"wiki"},{"shortname":"explosive.satchel","name":"Satchel Charge","icon_url":"https://files.facepunch.com/rust/item/explosive.satchel_512.png","group":"staples","staple":true,"sulfur_per_unit":480,"raw_cost_per_unit":{"charcoal":720,"sulfur":480,"metal.fragments":80,"rope":1,"cloth":10},"batch":1,"recipe_source":"wiki"},"… 18 more"],"total":20,"targets":[{"slug":"stone-wall","name":"Stone Wall","grade":"Stone","health":500,"costs":[{"explosive":"ammo.rocket.basic","required":4,"damage_per_unit":137.65,"sulfur":5600},{"explosive":"explosive.timed","required":2,"damage_per_unit":275.0,"sulfur":4400},{"explosive":"explosive.satchel","required":10,"damage_per_unit":51.5,"sulfur":4800},"… 15 more"],"cheapest_staple":{"explosive":"explosive.timed","required":2,"sulfur":4400}},{"slug":"stone-wall-doorway","name":"Stone Wall Doorway","grade":"Stone","health":500,"costs":[{"explosive":"ammo.rocket.basic","required":4,"damage_per_unit":137.65,"sulfur":5600},{"explosive":"explosive.timed","required":2,"damage_per_unit":275.0,"sulfur":4400},{"explosive":"explosive.satchel","required":10,"damage_per_unit":51.5,"sulfur":4800},"… 15 more"],"cheapest_staple":{"explosive":"explosive.timed","required":2,"sulfur":4400}},{"slug":"stone-wall-window","name":"Stone Wall Window","grade":"Stone","health":500,"costs":[{"explosive":"ammo.rocket.basic","required":4,"damage_per_unit":137.65,"sulfur":5600},{"explosive":"explosive.timed","required":2,"damage_per_unit":275.0,"sulfur":4400},{"explosive":"explosive.satchel","required":10,"damage_per_unit":51.5,"sulfur":4800},"… 15 more"],"cheapest_staple":{"explosive":"explosive.timed","required":2,"sulfur":4400}},"… 17 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/calculators/craft/compute":{"get":{"tags":["reference"],"summary":"Raw materials to craft a list of items","description":"Resolves every recipe down to raw materials, per unit (items made in batches, like gunpowder, are divided by\ntheir batch size), exactly as the craft calculator page does. `raw_materials` is the total, largest first;\n`items` echoes each input with its direct recipe; `unknown` lists inputs that matched no item.","operationId":"craft_compute_calculators_craft_compute_get","parameters":[{"name":"items","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":2000,"description":"Comma-separated `shortname:quantity` pairs (display names work too; quantity defaults to 1).","examples":["rocket:4,explosive.timed:2"],"title":"Items"},"description":"Comma-separated `shortname:quantity` pairs (display names work too; quantity defaults to 1)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/calculators/recycle/compute":{"get":{"tags":["reference"],"summary":"What recycling a list of items yields","description":"Expected outputs (quantity x per-unit yield x chance) per input and in total, for the chosen recycler.","operationId":"recycle_compute_calculators_recycle_compute_get","parameters":[{"name":"items","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":2000,"description":"Comma-separated `shortname:quantity` pairs (display names work too; quantity defaults to 1).","examples":["gears:10,metalpipe:5"],"title":"Items"},"description":"Comma-separated `shortname:quantity` pairs (display names work too; quantity defaults to 1)."},{"name":"recycler","in":"query","required":false,"schema":{"enum":["recycler","safe_zone"],"type":"string","description":"`recycler` (monument) or `safe_zone` (Outpost/Bandit Camp, lower yields).","default":"recycler","title":"Recycler"},"description":"`recycler` (monument) or `safe_zone` (Outpost/Bandit Camp, lower yields)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/calculators/raid/compute":{"get":{"tags":["reference"],"summary":"Explosives needed to destroy a set of building pieces","description":"For every explosive that can destroy all the given pieces: total units and sulfur, cheapest sulfur first;\n`cheapest` is the best single option. Single-explosive totals - damage adds up across explosives, so a mix can\nbe cheaper (use /calculators/raid's damage_per_unit for that). Doors and deployables aren't covered yet.","operationId":"raid_compute_calculators_raid_compute_get","parameters":[{"name":"targets","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":2000,"description":"Comma-separated `slug:count` building pieces (slugs from /building, or display names).","examples":["stone-wall:2,sheet-metal-wall:1"],"title":"Targets"},"description":"Comma-separated `slug:count` building pieces (slugs from /building, or display names)."},{"name":"explosives","in":"query","required":false,"schema":{"type":"string","description":"`staples` (rockets, C4, satchels, explosive ammo, beancans), `all`, or a comma list of explosive shortnames.","default":"staples","title":"Explosives"},"description":"`staples` (rockets, C4, satchels, explosive ammo, beancans), `all`, or a comma list of explosive shortnames."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/calculators/upkeep/compute":{"get":{"tags":["reference"],"summary":"Daily upkeep for a base","description":"The upkeep calculator page's math: the block count walks Rust's default upkeep brackets to a blended daily\nrate, and each resource's daily upkeep is what was spent building times that rate (`per_week` = 7 days).","operationId":"upkeep_compute_calculators_upkeep_compute_get","parameters":[{"name":"blocks","in":"query","required":true,"schema":{"type":"integer","maximum":100000,"minimum":1,"description":"Number of building blocks (foundations, walls, floors... each counts one).","title":"Blocks"},"description":"Number of building blocks (foundations, walls, floors... each counts one)."},{"name":"wood","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"Total wood spent building the base.","default":0,"title":"Wood"},"description":"Total wood spent building the base."},{"name":"stone","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"Total stone spent.","default":0,"title":"Stone"},"description":"Total stone spent."},{"name":"metal_fragments","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"Total metal fragments spent.","default":0,"title":"Metal Fragments"},"description":"Total metal fragments spent."},{"name":"high_quality_metal","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"Total high quality metal spent.","default":0,"title":"High Quality Metal"},"description":"Total high quality metal spent."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/calculators/genetics/best":{"get":{"tags":["reference"],"summary":"Best crossbreeding layout from a pool of plant clones","description":"The gene calculator's beam search, ported exactly: which clones to plant around the centre, how many of each,\nand what the centre will most likely become (with every outcome's chance). Uses the game's gene weights (red\nW/X 1.0, green G/Y/H 0.6).","operationId":"genetics_best_calculators_genetics_best_get","parameters":[{"name":"clones","in":"query","required":true,"schema":{"type":"string","minLength":6,"maxLength":400,"description":"Comma-separated 6-letter gene strings of the clones you have (G Y H W X).","examples":["GGYYHX,GYYHWW,YYGGXH"],"title":"Clones"},"description":"Comma-separated 6-letter gene strings of the clones you have (G Y H W X)."},{"name":"target","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional 6-letter target such as GGGGYY; default: as many G and Y as possible.","title":"Target"},"description":"Optional 6-letter target such as GGGGYY; default: as many G and Y as possible."},{"name":"centre","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional genes of the plant in the centre slot (default: unknown).","title":"Centre"},"description":"Optional genes of the plant in the centre slot (default: unknown)."},{"name":"max_neighbours","in":"query","required":false,"schema":{"type":"integer","maximum":8,"minimum":1,"description":"Most neighbouring plants to use (a planter grid allows 8).","default":8,"title":"Max Neighbours"},"description":"Most neighbouring plants to use (a planter grid allows 8)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/calculators/genetics/predict":{"get":{"tags":["reference"],"summary":"What a plant will grow into from its neighbours","description":"Every possible result for the centre plant with its probability, most likely first.","operationId":"genetics_predict_calculators_genetics_predict_get","parameters":[{"name":"neighbours","in":"query","required":true,"schema":{"type":"string","minLength":6,"maxLength":200,"description":"Comma-separated 6-letter gene strings of the neighbouring plants.","examples":["GGYYHX,GGYYHX,YYGGXH"],"title":"Neighbours"},"description":"Comma-separated 6-letter gene strings of the neighbouring plants."},{"name":"centre","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Genes of the centre plant, if known.","title":"Centre"},"description":"Genes of the centre plant, if known."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/guides/search":{"get":{"tags":["reference"],"summary":"Search the RustProfit blog's Rust guides","description":"Published guides from blog.rustprofit.com (monuments, recyclers, farming, base building, raiding, gear, NPCs,\nwipes, update explainers), best match first: every word must appear somewhere in the guide, and title matches\nrank above summary and tag matches, which rank above body-text matches. Link the `url` when citing one.","operationId":"guides_search_guides_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":100,"description":"Words to find in guide titles, summaries, tags and text.","examples":["recycler locations"],"title":"Q"},"description":"Words to find in guide titles, summaries, tags and text."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"description":"Most results to return.","default":5,"title":"Limit"},"description":"Most results to return."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/drops":{"get":{"tags":["reference"],"summary":"Current Rust Twitch and Kick drops","description":"The live drops campaigns (Twitch and Kick: round, dates, general and streamer drops with the skin each one\ngives), the most valuable drop skins ever by Steam price, and past rounds - the data behind rust.wiki/drops.","operationId":"drops_drops_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/updates":{"get":{"tags":["reference"],"summary":"Facepunch's Rust updates and devblogs","description":"Every post from rust.facepunch.com/news, newest first. Each carries `slug`, `title`, `summary`,\n`category` (`devblog`, `news`, `update`, ...), `published_date` (UTC date), `thumbnail_url`, `url` (the\nofficial post, or this network's own write-up when `has_blog_post` is true) and `has_blog_post`. Polled every\nfew minutes; the first page is refreshed the moment a new post is found.","operationId":"list_updates_updates_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number.","default":1,"title":"Page"},"description":"1-based page number."},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page (max 200).","default":50,"title":"Per Page"},"description":"Results per page (max 200)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":50,"total":672,"pages":14,"results":[{"slug":"livestock","title":"Livestock Update","summary":"This month's update brings a major refresh to farming with the introduction of new Livestock animals, critters, and swimmers. Plus, fresh food recipes, the new …","category":"devblog","published_date":"2026-10-01","thumbnail_url":"https://files.facepunch.com/lewis/2026/September/livestock-branding.png","url":"https://rust.facepunch.com/news/livestock","has_blog_post":false},{"slug":"breach-and-clear","title":"Breach and Clear","summary":"This month's update brings you Monument Blockers, Breakable Attack Heli Armour, HQM Nodes, Upkeep Group Scaling, various item buffs, and QoL and balance changes…","category":"devblog","published_date":"2026-09-03","thumbnail_url":"https://files.facepunch.com/lewis/2026/August/Brantbreach-and-clear_branding.png","url":"https://blog.rustprofit.com/rust-update-breach-and-clear-explained","has_blog_post":true},{"slug":"power-trip","title":"Power Trip","summary":"This month's update brings you Player Maintained Monuments in the form of a new Satellite Crash, Dome Pumping, restorable Power Plant, plus more. As well as ple…","category":"devblog","published_date":"2026-08-06","thumbnail_url":"https://files.facepunch.com/lewis/2026/August/power-trip_branding_1.png","url":"https://blog.rustprofit.com/rust-update-power-trip-explained","has_blog_post":true},"… 47 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/currency/rates":{"get":{"tags":["reference"],"summary":"USD exchange rates the site prices with","description":"The live rates every rust.wiki currency switcher converts USD prices through, for the currencies the\nswitcher offers. Each row carries `code` (ISO 4217), `name`, `symbol`, `flag` (ISO country code), `rate`\n(units of that currency per 1 USD) and `inverse` (USD per unit). Sourced from open.er-api.com and refreshed\nabout every 15 minutes; USD itself is included at 1.0.","operationId":"currency_rates_currency_rates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"base":"USD","total":20,"results":[{"code":"USD","name":"United States Dollar","symbol":"$","flag":"us","rate":1.0,"inverse":1.0},{"code":"GBP","name":"Pound Sterling","symbol":"£","flag":"gb","rate":0.7571,"inverse":1.3208},{"code":"EUR","name":"Euro","symbol":"€","flag":"eu","rate":0.8873,"inverse":1.127},"… 17 more"]}}}}}}},"/players/resolve":{"get":{"tags":["players"],"summary":"Resolve a profile URL or vanity name to a SteamID64","description":"Turns any of the accepted identifier forms into a 17-digit SteamID64. Does not fetch the profile.","operationId":"resolve_players_resolve_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"description":"A steamcommunity.com profile URL, a custom URL name, or a SteamID64.","examples":["https://steamcommunity.com/id/willjum"],"title":"Q"},"description":"A steamcommunity.com profile URL, a custom URL name, or a SteamID64."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"query":"https://steamcommunity.com/id/willjum","steamid":"76561199126382502"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/players/{steamid}":{"get":{"tags":["players"],"summary":"Player profile, Rust stats and achievements","description":"Profile summary (name, avatar, country, Steam level, account age), VAC/game bans, Rust playtime, every Rust\nstat Steam exposes grouped into Combat / Animals & NPCs / How you died / Gathering & loot / Building / Travel /\nLife on the island / Fishing / Music / Everything else, six headline figures (kills, deaths, K/D, headshots,\nbullet and arrow accuracy), and all 116 achievements with unlock dates. `stats_private` is true when the\nprofile hides game details, in which case `groups` and `achievements` are empty.","operationId":"player_players__steamid__get","parameters":[{"name":"steamid","in":"path","required":true,"schema":{"type":"string","description":"17-digit SteamID64. Use /players/resolve for URLs and vanity names.","examples":["76561199126382502"],"title":"Steamid"},"description":"17-digit SteamID64. Use /players/resolve for URLs and vanity names."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"steamid":"76561199126382502","found":true,"name":"john final boss","avatar":"https://avatars.steamstatic.com/5b67c938a6acd16f7e44a5b39f678d72bb5f6245_full.jpg","profile_url":"https://steamcommunity.com/id/willjum/","public":true,"country":null,"created":"Jan 2021","level":17,"vac_bans":0,"game_bans":0,"days_since_ban":0,"…":"12 more keys"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/inventory/leaderboard":{"get":{"tags":["inventory"],"summary":"Most valuable inventories ever checked","description":"The rust.wiki/inventory leaderboard: every inventory anyone has looked up, ranked by total value at its\nlast check (values are re-priced each time an inventory is viewed or by the daily warmer for the top 20). Includes\nthe network-wide totals. 20 per page.","operationId":"leaderboard_inventory_leaderboard_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page; 20 inventories per page.","default":1,"title":"Page"},"description":"1-based page; 20 inventories per page."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":20,"total":58105,"total_value_checked":1938827938,"results":[{"rank":1,"steamid64":"76561198297663226","display_name":"TRADEIT MultiTrade BOT #1","avatar_url":"https://avatars.steamstatic.com/ac9abb720c0244baaefe7422d59d5bb55bebd643_full.jpg","total_value":15120736,"item_count":109484},{"rank":2,"steamid64":"76561198250325118","display_name":"Rushed","avatar_url":"https://avatars.steamstatic.com/fe33df739913b7c6ec333f53e0919e0d6d04813b_full.jpg","total_value":12572878,"item_count":40349},{"rank":3,"steamid64":"76561197972605414","display_name":"-RB- Rudeolph","avatar_url":"https://avatars.steamstatic.com/bc5c53e0682b94785ca2d684eb4971243c335206_full.jpg","total_value":10101181,"item_count":32703},"… 17 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/inventory/{steamid}":{"get":{"tags":["inventory"],"summary":"Value a Steam account's Rust skins","description":"Every Rust skin the account holds with `quantity`, unit `price` and `value` (cents), sorted by value, and the\nsame attributes /skins filters on (`collection`, `creator`, `item_shortname`, `item_name`, `est_supply`,\n`released_year`, `colors`, and `flags`: limited_time, permanent, marketable, tradable, breakable, glows,\ncommodity, drop), plus\n`total_value`, `item_count`, `distinct_skins`, a `categories` breakdown with share percentages, the owner's\ndisplay name and avatar, and `value_history` (the current holdings re-priced at each of the last 365 days, in USD\nDOLLARS, not cents, at each day's Steam sale price - so its latest point can be below `total_value`, which is at\ncurrent asking prices).\n`found` is false for private or empty inventories; `stale` is true when Steam was unreachable and the last\nstored snapshot was re-priced instead.","operationId":"inventory_inventory__steamid__get","parameters":[{"name":"steamid","in":"path","required":true,"schema":{"type":"string","description":"17-digit SteamID64 (resolve URLs and vanity names with /players/resolve).","examples":["76561198869732295"],"title":"Steamid"},"description":"17-digit SteamID64 (resolve URLs and vanity names with /players/resolve)."},{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Force a live Steam read instead of the stored snapshot (max 100 per key per day).","default":false,"title":"Refresh"},"description":"Force a live Steam read instead of the stored snapshot (max 100 per key per day)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"found":true,"steamid":"76561198869732295","display_name":"Mark","avatar_url":"https://avatars.steamstatic.com/9fa5f109a7ae3611b68f8ecfb382962a3f90c10e_full.jpg","profile_url":"https://steamcommunity.com/profiles/76561198869732295","steam_inventory_url":"https://steamcommunity.com/profiles/76561198869732295/inventory/#252490_2","total_value":4330856,"item_count":28386,"distinct_skins":1357,"unpriced_skins":0,"stale":false,"stale_as_of":null,"…":"4 more keys"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/inventory/{steamid}/history":{"get":{"tags":["inventory"],"summary":"Inventory value over time","description":"The inventory's value over time: the account's current holdings re-priced at each day's Steam SALE price\n(median sale), `values` in USD cents, oldest first - the line on the rust.wiki inventory chart. It shows how the\nmarket moved, not when items were bought. `headline_total_value` is the total at current Steam ASKING prices\n(lowest sell order) as of `headline_checked_at`, the number shown at the top of the inventory page; for thinly\ntraded skins it can sit well above the latest point here. Only inventories that have been looked up have a\nseries. Read from stored data: never a live Steam call.","operationId":"value_history_inventory__steamid__history_get","parameters":[{"name":"steamid","in":"path","required":true,"schema":{"type":"string","description":"17-digit SteamID64.","examples":["76561198869732295"],"title":"Steamid"},"description":"17-digit SteamID64."},{"name":"range","in":"query","required":false,"schema":{"type":"string","description":"7d, 30d, 90d, 1y, 2y, 3y, 4y, 5y, all, or custom (with start_date/end_date).","default":"1y","title":"Range"},"description":"7d, 30d, 90d, 1y, 2y, 3y, 4y, 5y, all, or custom (with start_date/end_date)."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"YYYY-MM-DD, with range=custom.","title":"Start Date"},"description":"YYYY-MM-DD, with range=custom."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"YYYY-MM-DD, with range=custom.","title":"End Date"},"description":"YYYY-MM-DD, with range=custom."},{"name":"interval","in":"query","required":false,"schema":{"type":"string","description":"daily, weekly, monthly, or auto (daily up to 400 points, then weekly, then monthly past 400 weeks).","default":"auto","title":"Interval"},"description":"daily, weekly, monthly, or auto (daily up to 400 points, then weekly, then monthly past 400 weeks)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/inventory/{steamid}/valuation":{"get":{"tags":["inventory"],"summary":"What an inventory is realistically worth","description":"The inventory valued three ways, plus what selling would actually raise. `at_asks` is the headline number\n(each skin at its cheapest Steam listing, falling back to the best buy order); `at_bids` is every skin at its\nbest buy order; `at_recent_sales` is every skin at its latest Steam median sale price (the inventory chart's\nbasis). `sell_now` walks each skin's real buy-order ladder for the quantity held: `units_sellable` of\n`units_held` could be sold instantly for `gross` (what buyers pay) and `net_after_fees` (after Steam's 15%).\n`biggest_ask_gaps` lists the skins whose cheapest listing sits furthest above their recent sales - thin order\nbooks where the headline is least reliable. All cents. Uses the stored holdings (the last lookup) and current\norder books: never a live Steam call; look the inventory up first if `found` is false.","operationId":"valuation_inventory__steamid__valuation_get","parameters":[{"name":"steamid","in":"path","required":true,"schema":{"type":"string","description":"17-digit SteamID64.","examples":["76561198869732295"],"title":"Steamid"},"description":"17-digit SteamID64."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/inventory/{steamid}/snapshots":{"get":{"tags":["inventory"],"summary":"Dates with a saved daily snapshot","description":"Every date (newest first, up to 400) on which a daily snapshot of this inventory was stored, plus `totals`:\neach of those days' total value in cents (that day's holdings at that day's prices). Snapshots are written when\nan inventory is looked up; fetch one with /inventory/{steamid}/snapshots/{date}.","operationId":"snapshot_dates_inventory__steamid__snapshots_get","parameters":[{"name":"steamid","in":"path","required":true,"schema":{"type":"string","description":"17-digit SteamID64.","examples":["76561198869732295"],"title":"Steamid"},"description":"17-digit SteamID64."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"steamid":"76561198869732295","count":21,"dates":["2026-10-03","2026-10-02","2026-10-01","… 18 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/inventory/{steamid}/snapshots/{date}":{"get":{"tags":["inventory"],"summary":"One saved daily snapshot","description":"The inventory exactly as it was priced on that day: items with quantity and that day's price, total value and\nitem count. Useful for 'what was this worth last month' comparisons.","operationId":"snapshot_inventory__steamid__snapshots__date__get","parameters":[{"name":"steamid","in":"path","required":true,"schema":{"type":"string","description":"17-digit SteamID64.","examples":["76561198869732295"],"title":"Steamid"},"description":"17-digit SteamID64."},{"name":"date","in":"path","required":true,"schema":{"type":"string","description":"ISO date (YYYY-MM-DD) from /inventory/{steamid}/snapshots.","examples":["2026-09-30"],"title":"Date"},"description":"ISO date (YYYY-MM-DD) from /inventory/{steamid}/snapshots."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"steamid":"76561198869732295","snapshot_date":"2026-09-30","total_value":4481943,"item_count":31037,"items":[{"market_hash_name":"Tempered Mp5","quantity":1,"price":52283,"itemdefid":20083},{"market_hash_name":"Christmas Lights","quantity":1,"price":14639,"itemdefid":10150},{"market_hash_name":"Glowing Skull","quantity":1,"price":19642,"itemdefid":20009},"… 1324 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/games":{"get":{"tags":["games"],"summary":"The seven casino games","description":"Every game on rustprofit.com with a one-line description, whether its finished rounds are public here\n(`public_rounds`: roulette, coinflip, jackpot and crash have GET /games/{game}/rounds; mines, tower and\nupgrade are single-player and only appear in the key owner's own GET /games/me/history), its house edge as a\nfraction, and `live_wagered_cents` - the value currently sitting in that game's open round(s), from the same\ncache the site's header pot display reads (null if the cache is cold). All money is integer USD cents.","operationId":"list_games_games_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"games":[{"id":"roulette","name":"Roulette","players":"multiplayer","public_rounds":true,"description":"A shared wheel every 45 seconds: bet skins on red or black (pays 2x) or green (pays 14x); one of 15 numbers is drawn from the day's server seed, the public seed…","house_edge":0.0667,"live_wagered_cents":null,"rounds_endpoint":"/games/roulette/rounds","seeds_endpoint":"/games/roulette/seeds","site_url":"https://rustprofit.com/roulette"},{"id":"coinflip","name":"Coinflip","players":"multiplayer","public_rounds":true,"description":"One player creates a red-or-black game with their skins, another joins with a matching value (or the creator calls the house bot); a ticket drawn from the serve…","house_edge":0.05,"live_wagered_cents":null,"live_open_games":null,"rounds_endpoint":"/games/coinflip/rounds","seeds_endpoint":"/games/coinflip/seeds","site_url":"https://rustprofit.com/coinflip"},{"id":"jackpot","name":"Jackpot","players":"multiplayer","public_rounds":true,"description":"Everyone deposits into one pot; each player holds a ticket range proportional to their share and a ticket drawn from the server seed and an EOS block hash picks…","house_edge":0.05,"live_wagered_cents":null,"rounds_endpoint":"/games/jackpot/rounds","seeds_endpoint":"/games/jackpot/seeds","site_url":"https://rustprofit.com/jackpot"},"… 4 more"],"currency":"USD cents","fairness":"https://rustprofit.com/fairness","fairness_endpoint":"/games/fairness"}}}}}}},"/games/fairness":{"get":{"tags":["games"],"summary":"How the provably-fair system works, as data","description":"The commit-then-reveal scheme behind every game, written out so a program (or a reader) can re-implement\nthe verification: per game the inputs, the exact HMAC-SHA256 message, the modulo, how the roll maps to an\noutcome (roulette colours, coinflip/jackpot ticket ranges, mines and tower Fisher-Yates position draws, the\ncrash-point and upgrade formulas), which id goes into the message (the round `id` for roulette/coinflip/\njackpot, the shared `game_id` for mines/tower/crash/upgrade), how EOS block hashes and the player's client seed\nkeep the house from choosing the message, when each server seed is revealed, and the house edge. Static -\nmirrors app code, and GET /games/verify applies it.","operationId":"fairness_scheme_games_fairness_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"site":"https://rustprofit.com/fairness","verify_endpoint":"/games/verify","summary":"Commit-then-reveal. Before a round can be influenced the site publishes the SHA-256 hash of a secret server seed (shown on the round as `server_seed_hash`). The…","encoding":"Seeds and messages are UTF-8 strings; the HMAC digest is interpreted as a big-endian hexadecimal integer before the modulo; sha256 is of the server seed string …","games":{"roulette":{"inputs":["server_seed","public_seed","round"],"message":"{public_seed}-{round}","roll":"int(HMAC-SHA256(key=server_seed, message=...) read as a hexadecimal integer, 16) % 15","colour":{"red":[0,2,4,"… 4 more"],"black":[1,3,5,"… 4 more"],"green":[7]},"payout_multipliers":{"red":2,"black":2,"green":14},"round":"the roulette round id (`id` of /games/roulette/rounds; `round` in the round's `fair` block)","seed_rotation":"One server seed + public seed pair serves a whole UTC day of rounds. While it is active the site shows only sha256(server_seed) and the public seed; at 00:00 UT…","house_edge":0.0667,"house_edge_note":"1/15 of the round's total is taken as tax.","seeds_endpoint":"/games/roulette/seeds"},"coinflip":{"inputs":["server_seed","eos_block_hash","round"],"message":"{eos_block_hash}-{round}","ticket":"int(HMAC-SHA256(key=server_seed, message=...) read as a hexadecimal integer, 16) % 100000000","round":"the coinflip round id (`id` of /games/coinflip/rounds)","eos_block":"When betting closes the site reads the current EOS head block N and commits to block N+4 (`eos_block`). Once that block is irreversible its block id becomes `eo…","outcome":"Each side owns an inclusive ticket range of the 100,000,000 tickets, proportional to its share of the pot (`ticket_range` on the round). The side whose range co…","house_edge":0.05,"seeds_endpoint":"/games/coinflip/seeds"},"jackpot":{"inputs":["server_seed","eos_block_hash","round"],"message":"{eos_block_hash}-{round}","ticket":"int(HMAC-SHA256(key=server_seed, message=...) read as a hexadecimal integer, 16) % 100000000","round":"the jackpot round id (`id` of /games/jackpot/rounds)","eos_block":"Same scheme as coinflip: head block N at countdown end, commit to N+4, roll on its irreversible block id.","outcome":"Participants hold consecutive inclusive ticket ranges in deposit order (`ticket_range`); the participant whose range contains the ticket wins the pot.","house_edge":0.05,"seeds_endpoint":"/games/jackpot/seeds"},"mines":{"inputs":["server_seed","client_seed","game_id","… 1 more"],"message":"{client_seed}-{game_id}","roll":"int(HMAC-SHA256(key=server_seed, message=...) read as a hexadecimal integer, 16) % 100000000","game_id":"the shared game id shown as `game_id` (NOT the per-game round id `id`); the one the site's own fairness page lists for the round","mine_positions":"Seeded Fisher-Yates shuffle of positions = [0..24]: for i from 24 down to 1, r = int(HMAC-SHA256(server_seed, '{client_seed}-{game_id}-{i}'), 16) % (i + 1); swa…","client_seed":"The player's own editable seed (User.client_seed, see /games/me/client-seed), fixed when the round is created, so the house cannot pick the message.","multiplier":"product over revealed safe tiles of (25 - i) / (25 - mine_count - i), times (1 - 0.07)","house_edge":0.07,"seeds_endpoint":"/games/mines/seeds"},"tower":{"inputs":["server_seed","client_seed","game_id","… 2 more"],"message":"{client_seed}-{game_id}-row{row}-{i}","bad_positions":"For each of the 8 rows (row = 0..7) an independent seeded Fisher-Yates shuffle of cols = [0..cols_per_row-1]: for i from cols_per_row-1 down to 1, r = int(HMAC-…","bad_count":"1 + (tier * (cols_per_row - 2)) // 2 with tier easy=0, medium=1, hard=2","difficulties":["easy","medium","hard"],"multiplier":"(cols_per_row / (cols_per_row - bad_count)) ** rows_climbed, times (1 - 0.07)","house_edge":0.07,"seeds_endpoint":"/games/tower/seeds"},"crash":{"inputs":["server_seed","client_seed","game_id"],"message":"{client_seed}-{game_id}","roll":"int(HMAC-SHA256(key=server_seed, message=...) read as a hexadecimal integer, 16) % 100000000","crash_point":"max(1.0, floor(((1 - 0.07) / (1 - roll / 100000000)) * 100) / 100)","curve":"the live multiplier is exp(0.045 * seconds since the round started) until it reaches crash_point","game_id":"the shared game id shown as `game_id` on the round (NOT the round id `id`)","house_edge":0.07,"seeds_endpoint":"/games/crash/seeds"},"upgrade":{"inputs":["server_seed","client_seed","game_id","… 2 more"],"message":"{client_seed}-{game_id}","roll":"int(HMAC-SHA256(key=server_seed, message=...) read as a hexadecimal integer, 16) % 100000000","win":"((roll - int(offset)) % 100000000) < int(chance * 100000000) - the win zone is a `chance`-wide arc of the 100,000,000-slot wheel starting at `offset` (0 for 'un…","multiplier":"(1 - 0.1) / chance","game_id":"the shared game id shown as `game_id` on the round (NOT the round id `id`)","house_edge":0.1,"seeds_endpoint":"/games/upgrade/seeds"}}}}}}}}},"/games/verify":{"get":{"tags":["games"],"summary":"Recompute a round's outcome from its revealed seeds","description":"A pure function - no database, nothing stored. Applies the exact formulas in GET /games/fairness and\nreturns `server_seed_hash` (sha256 of the seed, to match against the hash the site published before the\nround) plus the recomputed outcome: roulette `roll` and `colour`; coinflip/jackpot `ticket` (compare with the\nround's `ticket_range`s); mines `roll` and `mine_positions`; tower `bad_positions` per row; crash `roll` and\n`crash_point`; upgrade `roll` (and `win` when `chance` is given). Missing per-game inputs return 422.","operationId":"verify_games_verify_get","parameters":[{"name":"game","in":"query","required":true,"schema":{"$ref":"#/components/schemas/Game","description":"Which game's formula to apply.","examples":["mines"]},"description":"Which game's formula to apply."},{"name":"server_seed","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":512,"description":"The revealed server seed (`server_seed` on a finished round or seeds page).","examples":["3f1c9a8e5b7d2c4a6e8f0b1d3c5a7e9f"],"title":"Server Seed"},"description":"The revealed server seed (`server_seed` on a finished round or seeds page)."},{"name":"public_seed","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"description":"Roulette only: the day's public seed shown next to the hash (five random numbers 1-39 run together).","title":"Public Seed"},"description":"Roulette only: the day's public seed shown next to the hash (five random numbers 1-39 run together)."},{"name":"eos_block_hash","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"description":"Coinflip/jackpot only: the irreversible EOS block id (`eos_block_hash` on the round).","title":"Eos Block Hash"},"description":"Coinflip/jackpot only: the irreversible EOS block id (`eos_block_hash` on the round)."},{"name":"round","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Roulette/coinflip/jackpot only: the round id (`id` of the round, `round` in its `fair` block).","title":"Round"},"description":"Roulette/coinflip/jackpot only: the round id (`id` of the round, `round` in its `fair` block)."},{"name":"client_seed","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"description":"Mines/tower/crash/upgrade only: the player's client seed shown on the round.","examples":["a1b2c3d4e5f60718"],"title":"Client Seed"},"description":"Mines/tower/crash/upgrade only: the player's client seed shown on the round."},{"name":"game_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Mines/tower/crash/upgrade only: the SHARED game id (`game_id` on the round / history row), not the round id.","examples":[1234567],"title":"Game Id"},"description":"Mines/tower/crash/upgrade only: the SHARED game id (`game_id` on the round / history row), not the round id."},{"name":"mine_count","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":24,"minimum":1},{"type":"null"}],"description":"Mines only: how many mines the round was played with.","examples":[3],"title":"Mine Count"},"description":"Mines only: how many mines the round was played with."},{"name":"cols_per_row","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":4,"minimum":2},{"type":"null"}],"description":"Tower only: tiles per row (2-4).","title":"Cols Per Row"},"description":"Tower only: tiles per row (2-4)."},{"name":"difficulty","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Tower only: easy, medium or hard (derives bad_count); or pass bad_count directly.","title":"Difficulty"},"description":"Tower only: easy, medium or hard (derives bad_count); or pass bad_count directly."},{"name":"bad_count","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Tower only: bad tiles per row, if you have it instead of difficulty.","title":"Bad Count"},"description":"Tower only: bad tiles per row, if you have it instead of difficulty."},{"name":"rows","in":"query","required":false,"schema":{"type":"integer","maximum":64,"minimum":1,"description":"Tower only: rows to draw (the site plays 8).","default":8,"title":"Rows"},"description":"Tower only: rows to draw (the site plays 8)."},{"name":"chance","in":"query","required":false,"schema":{"anyOf":[{"type":"number","exclusiveMaximum":1,"exclusiveMinimum":0},{"type":"null"}],"description":"Upgrade only (optional): the win chance as a fraction, e.g. 0.45, to also evaluate the win.","title":"Chance"},"description":"Upgrade only (optional): the win chance as a fraction, e.g. 0.45, to also evaluate the win."},{"name":"offset","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Upgrade only (optional): the win-zone offset committed at start (0 for 'under').","title":"Offset"},"description":"Upgrade only (optional): the win-zone offset committed at start (0 for 'under')."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"game":"mines","server_seed_hash":"fcdd8c4e91034ee234766d4ce5f96c304e9159d5741980d049f6767bdbf1f9f6","inputs":{"client_seed":"a1b2c3d4e5f60718","game_id":1234567,"message":"a1b2c3d4e5f60718-1234567"},"result":{"roll":51918515,"mine_positions":[13,17,18],"grid_size":25}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/games/me/history":{"get":{"tags":["games"],"summary":"Your own game history","description":"The API key owner's own finished rounds across the seven games, one row per round played (the same\nsource as the site's History page), newest first by default: `type` (the game), `game_id` (the shared id\nused in the fairness message for mines/tower/crash/upgrade), `round_id` (the per-game round id - the `id`\nof GET /games/{game}/rounds/{round_id} for roulette/coinflip/jackpot/crash and of the seeds pages),\n`amount_cents` (bet), `payout_cents`, `win`, `completed_at` and `details` (per-game facts such as\nmultiplier, mines count, crash point, revealed server seed, the skins involved as `{name, classid, price}`).\nTrade-offer, bot and asset identifiers are removed. Only the key owner's own account is ever returned.","operationId":"my_history_games_me_history_get","parameters":[{"name":"game","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/Game"},{"type":"null"}],"description":"Only this game; omit for all seven.","examples":["mines"],"title":"Game"},"description":"Only this game; omit for all seven."},{"name":"win","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"true = only wins, false = only losses, omit for both.","title":"Win"},"description":"true = only wins, false = only losses, omit for both."},{"name":"sort","in":"query","required":false,"schema":{"$ref":"#/components/schemas/HistorySort","description":"newest (default), amount_desc or amount_asc (by bet amount).","default":"newest"},"description":"newest (default), amount_desc or amount_asc (by bet amount)."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number.","default":1,"title":"Page"},"description":"1-based page number."},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page (max 200).","default":50,"title":"Per Page"},"description":"Results per page (max 200)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":50,"total":0,"pages":1,"results":[]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/games/me/stats":{"get":{"tags":["games"],"summary":"Your own lifetime casino stats","description":"The API key owner's lifetime totals as the site's profile shows them: `total_wagered`, `total_won`,\n`total_lost`, `profit`, `played`, `wins`, `losses`, `win_loss_ratio`, biggest win/loss with the game and\nround id, and the same six counters per game (`roulette`, `coinflip`, `jackpot`, `mines`, `crash`,\n`upgrade`, `tower`). Amounts are USD cents. 404 until the account has played a round.","operationId":"my_stats_games_me_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"total_wagered":0,"total_won":0,"total_lost":0,"profit":0,"played":0,"wins":0,"losses":0,"win_loss_ratio":0.0,"biggest_win":0,"biggest_win_game":null,"biggest_win_id":null,"biggest_loss":0,"…":"9 more keys"}}}}}}},"/games/me/client-seed":{"get":{"tags":["games"],"summary":"Your current provably-fair client seed","description":"The client seed the key owner's next mines/tower/crash/upgrade round will be created with (it is fixed\non the round at creation, so later changes never affect a round in play). Read-only here - change it on\nthe site's fairness page. `null` means the account has not played a seed-pair game yet; the site generates\none the first time.","operationId":"my_client_seed_games_me_client_seed_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"client_seed":"free","used_by":["mines","tower","crash","… 1 more"],"message_format":"{client_seed}-{game_id}","change_at":"https://rustprofit.com/fairness"}}}}}}},"/games/{game}/rounds":{"get":{"tags":["games"],"summary":"Finished rounds of a public game, newest first","description":"Completed rounds only, newest first. Every row has `id`, `started_at`/`ended_at`, `result`, the pot and tax\nin cents, the participants as the site's own round page shows them (public `user_id`, `username`, `avatar`,\n`badge`, `level`, bet in cents - never SteamIDs) and a `fair` block: `server_seed_hash`, `server_seed`\n(null with `seed_revealed: false` for roulette rounds under the still-active daily seed; `seed_id` is that\nday's row on /games/roulette/seeds), the public input (roulette `public_seed`, coinflip/jackpot `eos_block` +\n`eos_block_hash`, crash `client_seed`), the id the HMAC uses and the exact `message`. Per game: roulette\n`result.colour`/`number` and `bets_cents` per colour;\ncoinflip `creator`/`opponent` with `side`, `ticket_range`, `win_chance_pct`, `is_house_bot`; jackpot\n`participants` with `ticket_range`/`win_chance_pct` and `result.winner`; crash `result.crash_point`/\n`cashed_out_at`/`win` with the single `player`. Item lists are on GET /games/{game}/rounds/{round_id}.","operationId":"rounds_games__game__rounds_get","parameters":[{"name":"game","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Game","description":"roulette, coinflip, jackpot or crash. mines/tower/upgrade return 404 (single-player; see /games/me/history).","examples":["roulette"]},"description":"roulette, coinflip, jackpot or crash. mines/tower/upgrade return 404 (single-player; see /games/me/history)."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number.","default":1,"title":"Page"},"description":"1-based page number."},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page (max 200).","default":50,"title":"Per Page"},"description":"Results per page (max 200)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":50,"total":200503,"pages":4011,"results":[{"id":200567,"game":"roulette","started_at":"2026-10-03T00:16:31.737811","ended_at":"2026-10-03T00:17:16.737811","result":{"colour":"black","number":3,"multiplier":2},"pot_cents":0,"bets_cents":{"red":0,"green":0,"black":0},"tax_cents":0,"participant_count":0,"participants":[],"fair":{"server_seed_hash":"0e16fc7431a4facd5d1f64f29bdd82ce637ccbecb757f17d0c6b00ea2ecdd920","server_seed":null,"seed_revealed":false,"public_seed":"2024111822","round":200567,"message":"2024111822-200567","seed_id":110,"seed_note":"The day's server seed is revealed when the seed rotates at 00:00 UTC; until then only its hash and the public seed are public."}},{"id":200566,"game":"roulette","started_at":"2026-10-03T00:15:46.630125","ended_at":"2026-10-03T00:16:31.630125","result":{"colour":"black","number":5,"multiplier":2},"pot_cents":9836,"bets_cents":{"red":0,"green":0,"black":9836},"tax_cents":655,"participant_count":1,"participants":[{"user_id":30,"username":"gorloc destroyeer","avatar":"https://avatars.fastly.steamstatic.com/b741881a35e2d598cf0f5e27c605d0dc43ccd267_full.jpg","avatar_static":"https://avatars.fastly.steamstatic.com/b741881a35e2d598cf0f5e27c605d0dc43ccd267_full.jpg","badge":"level","level":null,"bet_cents":9836,"won_cents":19672,"colours":["black"]}],"fair":{"server_seed_hash":"0e16fc7431a4facd5d1f64f29bdd82ce637ccbecb757f17d0c6b00ea2ecdd920","server_seed":null,"seed_revealed":false,"public_seed":"2024111822","round":200566,"message":"2024111822-200566","seed_id":110,"seed_note":"The day's server seed is revealed when the seed rotates at 00:00 UTC; until then only its hash and the public seed are public."}},{"id":200565,"game":"roulette","started_at":"2026-10-03T00:15:01.565115","ended_at":"2026-10-03T00:15:46.565115","result":{"colour":"red","number":4,"multiplier":2},"pot_cents":0,"bets_cents":{"red":0,"green":0,"black":0},"tax_cents":0,"participant_count":0,"participants":[],"fair":{"server_seed_hash":"0e16fc7431a4facd5d1f64f29bdd82ce637ccbecb757f17d0c6b00ea2ecdd920","server_seed":null,"seed_revealed":false,"public_seed":"2024111822","round":200565,"message":"2024111822-200565","seed_id":110,"seed_note":"The day's server seed is revealed when the seed rotates at 00:00 UTC; until then only its hash and the public seed are public."}},"… 47 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/games/{game}/rounds/{round_id}":{"get":{"tags":["games"],"summary":"One finished round with every bet","description":"The same shape as the rounds list plus the full bet detail: roulette participants carry `bets` (per\ncolour, with each skin as `{name, classid, price, amount}`) and `payout_items`; coinflip `creator`/\n`opponent` carry `items`; jackpot `participants` carry `items`; crash has `bet_items` and `payout_items`.\n404 for an unknown id or a round that has not finished (nothing about a round in progress is served).","operationId":"round_detail_games__game__rounds__round_id__get","parameters":[{"name":"game","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Game","description":"roulette, coinflip, jackpot or crash.","examples":["roulette"]},"description":"roulette, coinflip, jackpot or crash."},{"name":"round_id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"The round id (`id` in the rounds list; also `round_id` in /games/me/history).","examples":[196855],"title":"Round Id"},"description":"The round id (`id` in the rounds list; also `round_id` in /games/me/history)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"id":196855,"game":"roulette","started_at":"2026-10-01T01:45:10.333847","ended_at":"2026-10-01T01:45:55.333847","result":{"colour":"black","number":8,"multiplier":2},"pot_cents":4543,"bets_cents":{"red":2567,"green":0,"black":1976},"tax_cents":302,"participant_count":2,"participants":[{"user_id":72,"username":"P3TRYk","avatar":"https://www.hrad.cz/file/edee/2023/03/prezident.jpg","avatar_static":"https://www.hrad.cz/file/edee/2023/03/prezident.jpg","badge":"level","level":null,"bet_cents":2567,"won_cents":0,"colours":["red"],"bets":[{"colour":"red","bet_cents":2567,"items":[{"name":"Forest Raiders Hoodie","classid":"4532464797","price":1976,"amount":1},{"name":"Island Assault Team Chestplate","classid":"7173169503","price":591,"amount":1}]}],"payout_items":[]},{"user_id":35,"username":"federal agent","avatar":"https://shared.fastly.steamstatic.com/community_assets/images/items/3186040/90ce847fef147481b22ec1176254838143dbf383.gif","avatar_static":"https://static.rustprofit.com/static/assets/avatars/90ce847fef147481b22ec1176254838143dbf383.webp","badge":"level","level":null,"bet_cents":1976,"won_cents":3952,"colours":["black"],"bets":[{"colour":"black","bet_cents":1976,"items":[{"name":"Forest Raiders Hoodie","classid":"4532464797","price":1976,"amount":1}]}],"payout_items":[{"name":"Forest Raiders Hoodie","classid":"4532464797","price":1976,"amount":1},{"name":"Forest Raiders Metal Chest Plate","classid":"4518251267","price":1893,"amount":1},{"name":null,"classid":null,"price":83,"amount":1,"is_balance":true}]}],"fair":{"server_seed_hash":"a655dc366c8c14ff82268400a1d064204d88ba5d0af30e74765b8891c2ef095d","server_seed":"169b4017c1e88d45e70bbdd186599221","seed_revealed":true,"public_seed":"211712212","round":196855,"message":"211712212-196855","seed_id":108,"seed_note":null}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/games/{game}/seeds":{"get":{"tags":["games"],"summary":"Revealed seeds of finished rounds, as the site's fairness page lists them","description":"Exactly what each game's own public seeds page returns, 15 per page, newest first - nothing added. Field\nnames are the site's: `server_random` is the revealed server seed, `server_random_hashed` its SHA-256\ncommitment. Roulette lists the daily seed pairs (`public_seed`, `start_roll`/`end_roll` = the round ids\nthe seed covered, `active`; the active day's `server_random` is withheld). Coinflip/jackpot rows carry\n`target_eos_block_hash` and the drawn `ticket`; mines/tower/crash/upgrade rows carry `client_seed` and the\nround's parameters (`mine_count`; `cols_per_row`/`difficulty`; `crash_point`/`cashed_out_at_multiplier`;\n`chance`/`multiplier`/`direction`/`offset`/`roll`) with `win`. `id_` is the round id. Feed a row into\nGET /games/verify (for the seed-pair games use the round's `game_id` from /games/me/history or\n/games/crash/rounds, not `id_`).","operationId":"seeds_games__game__seeds_get","parameters":[{"name":"game","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Game","description":"Any of the seven games.","examples":["mines"]},"description":"Any of the seven games."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page; 15 rows per page (the site's own page size).","default":1,"title":"Page"},"description":"1-based page; 15 rows per page (the site's own page size)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":15,"total":28659,"pages":1911,"results":[{"id_":28659,"server_random":"46699632bbc562646dbc3b57475d2743","server_random_hashed":"e0d673790b571ac2d1230ea3863ed303907b943d0635bfc4b86a304e2bd88f9f","client_seed":"c96fb7251ea7595c","mine_count":9,"win":false,"completed_date":"2026-10-03 00:08:08.393161"},{"id_":28658,"server_random":"5211a129e93e53b0a9ce33fda994e456","server_random_hashed":"425c931192ede6a9427c0d2aa38827b6e83791ebafda361fc2657b9827afb52c","client_seed":"9ac221529c9e7dcd","mine_count":4,"win":true,"completed_date":"2026-10-03 00:07:50.367018"},{"id_":28657,"server_random":"8b0f3b279e416edb89518bf75fbc4cff","server_random_hashed":"9d8bc20b96978bb78085bf48e2badb4e5e08bcefc8c962b41983243e24cc0d91","client_seed":"e8ad0c3030b83a8f","mine_count":1,"win":true,"completed_date":"2026-10-03 00:07:25.340975"},"… 12 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/servers":{"get":{"tags":["servers"],"summary":"Browse, filter and search the server list","description":"One page of servers with the same filters, ordering and five-minute cache as the servers.rustprofit.com\nlist and its hub pages (/country/de, /vanilla, /solo, /gather/2x ...). Each result is the full public server\nrecord: identity and connect details (`ip`, `game_port`, `query_port`, `connect` as a `steam://` URI), `map`,\n`world_seed`, `world_size`, `country`/`country_name`, live `current_players`/`max_players`/`queued_players`,\nthe `kind` (official/modded/vanilla) and `is_*` flags, `password_protected`, `vac_enabled`, `gather_rate` with\nits `gather_bucket`, `group_limit` with its `group` label, `tags`, owner-supplied `description` (first 500\ncharacters), `banner_url`, `website_url`, `discord_url`, `first_seen_at`/`last_seen_at`/`last_polled_at`, the\naggregates `votes`, `rating` (1-5 average, null when unrated) and `last_wipe_at`, and the server's page `url`\nplus embeddable `widget_url`/`badge_url`. Ties in every sort are broken by `id` so pages never overlap.","operationId":"list_servers_servers_get","parameters":[{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":120},{"type":"null"}],"description":"Case-insensitive substring match on the server name.","examples":["rustoria"],"title":"Search"},"description":"Case-insensitive substring match on the server name."},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2,"pattern":"^[A-Za-z]{2}$"},{"type":"null"}],"description":"ISO 3166-1 alpha-2 country the server is hosted in (GeoIP of its address); `/servers/countries` lists the values in use.","examples":["DE"],"title":"Country"},"description":"ISO 3166-1 alpha-2 country the server is hosted in (GeoIP of its address); `/servers/countries` lists the values in use."},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"enum":["vanilla","modded","official"],"type":"string"},{"type":"null"}],"description":"`vanilla` = not modded; `modded` = reports a modded flag over A2S; `official` = a Facepunch-run public server (by name convention).","examples":["vanilla"],"title":"Kind"},"description":"`vanilla` = not modded; `modded` = reports a modded flag over A2S; `official` = a Facepunch-run public server (by name convention)."},{"name":"group","in":"query","required":false,"schema":{"anyOf":[{"enum":["solo","duo","trio"],"type":"string"},{"type":"null"}],"description":"Team-size cap: `solo` (1), `duo` (2) or `trio` (3). Only servers whose cap is known match.","examples":["solo"],"title":"Group"},"description":"Team-size cap: `solo` (1), `duo` (2) or `trio` (3). Only servers whose cap is known match."},{"name":"gather","in":"query","required":false,"schema":{"anyOf":[{"enum":["2x","3x","5x","10x"],"type":"string"},{"type":"null"}],"description":"Gather-rate bucket parsed from the server name: `2x` (2-2.99), `3x` (3-4.99), `5x` (5-9.99) or `10x` (10 and above). Servers with no `Nx` in their name never match.","examples":["2x"],"title":"Gather"},"description":"Gather-rate bucket parsed from the server name: `2x` (2-2.99), `3x` (3-4.99), `5x` (5-9.99) or `10x` (10 and above). Servers with no `Nx` in their name never match."},{"name":"monument","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}],"description":"Only servers whose current map (when a preview has been generated) contains this monument type, exactly as `/servers/monument-types` lists it.","examples":["Launch Site"],"title":"Monument"},"description":"Only servers whose current map (when a preview has been generated) contains this monument type, exactly as `/servers/monument-types` lists it."},{"name":"biome","in":"query","required":false,"schema":{"anyOf":[{"enum":["snow","desert","forest","tundra","jungle"],"type":"string"},{"type":"null"}],"description":"Only servers whose generated map preview is mostly this biome (its percentage is the highest of the five).","examples":["snow"],"title":"Biome"},"description":"Only servers whose generated map preview is mostly this biome (its percentage is the highest of the five)."},{"name":"min_players","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":10000,"minimum":1},{"type":"null"}],"description":"Only servers with at least this many players online right now.","examples":[50],"title":"Min Players"},"description":"Only servers with at least this many players online right now."},{"name":"min_rating","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":5,"minimum":1},{"type":"null"}],"description":"Only servers whose average community rating (1-5) is at least this.","examples":[4],"title":"Min Rating"},"description":"Only servers whose average community rating (1-5) is at least this."},{"name":"online","in":"query","required":false,"schema":{"type":"boolean","description":"`true` (default) = only servers that were online at their last poll; `false` = only servers currently marked offline.","default":true,"title":"Online"},"description":"`true` (default) = only servers that were online at their last poll; `false` = only servers currently marked offline."},{"name":"sort","in":"query","required":false,"schema":{"enum":["players","votes","rating","wiped","name"],"type":"string","description":"`players` = most players online first (default); `votes` = most community votes; `rating` = highest average rating; `wiped` = most recently wiped; `name` = alphabetical.","examples":["players"],"default":"players","title":"Sort"},"description":"`players` = most players online first (default); `votes` = most community votes; `rating` = highest average rating; `wiped` = most recently wiped; `name` = alphabetical."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number.","default":1,"title":"Page"},"description":"1-based page number."},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page (max 200).","default":50,"title":"Per Page"},"description":"Results per page (max 200)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"page":1,"per_page":50,"total":0,"pages":1,"results":[]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/servers/top":{"get":{"tags":["servers"],"summary":"Most populated servers right now","description":"The online servers with the most players right now - the same query behind the rust.wiki Discord bot's\n`/servers` command - as a compact list: `id`, `name`, `players`, `max_players`, `country` and the server's page\n`url`. Use `/servers?sort=players` for the full records. Cached for 60 seconds.","operationId":"top_servers_top_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2,"pattern":"^[A-Za-z]{2}$"},{"type":"null"}],"description":"Restrict to one ISO 3166-1 alpha-2 country.","examples":["US"],"title":"Country"},"description":"Restrict to one ISO 3166-1 alpha-2 country."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"How many servers to return (1-50).","examples":[10],"default":10,"title":"Limit"},"description":"How many servers to return (1-50)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"country":"US","total":10,"results":[{"id":8346,"name":"Atlas - US 2X Monthly | Vanilla+ | No BP Wipes","players":884,"max_players":950,"country":"US","url":"https://servers.rustprofit.com/server/8346"},{"id":8973,"name":"Rustoria.co - US Long Premium","players":632,"max_players":650,"country":"US","url":"https://servers.rustprofit.com/server/8973"},{"id":8261,"name":"Atlas - US 2X Monthly Solo/Duo/Trio/Quad | Vanilla+ | No BP Wip","players":547,"max_players":575,"country":"US","url":"https://servers.rustprofit.com/server/8261"},"… 7 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/servers/leaderboard":{"get":{"tags":["servers"],"summary":"Community leaderboard by votes or rating","description":"Online servers ranked by Steam-authenticated community votes (one per user per server per day) or by\naverage 1-5 rating - the ranking behind servers.rustprofit.com/best-rust-servers and /leaderboard?by=rating.\nOnly servers with at least one vote (or rating) appear. Each entry is the full server record plus `rank`,\n`votes`, `rating` and `last_wipe_at`. Cached for five minutes.","operationId":"leaderboard_servers_leaderboard_get","parameters":[{"name":"by","in":"query","required":false,"schema":{"enum":["votes","rating"],"type":"string","description":"`votes` = most community votes (the site's Best Rust Servers page); `rating` = highest average rating, votes as tiebreaker.","examples":["votes"],"default":"votes","title":"By"},"description":"`votes` = most community votes (the site's Best Rust Servers page); `rating` = highest average rating, votes as tiebreaker."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"How many servers to return (1-100); the site shows 50.","examples":[50],"default":50,"title":"Limit"},"description":"How many servers to return (1-100); the site shows 50."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"by":"votes","total":10,"results":[{"rank":1,"id":149,"name":"EU | Helli's Aimtrain | Facechecks/1v1/Speargun/Hellis","…":"37 more keys"},{"rank":2,"id":348,"name":"UKN.GG - EU Training Grounds - Main","…":"37 more keys"},{"rank":3,"id":354,"name":"Rustafied.com - EU Trio - Monday","…":"37 more keys"},"… 7 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/servers/wipes":{"get":{"tags":["servers"],"summary":"Recently wiped servers","description":"Wipes detected across every online server in the window, newest first - the feed behind\nservers.rustprofit.com/wipes. A wipe is detected when a server's `world_seed` or `world_size` changes between\ntwo polls, or when the last-wipe time it advertises moves past our previous poll (for servers with A2S rules\ndisabled). Each entry has `detected_at`, the old and new seed/size, and the full server record. Expect\nthousands of entries in the 24 hours after Rust's monthly forced wipe (first Thursday). Cached for five minutes.","operationId":"recent_wipes_servers_wipes_get","parameters":[{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":168,"minimum":1,"description":"Look-back window in hours (1-168). The site's /wipes page shows 24.","examples":[24],"default":24,"title":"Hours"},"description":"Look-back window in hours (1-168). The site's /wipes page shows 24."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number.","default":1,"title":"Page"},"description":"1-based page number."},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Results per page (max 200).","default":50,"title":"Per Page"},"description":"Results per page (max 200)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"hours":24,"page":1,"per_page":50,"total":2418,"pages":49,"results":[{"detected_at":"2026-10-03T00:15:34.605360","previous_seed":"1787961720","new_seed":"1790985721","previous_size":6000,"new_size":6000,"server":{"id":1445888,"name":"nomarust LL | JP | Vanilla | Monthly","ip":"160.16.60.191","…":"33 more keys"}},{"detected_at":"2026-10-03T00:15:34.605360","previous_seed":"834583388","new_seed":"834583388","previous_size":3000,"new_size":3000,"server":{"id":3157,"name":"[UA/EU]AFTER WORK MAIN X2|Vanilla|","ip":"116.202.39.45","…":"33 more keys"}},{"detected_at":"2026-10-02T23:59:44.265482","previous_seed":"1337","new_seed":"1337","previous_size":3700,"new_size":4500,"server":{"id":1450507,"name":"My Untitled Rust Server","ip":"77.42.34.243","…":"33 more keys"}},"… 47 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/servers/stats":{"get":{"tags":["servers"],"summary":"Site-wide totals and data freshness","description":"The headline numbers from the servers.rustprofit.com homepage: `online_servers`, `total_players` and\n`queued_players` summed across every online server, `tracked_servers` (every row ever discovered, offline\nincluded), `steam_global_players` (Rust's concurrent player count from Steam, null if Steam did not answer),\n`next_force_wipe_at` (the first Thursday of the month at 2 PM US Eastern: 18:00 UTC during US daylight saving time, 19:00 UTC otherwise), the poller's\nconfiguration (`poll_interval_seconds` between cycles, `offline_after_seconds` before an unanswering server\nis marked offline, `snapshot_retention_days` of per-server history kept) and `workers` - the live heartbeat\nstatus of the discovery, polling and map-generation jobs, so you can tell how fresh the data is.","operationId":"stats_servers_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"online_servers":25746,"total_players":102923,"queued_players":206,"tracked_servers":35512,"steam_global_players":99993,"next_force_wipe_at":"2026-11-05T19:00:00","poll_interval_seconds":300,"offline_after_seconds":1800,"snapshot_retention_days":7,"workers":[{"name":"rustservers_discovery","label":"Rust Server Discovery","status":"ok","last_seen":"2026-10-02T23:25:53.056636","seconds_ago":3085,"expected_interval":7200},{"name":"rustservers_poller","label":"Rust Server Poller","status":"stale","last_seen":"2026-10-02T22:34:32.195587","seconds_ago":6166,"expected_interval":4800},{"name":"rustservers_mapgen","label":"Rust Map Generator","status":"ok","last_seen":"2026-10-03T00:10:24.632751","seconds_ago":414,"expected_interval":3600}],"generated_at":"2026-10-03T00:17:18.255460"}}}}}}},"/servers/stats/history":{"get":{"tags":["servers"],"summary":"Site-wide player and server counts over time","description":"The homepage chart's data: parallel arrays `labels` (UTC ISO-8601 bucket start), `players` (players online\nacross all tracked servers), `queued` (players in queues) and `servers` (servers online). Each hourly point is\nthe reading from the poll cycle that landed last in that hour; daily points average the hours. Cached for 15\nminutes.","operationId":"stats_history_servers_stats_history_get","parameters":[{"name":"range","in":"query","required":false,"schema":{"enum":["24h","7d","31d","1y"],"type":"string","description":"`24h` and `7d` return one point per hour; `31d` and `1y` return one averaged point per day.","examples":["7d"],"default":"24h","title":"Range"},"description":"`24h` and `7d` return one point per hour; `31d` and `1y` return one averaged point per day."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"range":"7d","labels":["2026-09-26T01:00:00","2026-09-26T02:00:00","2026-09-26T03:00:00","… 117 more"],"players":[69486,63264,59729,"… 117 more"],"queued":[105,65,32,"… 117 more"],"servers":[27115,27113,27086,"… 117 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/servers/countries":{"get":{"tags":["servers"],"summary":"Countries with online servers, with counts","description":"Every country (ISO 3166-1 alpha-2) that currently hosts at least one online server - the values accepted\nby the `country` filter of `/servers` and `/servers/top` - with `name`, the number of online `servers` and\ntheir summed `players`, most servers first, and the country hub page `url`. Cached for five minutes.","operationId":"countries_servers_countries_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"total":120,"results":[{"country":"RU","name":"Russia","servers":5318,"players":17710,"url":"https://servers.rustprofit.com/country/ru"},{"country":"US","name":"United States","servers":5094,"players":27126,"url":"https://servers.rustprofit.com/country/us"},{"country":"DE","name":"Germany","servers":2991,"players":5769,"url":"https://servers.rustprofit.com/country/de"},"… 117 more"]}}}}}}},"/servers/monument-types":{"get":{"tags":["servers"],"summary":"Monument types present on generated maps","description":"The distinct monument type names found across every generated map preview (RustMaps data, e.g. `Launch\nSite`, `Oil Rig`), alphabetical - the values accepted by the `monument` filter of `/servers`. Grows on its\nown as more maps are generated. Cached for 15 minutes.","operationId":"monument_types_servers_monument_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"total":101,"results":["3 Wall Rock","Airfield","Anvil Rock","… 98 more"]}}}}}}},"/servers/{server_id}":{"get":{"tags":["servers"],"summary":"One server in full","description":"Everything the server's page shows except the live player names: the full public record (see `/servers`)\nread fresh, plus `votes`, `rating` (1-5 average) and `rating_count`, the last ten detected `wipes` (newest\nfirst, with the seed/size before and after), `last_wipe_at`, `avg_wipe_cycle_hours` across those wipes,\n`next_wipe_estimate_at` (last wipe + average cycle; a guess, not a schedule), `next_force_wipe_at` (Rust's\nmonthly forced wipe) and `map_preview` - null until a RustMaps render exists for the server's seed/size,\notherwise `image_url`, `thumbnail_url`, `total_monuments`, `monuments` (`{type, x, y}`), `monument_types`,\n`land_percentage` and the five `biome_*` percentages. Offline servers still resolve; unknown ids are 404.\nPlayer-count history is at `/servers/{id}/history`. Aggregates are cached for five minutes.","operationId":"server_detail_servers__server_id__get","parameters":[{"name":"server_id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"The server's numeric id (from `/servers`, or the number in its servers.rustprofit.com/server/{id} URL).","examples":[1],"title":"Server Id"},"description":"The server's numeric id (from `/servers`, or the number in its servers.rustprofit.com/server/{id} URL)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"id":1,"name":"My Rust Server","ip":"85.190.100.68","game_port":28015,"query_port":28017,"connect":"steam://connect/85.190.100.68:28015","map":"Procedural Map","world_seed":"1234567","world_size":3000,"country":"DE","country_name":"Germany","current_players":0,"…":"33 more keys"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/servers/{server_id}/history":{"get":{"tags":["servers"],"summary":"Player-count history for one server","description":"The per-poll `player_count`/`queued_count` readings behind the server page's 24-hour chart, oldest first,\nas `points` of `{t, players, queued}`. One reading lands per poll cycle (roughly hourly); when the window\nholds more than 500 readings they are averaged into equal time buckets (`resolution_seconds`, null when the\npoints are raw) so a response never exceeds 500 points. Also `peak_players`, `avg_players` and `point_count`.\nA server that has never answered a poll has an empty series. Cached for five minutes.","operationId":"server_history_servers__server_id__history_get","parameters":[{"name":"server_id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"The server's numeric id.","examples":[1],"title":"Server Id"},"description":"The server's numeric id."},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":1,"description":"How many days back to return (1-30). Snapshots are pruned nightly to the configured retention window (7 days by default - see `snapshot_retention_days` on `/servers/stats`), so longer ranges come back only as far as the table holds.","examples":[7],"default":1,"title":"Days"},"description":"How many days back to return (1-30). Snapshots are pruned nightly to the configured retention window (7 days by default - see `snapshot_retention_days` on `/servers/stats`), so longer ranges come back only as far as the table holds."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"server_id":1,"days":7,"resolution_seconds":null,"point_count":0,"sample_count":0,"peak_players":null,"avg_players":null,"points":[]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/servers/{server_id}/votes":{"get":{"tags":["servers"],"summary":"Community vote counts per day for one server","description":"How many Steam-authenticated votes the server received on each UTC day (`daily` as `{date, votes}`, oldest\nfirst, days with no votes included as zero), plus `votes_in_range` and the all-time `total_votes`. Votes are\none per user per server per day; who cast them is never exposed. Ratings are a separate 1-5 score, see\n`rating`/`rating_count` on `/servers/{id}`. Cached for five minutes.","operationId":"server_votes_servers__server_id__votes_get","parameters":[{"name":"server_id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"The server's numeric id.","examples":[1],"title":"Server Id"},"description":"The server's numeric id."},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"How many UTC days back to return (1-365), today included.","examples":[30],"default":30,"title":"Days"},"description":"How many UTC days back to return (1-365), today included."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"server_id":1,"days":30,"total_votes":0,"votes_in_range":0,"daily":[{"date":"2026-09-04","votes":0},{"date":"2026-09-05","votes":0},{"date":"2026-09-06","votes":0},"… 27 more"]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/status/data":{"get":{"tags":["status"],"summary":"When each dataset last changed and how often it refreshes","description":"The quota-saver: for every dataset the API serves, `updated_at` (the newest timestamp actually in the\ntable, UTC) and `refresh_seconds` (how often it can change), with the endpoints it feeds. Poll this cheap\nendpoint and only re-fetch a heavy payload such as /market/prices or /servers when its dataset's `updated_at`\nhas moved; cache reference data (items, monuments, ...) locally since it only changes with Facepunch's monthly\npatch. Timestamps are read live from the database and cached for 60 seconds.","operationId":"status_data_status_data_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"checked_at":"2026-10-03T00:17:18Z","advice":"Re-fetch a dataset's endpoints only after its updated_at moves; most change far less often than you'd poll. GET /me is free and shows your remaining quota.","datasets":[{"key":"steam_prices","name":"Steam order books / canonical prices","updated_at":"2026-10-03T00:16:32Z","seconds_since_update":46,"refresh_seconds":720,"note":"Each skin's Steam order book is re-read about every 12 minutes; /market/prices is regenerated from them at most every 5 minutes.","endpoints":["/market/prices","/market/prices/{itemdefid}","/skins/{itemdefid}/orderbook","… 5 more"]},{"key":"steam_sale_history","name":"Steam sale history","updated_at":"2026-10-03T00:16:33Z","seconds_since_update":45,"refresh_seconds":21600,"note":"Steam's own sale-history series is scraped on a rolling ~6h cycle; a skin's series changes at most a few times a day.","endpoints":["/skins/{itemdefid}/history","/market/index","/market/compare","… 2 more"]},{"key":"marketplaces","name":"Third-party marketplace prices","updated_at":"2026-10-03T00:12:11Z","seconds_since_update":307,"refresh_seconds":300,"note":"Each marketplace is polled every ~5 minutes; a row's fetched_at moves only when its price changes.","endpoints":["/market/marketplaces","/market/deals","/skins/{itemdefid}"]},"… 8 more"]}}}}}}},"/status":{"get":{"tags":["status"],"summary":"Network status: every site and its workers at a glance","description":"One call for the whole network: each site's HTTPS probe (`ok`, HTTP status, latency, cached 60s) and a\ncount of its background workers by health, plus an overall `all_ok`. Use /status/workers for per-worker detail.","operationId":"status_overview_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"checked_at":"2026-10-03T00:17:18Z","all_ok":false,"sites":[{"key":"casino","name":"RustProfit","url":"https://rustprofit.com","ok":true,"http_status":200,"latency_ms":101,"workers":{"ok":12,"stale":0,"unknown":0,"total":12}},{"key":"wiki","name":"rust.wiki","url":"https://rust.wiki","ok":true,"http_status":200,"latency_ms":92,"workers":{"ok":19,"stale":0,"unknown":0,"total":19}},{"key":"servers","name":"Rust Servers","url":"https://servers.rustprofit.com","ok":true,"http_status":200,"latency_ms":103,"workers":{"ok":3,"stale":1,"unknown":0,"total":4}},"… 2 more"]}}}}}}},"/status/sites":{"get":{"tags":["status"],"summary":"HTTPS reachability of each site","description":"Probes rustprofit.com, rust.wiki, servers.rustprofit.com, rust.wiki/inventory and blog.rustprofit.com\nfrom the web tier and reports `ok`, `http_status` and `latency_ms` for each. Results are shared across callers\nand refreshed at most once a minute.","operationId":"status_sites_status_sites_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"checked_at":"2026-10-03T00:17:18Z","sites":[{"key":"casino","name":"RustProfit","url":"https://rustprofit.com","ok":true,"http_status":200,"latency_ms":101},{"key":"wiki","name":"rust.wiki","url":"https://rust.wiki","ok":true,"http_status":200,"latency_ms":92},{"key":"servers","name":"Rust Servers","url":"https://servers.rustprofit.com","ok":true,"http_status":200,"latency_ms":103},"… 2 more"]}}}}}}},"/status/workers":{"get":{"tags":["status"],"summary":"Background worker heartbeats, grouped by site","description":"Every public background worker with `status` (ok / stale / unknown), `last_seen` (UTC), `seconds_ago` and\nits `expected_interval` - the cadence past which it counts as stale. Grouped by the site whose data it keeps\nfresh: game loops, trade bots and payouts for the casino; price, marketplace, store, workshop and news pollers\nfor the wiki; discovery and polling for the server directory; the inventory backfill and leaderboard warmer.","operationId":"status_workers_status_workers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"checked_at":"2026-10-03T00:17:19Z","summary":{"ok":36,"stale":1,"unknown":0,"total":37},"sites":{"casino":{"summary":{"ok":12,"stale":0,"unknown":0,"total":12},"workers":[{"name":"roulette","label":"Roulette Roller","status":"ok","last_seen":"2026-10-03T00:17:16.854510","seconds_ago":2,"expected_interval":90},{"name":"coinflip","label":"Coinflip Roller","status":"ok","last_seen":"2026-10-03T00:17:08.428193","seconds_ago":11,"expected_interval":90},{"name":"jackpot","label":"Jackpot Roller","status":"ok","last_seen":"2026-10-03T00:17:13.584273","seconds_ago":5,"expected_interval":90},"… 9 more"]},"wiki":{"summary":{"ok":19,"stale":0,"unknown":0,"total":19},"workers":[{"name":"steam_price_history","label":"Steam Orderbook / Price History Poller","status":"ok","last_seen":"2026-10-03T00:16:33.015393","seconds_ago":46,"expected_interval":1500},{"name":"rust_store_poller","label":"Rust Item Store Poller","status":"ok","last_seen":"2026-10-03T00:17:06.090509","seconds_ago":13,"expected_interval":1200},{"name":"wiki_workshop_poller","label":"Wiki Workshop Poller","status":"ok","last_seen":"2026-10-03T00:17:03.959017","seconds_ago":15,"expected_interval":300},"… 16 more"]},"servers":{"summary":{"ok":3,"stale":1,"unknown":0,"total":4},"workers":[{"name":"rustservers_discovery","label":"Rust Server Discovery","status":"ok","last_seen":"2026-10-02T23:25:53.056636","seconds_ago":3086,"expected_interval":7200},{"name":"rustservers_poller","label":"Rust Server Poller","status":"stale","last_seen":"2026-10-02T22:34:32.195587","seconds_ago":6167,"expected_interval":4800},{"name":"rustservers_mapgen","label":"Rust Map Generator","status":"ok","last_seen":"2026-10-03T00:10:24.632751","seconds_ago":414,"expected_interval":3600},"… 1 more"]},"inventory":{"summary":{"ok":2,"stale":0,"unknown":0,"total":2},"workers":[{"name":"inventory_holdings_backfill","label":"Inventory Holdings Backfill","status":"ok","last_seen":"2026-10-03T00:13:14.474158","seconds_ago":245,"expected_interval":720},{"name":"inventory_leaderboard_warmer","label":"Inventory Leaderboard Cache Warmer","status":"ok","last_seen":"2026-10-03T00:09:28.233263","seconds_ago":471,"expected_interval":4500}]},"blog":{"summary":{"ok":0,"stale":0,"unknown":0,"total":0},"workers":[]}}}}}}}}},"/funds/leaderboard":{"get":{"tags":["funds"],"summary":"Public funds ranked by total value","description":"All public funds that have traded at least once, ranked by current total value (cash + holdings at\nlive wiki prices). `starting_cash` is the $1,000 every fund begins with. Cached for 120 seconds.","operationId":"leaderboard_funds_leaderboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"starting_cash":100000,"funds":[],"rules":{"starting_cash":100000,"sell_fee_bps":500}}}}}}}},"/funds/{steamid}":{"get":{"tags":["funds"],"summary":"One public fund with positions and full trade ledger","description":"Cash, holdings value, total value, P&L, every open position with average cost, the complete trade history\n(newest first) and the daily value series. Private funds return 403.","operationId":"fund_funds__steamid__get","parameters":[{"name":"steamid","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{17}$","description":"SteamID64 of the fund owner.","examples":["76561198869732295"],"title":"Steamid"},"description":"SteamID64 of the fund owner."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Game":{"type":"string","enum":["roulette","coinflip","jackpot","crash","mines","tower","upgrade"],"title":"Game"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HistorySort":{"type":"string","enum":["newest","amount_desc","amount_asc"],"title":"HistorySort"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Create a key at https://rust.wiki/api-keys. Also accepted as `Authorization: Bearer rw_live_…` or `?api_key=`."}}},"tags":[{"name":"account","description":"Your own API key: what it is, how much of each daily quota it has used today and when the quotas reset. Calls here are free - they are never counted against any limit.","x-daily-quota":null},{"name":"items","description":"The complete Rust item catalogue (~930 items) as seeded from wiki.facepunch.com and Steam's official item definitions: display name, shortname (the exact string Rust's `give` / `inventory.giveto` console commands expect), category, stack size, despawn time, icon, crafting recipe, blueprint and scrap research costs, recycler yields (standard and safe-zone recycler), repair costs, every loot source with drop chance, reverse 'used in' lookups, and the item's skins priced at the canonical wiki price (Steam's lowest sell order, integer USD cents, refreshed about every 12 minutes). The game data itself only changes when Facepunch patches; responses are cached server-side for 15 minutes.","x-daily-quota":25000},{"name":"skins","description":"Every Rust skin (about 6,500: weapon, clothing, deployable and decoration skins, drops and DLC) with the same live price the wiki shows: the canonical wiki price is Steam Community Market's lowest sell order, falling back to the highest buy order only when nothing is listed, refreshed every few minutes by our own Steam scraper. Prices are integer USD cents. Sale history is Steam's own median-sale-price series (hourly for the recent window, daily beyond it); holders come from inventories scanned by the rust.wiki/inventory lookup, not a census of the game. Browse and detail payloads are cached 2 and 15 minutes respectively.","x-daily-quota":25000},{"name":"market","description":"Market data for Rust skins. Canonical prices are Steam Community Market's lowest sell order (highest buy order when nothing is listed), from our own Steam scraper, in integer USD cents; third-party marketplace prices (Skinport, DMarket, CS.Deals, Waxpeer, LIS-Skins, Mannco, Tradeit, RustSkins and more) are polled every ~5 minutes. Analytics are the site's own: the equal- or market-cap-weighted market index and compare series built from Steam's daily price history back to 2015, executable 3rd-party-to-Steam deals net of Steam's 15% fee, market cap (price x Workshop subscribers as the supply proxy), and insights. Caches range from 5 minutes (prices, deals) to 24 hours (index/compare series, which only gain a point every 6 hours).","x-daily-quota":10000},{"name":"charts","description":"Ready-made PNG charts (dark site style, 792x412) for skin price history (line or candlestick), market indexes, collection value and multi-skin comparisons - the same images the rust.wiki Discord bot posts. Series come from Steam Community Market history; images are cached for 15 minutes. Use the JSON endpoints under /skins and /market when you want the numbers instead.","x-daily-quota":2000},{"name":"store","description":"Rust's official in-game item store (the Steam item store for app 252490): the current weekly rotation, the permanent catalogue and DLC packs, plus every past rotation back to July 2015 (over 500). Store prices are what Facepunch charges, in integer USD cents; `market_price` is the skin's canonical wiki price on Steam Community Market, also cents. New rotations are detected from Steam's storefront within the hour and land every Thursday; payloads are cached 30-60 minutes.","x-daily-quota":10000},{"name":"workshop","description":"The complete Steam Workshop archive of Rust skin submissions (~158,000 and growing, every item tagged 'Skin'), polled incrementally every few minutes so new uploads appear within minutes: title, author SteamID64, preview image, submission time, the target item as Steam tags it, subscriber count, vote score, and whether Facepunch accepted it into the game (with the in-game `accepted_itemdefid` that links to /skins). Search is a plain case-insensitive substring match on the title. Results are cached for 15 minutes.","x-daily-quota":10000},{"name":"reference","description":"Static Rust reference data and site utilities: 3,500+ console commands with syntax, defaults and admin permission; give-command item shortnames; the 60 fixed monuments (tier, safe zone, radiation, recyclers, tunnel/Chinook/heli flags); 86 loot tables with per-item drop chance, amount and condition; CCTV camera codes; 200 world entities (animals, NPCs, resource nodes) with HP and loot; every building piece with health, decay, build/repair/upkeep costs and time-to-destroy by weapon; the four tech trees with prerequisite edges; design notes paraphrased from The Art of Rust; the craft, recycle and blueprint calculator datasets, the raid cost table and the upkeep decay constants, plus computed answers from the same calculators (raw materials to craft a list, recycle yields, explosives to raid a set of pieces, a base's daily upkeep, the best plant crossbreeding layout); a search over the RustProfit blog's Rust guides; current Twitch and Kick drops; Facepunch's update feed; and the USD exchange rates the site prices with. Game data only changes when Facepunch patches and is cached server-side for 30-60 minutes (the raid table for a day); updates and rates are near-live (worker freshness lives under /status).","x-daily-quota":25000},{"name":"players","description":"Rust player profiles and in-game statistics, fetched live from the official Steam Web API and cached for ten minutes. In-game stats and achievements are only available when the Steam profile's 'Game details' privacy setting is public (`stats_private` tells you). Bans are reported as Steam reports them; Rust EAC bans appear as game bans.","x-daily-quota":2000},{"name":"inventory","description":"Rust skin inventories of any public Steam account, valued at the canonical wiki price (Steam lowest sell order, falling back to highest buy order): every skin with quantity, price and value, totals, a category breakdown and a one-year value history. A read is served from the stored snapshot for 24 hours; `refresh=true` forces a live Steam read (limited per key per day). Values are USD cents, except `value_history`, which is USD dollars at each day's Steam sale price (so its latest point can sit below `total_value`, which uses current asks). Also the inventory leaderboard and daily snapshots.","x-daily-quota":1000},{"name":"games","description":"The rustprofit.com Rust-skin casino as data: every finished round of the public games (roulette, coinflip, jackpot, crash) with pot, result, participants as the site shows them and the provably-fair seeds the site reveals for finished rounds; the per-game seed pages; a pure verifier that recomputes any outcome from its seeds; and the fairness scheme itself. All amounts are integer USD cents (skin values at deposit time). The `/games/me/...` endpoints return the API key owner's OWN rustprofit.com account history, stats and client seed - never anyone else's.","x-daily-quota":10000},{"name":"servers","description":"The Rust server directory from servers.rustprofit.com: ~26,000 community and official servers discovered through Valve's master server list and re-queried over Steam's A2S protocol every poll cycle (roughly hourly at the current table size), with per-server player-count history, detected wipes (seed/size changes), community votes and ratings, map previews with monuments and biomes, and site-wide totals. `is_online` is true while a server keeps answering its polls, `last_seen_at` is the last answer, `last_polled_at` the last attempt, and `last_seen_at: null` means Steam lists the server but it has never answered us (no history, wipes or map). `gather_rate` and `is_official` are parsed from the server name by community convention, not reported by the game. Owner contact details, claim identities and voter identities are never exposed. Site-wide totals refresh with every poll cycle; most other responses are cached for five minutes.","x-daily-quota":10000},{"name":"status","description":"Live health for the whole RustProfit network - rustprofit.com, rust.wiki, servers.rustprofit.com, rust.wiki/inventory (formerly inventory.rustprofit.com) and blog.rustprofit.com - plus the freshness of every background worker that keeps their data current (price scrapers, marketplace pollers, store/workshop/news pollers, game loops, trade bots). Use /status/data to see WHEN each dataset last changed and how often it refreshes, and only re-fetch the heavy endpoints after that timestamp moves: it saves your quota and our servers. Site probes are cached for 60 seconds; worker heartbeats and dataset timestamps are read live.","x-daily-quota":10000},{"name":"funds","description":"rust.wiki paper-trading funds: every signed-in user can run a public $1,000 fund of skin picks whose trades are an append-only ledger priced at the canonical wiki price at execution. Read-only here; values in USD cents.","x-daily-quota":5000}],"security":[{"ApiKey":[]}],"x-quotas":{"per_day":{"items":25000,"skins":25000,"market":10000,"store":10000,"workshop":10000,"reference":25000,"players":2000,"inventory":1000,"charts":2000,"games":10000,"servers":10000,"status":10000,"funds":5000},"burst_per_minute":300,"labels":{"items":"Items","skins":"Skins","market":"Market & prices","store":"Item store","workshop":"Workshop","reference":"Reference data","players":"Player stats","inventory":"Inventories","charts":"Charts","games":"Casino games","servers":"Rust servers","status":"Network status","funds":"Paper funds"}},"x-key-management":"https://rust.wiki/api-keys","x-llms-txt":"https://rust.wiki/llms.txt"}