https://rust.wiki/mcp

servidor rust.wiki

Documentação

rust.wiki API: a free Rust API for skins, prices, items, servers and player stats

Everything on rust.wiki as JSON. 221 endpoints cover every Rust skin with its live Steam Community Market price and third-party marketplace prices, sale history, deals, the market index and market cap; every Rust item with recipes, recycle yields, blueprints and loot sources; the weekly item store and its history; the Steam Workshop; monuments, loot tables, console commands, CCTV codes, world entities, building pieces, the tech tree and calculators; Facepunch updates; the Rust server directory; Rust player stats from the official Steam Web API; Steam inventory valuations; rustprofit.com casino rounds with provably-fair data; rendered PNG charts; and live network status. Base URL https://rust.wiki/api/v1.

[!success] Success This API is free. No cost, no credit card, no paid tiers and no trial that expires. Sign in with Steam, create a key, and every endpoint is yours within the daily quotas below. The only ask is a visible link back to rust.wiki from whatever you build.

Getting started

  1. Sign in with Steam and create a key. It's free and takes ten seconds; you can hold up to 5 keys.
  2. Send the key as an X-API-Key header on every request to https://rust.wiki/api/v1.
  3. Read the response as JSON. Prices are USD cents, timestamps are UTC.
  4. Check what you have left any time with GET /me; it is never counted against your quota.
curl -H "X-API-Key: rw_live_YOUR_KEY" \
  "https://rust.wiki/api/v1/skins/search?q=tempered"
import requests
r = requests.get("https://rust.wiki/api/v1/market/prices",
                 headers={"X-API-Key": "rw_live_YOUR_KEY"})
prices = r.json()["prices"]   # {market_hash_name: {...}}
const r = await fetch("https://rust.wiki/api/v1/servers/top?limit=5",
  { headers: { "X-API-Key": "rw_live_YOUR_KEY" } });
const { results } = await r.json();

What people build with it

  • Rust skin price trackers and Discord bots: /market/prices for the whole catalogue in one call, /skins/{id}/history and /charts/price/{id}.png for the chart.
  • Trading and arbitrage tools: /market/deals, /market/marketplaces and /skins/{id}/orderbook.
  • Server browsers and status widgets: /servers with every filter the directory has, /servers/{id}/history for player counts.
  • Player and inventory lookups: /players/{steamid} for Rust stats and achievements, /inventory/{steamid} for a valued inventory.
  • Provably-fair verifiers: /games/{game}/rounds, /games/{game}/seeds and /games/verify.
  • AI assistants: add the rust.wiki MCP server (https://rust.wiki/mcp, no key needed), or point agents at /openapi.json or /llms.txt.

Authentication

X-API-Key: rw_live_… (recommended)

Works from any client, including browsers (the API allows cross-origin GETs).

Authorization: Bearer rw_live_…

Same thing for HTTP libraries that only know bearer tokens.

?api_key=rw_live_…

Query-string fallback for tools that can't set headers. Avoid it where you can: URLs end up in logs.

A missing, malformed, unknown or revoked key returns 401 with a JSON {"error": "…"} body. Keys never expire; revoke them on the keys page. Only a hash of each key is stored, so a lost key can't be recovered: create a new one.

Quotas & limits

The API is free; quotas are the only limit. Each key gets a separate daily quota per category (reset at 00:00 UTC) and a burst limit of 300 requests per minute across everything. They're sized so a real application never notices them; they exist so one runaway loop can't slow the site for everyone else. GET /me shows your key's used and remaining numbers for today and is never counted.

CategoryRequests / day
Account accountnot counted
Items items25,000
Skins skins25,000
Market & prices market10,000
Charts charts2,000
Item store store10,000
Workshop workshop10,000
Reference data reference25,000
Player stats players2,000
Inventories inventory1,000
Casino games games10,000
Rust servers servers10,000
Network status status10,000
Paper funds funds5,000

Every response carries X-RateLimit-Category, X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (seconds until the daily reset). Over either limit you get 429 with a Retry-After header. Need more? Ask; quotas are a dial, not a wall.

Conventions

  • Money is integer USD cents unless the field name says otherwise (e.g. usd). The canonical wiki price of a skin is Steam's lowest sell order, falling back to the highest buy order when nothing is listed; third-party marketplace prices are reported separately.
  • Timestamps are UTC ISO-8601 strings.
  • Lists paginate with page (1-based) and per_page (max 200) and return {"page", "per_page", "total", "pages", "results": [...]}.
  • Identifiers: items use their Rust shortname (e.g. rifle.ak), skins their Steam itemdefid, players a 17-digit SteamID64, monuments/world/building their URL slug.
  • Errors are JSON {"error", "status"}: 404 for unknown resources, 422 for invalid parameters (with details), 401 for key problems, 429 for limits.
  • Freshness: most data is refreshed server-side every 5-30 minutes (Steam prices about every 12 minutes, marketplaces every 5, the store when it rotates). Polling faster than that only spends quota.
  • Compression: send Accept-Encoding: gzip, br; the bulk price endpoints are large.
  • Spend less quota: GET /status/data reports when every dataset last changed and how often it can change. Poll that (it's cheap) and only re-fetch a heavy payload such as /market/prices or /servers when its updated_at has moved; cache reference data (items, monuments, loot tables, commands) locally, since it only changes with Facepunch's monthly patch. GET /me shows what you have left and is never counted.

Account

category account · never counted

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.

GET/mecopy URL

Your key's usage and remaining quota for today

Returns the key's name and prefix, the SteamID64 of the account that owns it, and for every category the daily `limit`, `used` and `remaining` counts (UTC day), plus the per-minute burst window, the forced inventory-refresh allowance and `resets_in_seconds`. This call is not counted against any quota, so poll it freely. Every other response also carries the same numbers for its own category in the `X-RateLimit-*` headers.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/me"

Example response

{
  "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

category items · 25,000 requests/day

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.

GET/itemscopy URL

Browse or search the item catalogue

One page of live items (seasonal, obsolete and unreleased items are excluded from browsing but still resolve by shortname). Each result carries `shortname`, `display_name`, `category`, `icon_url` and `is_craftable`; fetch `/items/{shortname}` for everything else. Same ordering and cache as the /items page on the site (15 minutes).

ParameterInTypeDefaultDescription
categoryqueryone of `weapon`, `construction`, `general`, `resource`, `attire`, `tool`, `medical`, `food`, `ammo`, `trap`, `component`, `electrical`, `fun`, `misc`Restrict to one of the 14 wiki.facepunch.com item categories.
searchquerystringFuzzy 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`.
sortqueryone of `name`, `category`name`name` = alphabetical (similarity-ranked while searching); `category` = grouped by category, then name.
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/items"

Example response

{
  "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://files.facepunch.com/rust/item/rifle.lr300.space_512.png",
      "is_craftable": false
    }
  ]
}

GET/items/categoriescopy URL

The 14 categories in the site's display order (wiki.facepunch.com's own sidebar order, not alphabetical), each with the number of live items in it, plus `total`. Use the `category` value as the `category` filter of `/items`. Cached for one hour.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/items/categories"

Example response

{
  "total": 1098,
  "results": [
    {
      "category": "weapon",
      "count": 99
    },
    {
      "category": "construction",
      "count": 69
    },
    {
      "category": "general",
      "count": 202
    },
    "… 11 more"
  ]
}

GET/items/searchcopy URL

Item name / shortname typeahead

Up to 25 live items matching `q`, best match first: a case-insensitive substring match on the display name OR the shortname, plus trigram similarity on the display name so typos still resolve (`asault` finds the Assault Rifle) - the same ILIKE + similarity search the site's item pickers use. Each result is `{shortname, display_name, category, icon_url}`; use the shortname with `/items/{shortname}`. For filtered, paginated results use `/items?search=` instead. Cached for 5 minutes per query.

ParameterInTypeDefaultDescription
q requiredquerystringPart of an item's display name or shortname (2+ characters). (min length 2, max length 80)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/items/search?q=assault"

Example response

{
  "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://files.facepunch.com/rust/item/rifle.lr300.space_512.png"
    }
  ]
}

GET/items/{shortname}copy URL

Full item detail bundle

Everything the item page shows, in one response: `item` (name, description, category, icon, stack size, despawn seconds, craftable flag), `recipe` (components with quantities), `blueprint_costs` (Research Table scrap cost, or `default`), `tech_tree` (each tech tree the item is on: `cost` 1 research item - `currency` is the Blueprint Fragment, Page or Book - and `path_cost`, that item with everything before it on the cheapest route; `linked` false = in the tree's data but not reachable from its start), `recycle` (rows per `recycler_type`: `recycler` = monument 50%, `safe_zone` 40%, `powered` = monument with the Power Plant grid at stage 2+ 60%, `red` 75%; `quantity` with `chance`), `recycle_table` (one row per output with `expected`, `min`, `max` per type), `vending` (`sold`: NPC shops selling it and the price; `bought`: shops that take it as payment), `repair`, `loot_sources` (every crate/NPC/barrel that drops it, with `chance_pct` and `amount`, highest chance first), `used_in` (items this one is an ingredient of), `skins` (the first 24 skins by price, each with `price` and `store_price` in USD cents, `subscriptions` and `released`), `skins_total` and `similar` (six items from the same category), `has_3d` and `model_url` (the item page's interactive 3D view of the in-game model, null when the game files have no model for it; item3d 2026-11-16). Page through all skins with `/items/{shortname}/skins`. Cached for 15 minutes.

ParameterInTypeDefaultDescription
shortname requiredpathstringThe item's shortname, e.g. `rifle.ak` or `metal.fragments`. (min length 1, max length 80)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/items/rifle.ak"

Example response

{
  "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
    }
  ],
  "recycle": [
    {
      "recycler_type": "recycler",
      "shortname": "wood",
      "display_name": "Wood",
      "icon_url": "https://files.facepunch.com/rust/item/wood_512.png",
      "quantity": 100,
      "chance": 1
    },
    {
      "recycler_type": "recycler",
      "shortname": "metal.refined",
      "display_name": "High Quality Metal",
      "icon_url": "https://files.facepunch.com/rust/item/metal.refined_512.png",
      "quantity": 25,
      "chance": 1
    },
    {
      "recycler_type": "recycler",
      "shortname": "metalspring",
      "display_name": "Metal Spring",
      "icon_url": "https://files.facepunch.com/rust/item/metalspring_512.png",
      "quantity": 2,
      "chance": 1
    },
    "… 16 more"
  ],
  "recycle_table": [
    {
      "shortname": "wood",
      "name": "Wood",
      "icon_url": "https://files.facepunch.com/rust/item/wood_512.png",
      "by_type": {
        "recycler": {
          "expected": 100.0,
          "min": 100,
          "max": 100
        },
        "safe_zone": {
          "expected": 80.0,
          "min": 80,
          "max": 80
        },
        "powered": {
          "expected": 120.0,
          "min": 120,
          "max": 120
        },
        "red": {
          "expected": 150.0,
          "min": 150,
          "max": 150
        }
      }
    },
    {
      "shortname": "metal.refined",
      "name": "High Quality Metal",
      "icon_url": "https://files.facepunch.com/rust/item/metal.refined_512.png",
      "by_type": {
        "recycler": {
          "expected": 25.0,
          "min": 25,
          "max": 25
        },
        "safe_zone": {
          "expected": 20.0,
          "min": 20,
          "max": 20
        },
        "powered": {
          "expected": 30.0,
          "min": 30,
          "max": 30
        },
        "red": {
          "expected": 37.5,
          "min": 37,
          "max": 38
        }
      }
    },
    {
      "shortname": "metalspring",
      "name": "Metal Spring",
      "icon_url": "https://files.facepunch.com/rust/item/metalspring_512.png",
      "by_type": {
        "recycler": {
          "expected": 2.0,
          "min": 2,
          "max": 2
        },
        "safe_zone": {
          "expected": 1.6,
          "min": 1,
          "max": 2
        },
        "powered": {
          "expected": 2.4,
          "min": 2,
          "max": 3
        },
        "red": {
          "expected": 3.0,
          "min": 3,
          "max": 3
        }
      }
    },
    "… 1 more"
  ],
  "tech_tree": [
    {
      "tree": "workbench3",
      "label": "Workbench Level 3",
      "cost": 1,
      "path_cost": 9,
      "currency": {
        "shortname": "blueprintbook",
        "name": "Blueprint Book",
        "plural": "Blueprint Books",
        "icon_url": null,
        "has_page": false
      },
      "linked": true
    }
  ],
  "vending": {
    "sold": [
      {
        "order_set": "TravellingVendor",
        "title": "Travelling Vendor (full list, unused)",
        "placed": false,
        "picks": 7,
        "where": [],
        "sell_amount": 1,
        "sell_bp": false,
        "price": 0,
        "price_text": "300-350 Scrap (10% chance of 150-250)",
        "random": true,
        "currency": {
          "shortname": "scrap",
          "name": "Scrap",
          "icon_url": "https://files.facepunch.com/rust/item/scrap_512.png",
          "has_page": true
        }
      }
    ],
    "bought": []
  },
  "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": 48,
      "source_name": "Locked Crate",
      "amount": 1,
      "chance_pct": 28.451
    },
    {
      "source_id": 156,
      "source_name": "Locked Crate - Oilrig",
      "amount": 1,
      "chance_pct": 28.451
    },
    {
      "source_id": 155,
      "source_name": "Locked Crate - Ghostship",
      "amount": 1,
      "chance_pct": 28.451
    },
    "… 15 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": 346,
  "…": "1 more keys"
}

GET/items/{shortname}/skinscopy URL

All skins for an item, priced

Every skin for one base item, most expensive first (unpriced skins last, then by name) - the same list and order as the Skins tab on the item page. Each skin carries `itemdefid`, `name`, `icon_url`, `market_hash_name`, `item_collection`, `workshopid`, `price` (canonical wiki price, USD cents, null when nothing is listed), `store_price` (its original Rust item-store price, USD cents), `store_change_pct`, `subscriptions` (Workshop subscriber count), `released` and the tradable/marketable/banned flags. Prices refresh about every 12 minutes; this list is cached for 15.

ParameterInTypeDefaultDescription
shortname requiredpathstringThe item's shortname, e.g. `rifle.ak`. (min length 1, max length 80)
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/items/rifle.ak/skins"

Example response

{
  "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"
  ]
}

GET/items/{shortname}/fullcopy URL

Everything about one item in one call

The item page's whole bundle, trimmed for reading, plus every other dataset that mentions the item: `item` (name, description, category, stack size, despawn), `recipe`, `craft_time` (seconds at workbench level 1, and with one/two levels above), `blueprint_costs` (research), `tech_tree` (where it sits and what it costs in research items), `recycle_table`, `vending` (NPC shops selling it / taking it), `loot_sources` (the 15 best chances), `used_in`, `weapon` (damage, fire rate, magazine, range - guns), `explosive` (splash radius and hits per building grade - explosives), `fishing` (as a catch or as bait), `survival` (spoilage, compost value, armour insert stats/slots, pet stats, mission rewards, keycard/fuse puzzles), `design_notes` (lore from The Art of Rust), `skins` (the 5 priciest of `skins_total`) and `tools` - follow-up tools for more. Cached item bundle + pure lookups.

ParameterInTypeDefaultDescription
shortname requiredpathstringThe item's shortname (find it with `/search` or `/items/search`). (min length 1, max length 80)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/items/rifle.ak/full"

Example response

{
  "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,
    "status": "live",
    "max_condition": 150,
    "workbench_tier": 3,
    "removed_build": null,
    "variant_of": null,
    "variant_of_name": null,
    "is_dlc": false,
    "is_steam_item": false
  },
  "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
    },
    "…"
  ],
  "blueprint_costs": [
    {
      "unlock_source": "research_table",
      "scrap_cost": 300,
      "workbench_tier": 3
    }
  ],
  "tech_tree": [
    {
      "tree": "workbench3",
      "label": "Workbench Level 3",
      "cost": 1,
      "path_cost": 9,
      "currency": {
        "shortname": "blueprintbook",
        "name": "Blueprint Book",
        "plural": "Blueprint Books",
        "icon_url": null,
        "has_page": true
      },
      "linked": true
    }
  ],
  "recycle_table": [
    {
      "shortname": "wood",
      "name": "Wood",
      "icon_url": "https://files.facepunch.com/rust/item/wood_512.png",
      "by_type": {
        "recycler": {
          "expected": 100.0,
          "min": 100,
          "max": 100
        },
        "safe_zone": {
          "expected": 80.0,
          "min": 80,
          "max": 80
        },
        "powered": {
          "expected": 120.0,
          "min": 120,
          "max": 120
        },
        "red": {
          "expected": 150.0,
          "min": 150,
          "max": 150
        }
      }
    },
    {
      "shortname": "metal.refined",
      "name": "High Quality Metal",
      "icon_url": "https://files.facepunch.com/rust/item/metal.refined_512.png",
      "by_type": {
        "recycler": {
          "expected": 25.0,
          "min": 25,
          "max": 25
        },
        "safe_zone": {
          "expected": 20.0,
          "min": 20,
          "max": 20
        },
        "powered": {
          "expected": 30.0,
          "min": 30,
          "max": 30
        },
        "red": {
          "expected": 37.5,
          "min": 37,
          "max": 38
        }
      }
    },
    "…"
  ],
  "vending": {
    "sold": [
      {
        "order_set": "TravellingVendor",
        "title": "Travelling Vendor (full list, unused)",
        "placed": false,
        "picks": 7,
        "where": [],
        "sell_amount": 1,
        "sell_bp": false,
        "price": 0,
        "price_text": "300-350 Scrap (10% chance of 150-250)",
        "random": true,
        "currency": {
          "shortname": "scrap",
          "name": "Scrap",
          "icon_url": "https://files.facepunch.com/rust/item/scrap_512.png",
          "has_page": true
        }
      }
    ],
    "bought": []
  },
  "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": 155,
      "source_name": "Locked Crate - Ghostship",
      "amount": 1,
      "chance_pct": 27.84
    },
    {
      "source_id": 48,
      "source_name": "Locked Crate",
      "amount": 1,
      "chance_pct": 27.78
    },
    "…"
  ],
  "loot_sources_total": 18,
  "used_in": [],
  "skins": [
    {
      "itemdefid": 22003,
      "name": "Glory AK47",
      "price": 29325
    },
    {
      "itemdefid": 21008,
      "name": "Alien Red",
      "price": 15982
    },
    "…"
  ],
  "skins_total": 346,
  "craft_time": {
    "s": 35,
    "one_up": 17.5,
    "two_up": 8.75,
    "build": "26498655",
    "rule": "The game charges the blueprint's time, capped at 5 seconds for stackable resources and components, or at 5 + 10 x the workbench level (minimum 1) for single-stack, held, worn, usable (food, medicine), construction and trap items. Crafting at a workbench one level above the recipe halves it; two or more levels above quarters it. A workbench with the Accelerated upgrade cuts each further item of a b…"
  },
  "weapon": {
    "name": "Assault Rifle",
    "shortname": "rifle.ak",
    "category": "Rifle",
    "ammo": "5.56 Rifle Ammo",
    "damage": 50,
    "pellets": null,
    "rpm": 450,
    "magazine": 30,
    "reload_s": 4.4,
    "range_m": "20-100",
    "range_end": 100.0,
    "workbench": 3,
    "notes": ""
  },
  "explosive": null,
  "fishing": null,
  "survival": null,
  "design_notes": [
    {
      "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, improvisation, and wear.",
      "page": 119
    }
  ],
  "tools": {
    "all skins": {
      "tool": "get_item_skins",
      "arguments": {
        "shortname": "rifle.ak"
      }
    },
    "craft cost for N": {
      "tool": "calculate_craft_cost",
      "arguments": {}
    },
    "recycle yield": {
      "tool": "calculate_recycle_yield",
      "arguments": {}
    },
    "see it in 3D": {
      "tool": "skinlab_link",
      "arguments": {}
    },
    "loot odds": {
      "tool": "simulate_crate_open",
      "arguments": {}
    }
  },
  "page": "https://rust.wiki/item/rifle.ak"
}

Skins

category skins · 25,000 requests/day

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. Skin Lab (/skin-lab/...): the items and skins that can be viewed on the 3D player model at https://rust.wiki/skin-lab, ready-made viewer links for any item or skin, an outfit builder that applies the game's own wear rules (which pieces can't be worn together) and totals the outfit's Steam price, and every gun's attachments with their effects. Skin Lab renders (/skin-lab/render): a rendered image (WebP or PNG, up to 1024 px) of any outfit, gun or item in the 3D viewer - studio or in-game backgrounds - with its own per-key daily render quota.

GET/skinscopy URL

Browse skins with the site's filters and sorts

One page of skin cards exactly as the /skins browser shows them: `itemdefid`, `name`, icons, `category`, `item_collection`, `market_hash_name`, flags (`is_twitch_drop`, `is_limited_time`, `marketable`, `tradable`, `is_permanent`...), `price` (canonical wiki price in cents, null when Steam has no listing), `subscriptions` (Workshop subscribers, the site's supply proxy), `store_price` (the original item-store price in cents), `store_change_pct` (market price vs store price) and `released` (date accepted into the store). Filters combine with AND. `total` is the filtered count; results are cached for 120 seconds per filter combination.

ParameterInTypeDefaultDescription
categoryqueryone of `weapon`, `clothing`, `deployable`, `decoration`, `crate`, `resource`, `mask`, `none`Skin category.
collectionquerystringExact collection name, e.g. `Forest Raiders` (see /skins/collections).
itemquerystringBase item shortname, e.g. `rifle.ak` - every skin of that one item.
searchquerystringFuzzy name search (trigram similarity; with sort=name results are relevance-ordered). Searches are never cached server-side.
creatorquerystringWorkshop creator: a 17-digit SteamID64 for an exact match, or part of the creator's display name.
colorqueryone of `red`, `orange`, `yellow`, `green`, `cyan`, `blue`, `purple`, `pink`, `brown`, `white`, `gray`, `black`, `tan`, `olive`, `navy`, `maroon`, `silver`Dominant icon colour bucket; matches any of a skin's up to five dominant colours.
limited_timequerybooleanFalseOnly limited-time store items.
permanentquerybooleanFalseOnly permanent store items.
marketablequerybooleanFalseOnly Steam-marketable skins.
tradablequerybooleanFalseOnly tradable skins.
breakablequerybooleanFalseOnly skins with a recycle yield (`recycle_hint`).
glowsquerybooleanFalseOnly skins with glow-in-the-dark elements.
commodityquerybooleanFalseOnly Steam commodity items.
hide_dropsquerybooleanFalseHide loot-crate drops, publisher drops and Twitch drops (what the site calls DLCs and drops).
min_subsqueryone of `1000`, `5000`, `10000`, `25000`, `50000`Minimum Steam Workshop subscriber count of the skin's original submission.
releasedqueryone of `2026`, `2025`, `2024`, `2023`, `2022`, `2021`, `2020`, `2019`, `2018`, `2017`, `2016`, `2015`Year the skin was accepted into the item store.
sortqueryone of `price_desc`, `price_asc`, `name`, `popularity`, `supply_asc`, `released_desc`, `released_asc`, `trending`, `marketcap_desc`price_descOrdering. `popularity` and `supply_asc` use Workshop subscribers; `trending` is the 7-day price change; `marketcap_desc` is price x subscribers.
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/skins"

Example response

{
  "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"
  ]
}

GET/skins/searchcopy URL

Skin name typeahead

Up to 10 skins whose name matches `q`, best match first (the same ILIKE + trigram search the site's search boxes use). Each result is `{itemdefid, name, icon_url}`; use the `itemdefid` with the other skin endpoints. For filtered, paginated results use GET /skins with `search=` instead.

ParameterInTypeDefaultDescription
q requiredquerystringPart of a skin name (2+ characters). (min length 2, max length 100)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/skins/search?q=tempered"

Example response

{
  "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"
  ]
}

GET/skins/collectionscopy URL

Skin collections with counts and values

Every skin collection (about 750, e.g. `Forest Raiders`, `Abyss`): `name`, `count` (members), `total_value` and `avg_value` (cents, over the priced members only; null when nothing in it is priced) and `icons`, one `{url, name}` per member skin. The collection's URL slug is its lower-cased name with non-alphanumerics collapsed to `-` (`Forest Raiders` -> `forest-raiders`), which is what GET /skins/collections/{slug} takes. Cached for 30 minutes.

ParameterInTypeDefaultDescription
sortqueryone of `value_desc`, `value_asc`, `count_desc`, `count_asc`, `name`value_desc`value_*` sorts by the summed wiki price of the collection's skins, `count_*` by member count.
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/skins/collections"

Example response

{
  "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"
  ]
}

GET/skins/collections/{slug}copy URL

One collection with all its skins

The collection's `name`, `slug`, `count`, `total_value` and `avg_value` (cents), `released` (the earliest member's store-acceptance date) and `skins`: every member as `{itemdefid, name, icon_url, rarity, category, price}` ordered by price, highest first. The collection's value-over-time series is GET /market/collection-value. Cached for 30 minutes.

ParameterInTypeDefaultDescription
slug requiredpathstringCollection slug (lower-case, hyphenated name), e.g. `forest-raiders`. (max length 120)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/skins/collections/forest-raiders"

Example response

{
  "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"
}

GET/skins/{itemdefid}copy URL

Full skin detail: price, order book, history, cross-market prices

Everything the skin's wiki page shows, as data. `skin` is the full catalogue record (creator, workshop title and dates, collection, flags, store price and availability, crafting components, glow/cutout ratios, colours). `price` is the canonical wiki price in cents and `price_source` says which side of the book it came from. `orderbook` is Steam's live book: lowest sell order, highest buy order, order counts, the `buy_orders` and `sell_orders` depth ladders (`{price, quantity}`, best first) and `fetched_at`; the headline price refreshes more often than the ladders, so they can briefly trail it. `steam_history` is the last year of Steam's own sale history (`recorded_at`, median sale `price`, `volume`; `sale_basis` false means Steam has no sale series and the points are our ask-price readings instead) - wider ranges via /skins/{itemdefid}/history. `market_stats` is the page's Community & Market Stats card: an archived SCMM snapshot (frozen September 2026) of `supply_total`/`supply_total_estimated`/`supply_total_owners_estimated`, Workshop `subscriptions_current`/ `subscriptions_lifetime`, `favourited_current`, `views`, `votes_up`/`votes_down`, `market_24hr_value`, `market_168hr_value`, `market_last_30d_sales`, `market_rank_index`, `market_liquidity_score`, the market high/low with their dates, `change_7d_percent`/`change_30d_percent`/`change_90d_percent` and `ath_percent`; null for skins SCMM never covered. `cross_market` is live and always present: `market_prices`, the current price and stock on each third-party marketplace we poll (`marketType`, `price` in cents, `supply`; names only, no links), plus the cheapest as `buy_now_price`/`buy_now_from`. `est_supply` (Workshop subscribers or SCMM estimate) and `est_market_cap` (price x supply) are the site's stated approximations. Also `store_rotations` the skin appeared in, `collection_items` and `other_item_skins` (sibling cards), `description`, and `tracked_holders` (`holders`/`units` seen in scanned inventories). `release`: when the skin entered the game (`added`, from the game's own approved-skin list when `in_game_files`), the Item Store `store_price` and `first_in_store`, `now` (the wiki price), `change_pct` and `per_year_pct`, and `game` - the game files' exact `workshopid`, base `item`, `tradable`, `marketable`, `crate_drop`, `twitch_drop`. Cached for 15 minutes; the cross-market block refreshes every ~5.

ParameterInTypeDefaultDescription
itemdefid requiredpathintegerThe skin's Steam item definition id (also its rust.wiki URL: /skin/{itemdefid}). (min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/skins/10138"

Example response

{
  "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"
}

GET/skins/{itemdefid}/orderbookcopy URL

Full Steam order book for one skin

Steam Community Market's current order book for the skin, straight from our scraper's latest snapshot: `lowest_sell_order` and `highest_buy_order` (cents; null when that side is empty), `sell_order_count` and `buy_order_count`, the COMPLETE `sell_orders` and `buy_orders` depth ladders as `[{price, quantity},...]` best price first (every level Steam publishes, not a top-N cut), and `fetched_at`, when the snapshot was taken. The headline ask is refreshed by a market-wide sweep every ~12 minutes; the depth ladders come from the per-item rotation (every few hours), so they can trail it slightly. 404 when the skin has no Steam order book (unmarketable items). Not cached: this is one indexed row.

ParameterInTypeDefaultDescription
itemdefid requiredpathintegerThe skin's item definition id. (min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/skins/10138/orderbook"

Example response

{
  "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"
}

GET/skins/{itemdefid}/historycopy URL

Steam sale history for one skin

Steam Community Market's own sale history for the skin, scraped from Steam's listing page: `points` of `{recorded_at, price, volume}` where `price` is Steam's median sale price for that interval in cents and `volume` the number of sales. Steam reports roughly hourly points for the recent month and daily beyond; ranges of a year or more are condensed to one point per day (median price, summed volume). Empty when Steam has no sale series for the item (unmarketable skins). History goes back to the skin's first sale, as far as 2015. Refreshed continuously; the full series is cached for an hour.

ParameterInTypeDefaultDescription
itemdefid requiredpathintegerThe skin's item definition id. (min 1)
rangequeryone of `1d`, `1w`, `1m`, `3m`, `6m`, `1y`, `2y`, `5y`, `all`1yHow far back: `1d`, `1w`, `1m`, `3m`, `6m`, `1y`, `2y`, `5y` or `all`.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/skins/10138/history"

Example response

{
  "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"
  ]
}

GET/skins/{itemdefid}/marketplace-historycopy URL

Price and sales history for one skin on each marketplace

The skin's history on every marketplace rust.wiki tracks, Steam included. Per site in `sites`: `listing` is `[day, low, close, qty]` per UTC day - the lowest listing price we read that day (`low` the day's lowest reading, `close` the last) and how many listings stood behind it; `sales` maps a period to `[day, volume, avg_price]` rows - `day` and `week` are real sales buckets (`day` = the bucket's first day) from each site's own sales data: Rust.tm (years back), CS.Deals, DMarket, Mannco.store and RustSkins; `r1` is Skinport's last-24-hours figure recorded once a day against the day it covers; `r7` and `r30` are a site's rolling 7- and 30-day figures as we read them that day. Prices are integer USD cents. Listing history starts 2026-10-30. Steam's own sale history is GET /skins/{itemdefid}/history. Updated through the day (listings every ~5 minutes).

ParameterInTypeDefaultDescription
itemdefid requiredpathintegerThe skin's item definition id. (min 1)
rangequeryone of `1m`, `3m`, `6m`, `1y`, `all`1yHow far back: `1m`, `3m`, `6m`, `1y` or `all`.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/skins/43203/marketplace-history"

GET/skins/{itemdefid}/pricecopy URL

Live price, order book depth, extremes and 7d/30d change for one skin

The compact price card the rust.wiki Discord bot's /price command shows, as data. All prices are integer USD cents: `price_cents` (the canonical wiki price - Steam's lowest sell order, or the highest buy order when nothing is listed), `ask_cents` and `bid_cents` (the two sides of Steam's book), `sell_orders`/`buy_orders` (how many orders stand on each side), `sell_ladder` and `buy_ladder` (the top five price levels on each side, best first, as `{price, quantity}`), `ath_cents`/`atl_cents` (the skin's all-time high and low from Steam's sale history), `change_7d`/`change_30d` (percent move of today's price against our closest Steam price reading 7 and 30 days back; null without enough history) and `sales_30d` (units sold on Steam in the last 30 days, null when none). Plus `name`, `icon_url`, `market_hash_name` and `category`. Cached for 5 minutes.

ParameterInTypeDefaultDescription
itemdefid requiredpathintegerThe skin's item definition id. (min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/skins/10138/price"

Example response

{
  "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"
}

GET/skins/{itemdefid}/holderscopy URL

Who holds this skin (scanned inventories)

The largest known holders of the skin, most units first: `{steamid64, display_name, avatar_url, quantity}`. This is the same public Top Holders list the skin page shows, built only from inventories that someone has run through the rust.wiki/inventory lookup - `total` is the number of such holders and `tracked_units` the units they hold between them, not the skin's circulating supply. Cached for 30 minutes.

ParameterInTypeDefaultDescription
itemdefid requiredpathintegerThe skin's item definition id. (min 1)
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/skins/10138/holders"

Example response

{
  "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
}

GET/skin-lab/itemscopy URL

Items and skins you can view on the 3D player model (Skin Lab)

Every item Skin Lab has a 3D model for (clothing, armour, guns and tools, deployables, building skins, vehicles), in viewer order. Each row has `shortname`, `name`, `slot` / `slot_name` (where the viewer puts it), `group`, `worn` (false = stood beside the player rather than worn), `female_model`, `takes_attachments`, `skins_in_3d` (accepted Workshop and built-in skins with 3D textures), `cheapest_skin` / `priciest_skin` (Steam lowest listing, USD cents), `viewer_url` (the item in its default look) and the wiki `page`. More skins are added as they're processed.

ParameterInTypeDefaultDescription
groupquerystring`clothing`, `weapon`, `deployable`, `building`, `vehicle` or `misc`.
slotquerystringViewer slot: head, face, eyewear, shirt, jacket, chest-armour, gloves, pants, leg-armour, shoes, back, weapon, deployable, building, vehicle (or its number).
searchquerystringCase-insensitive match on the item's name or shortname.
with_skinsqueryinteger0Also list each item's N most expensive 3D skins (0 = counts only). (max 50, min 0)
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/skin-lab/items"

Example response

{
  "page": 1,
  "per_page": 50,
  "total": 1,
  "pages": 1,
  "results": [
    {
      "shortname": "hoodie",
      "name": "Hoodie",
      "slot": 0,
      "…": "10 more keys"
    }
  ],
  "skins_in_3d_total": 1507,
  "viewer": "https://rust.wiki/skin-lab"
}

GET/skin-lab/items/{shortname}copy URL

One Skin Lab item with every skin it can be viewed in, in 3D

The item as in /skin-lab/items plus `skins`: every skin with 3D textures, most expensive first, each with `itemdefid`, `name`, `price` (USD cents, Steam lowest listing; null = not on the market), `icon`, its own `viewer_url` and wiki `page`. Guns also carry `attachments` (what they accept - see /skin-lab/attachments).

ParameterInTypeDefaultDescription
shortname requiredpathstringItem shortname (or its name).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/skin-lab/items/hoodie"

Example response

{
  "shortname": "hoodie",
  "name": "Hoodie",
  "slot": 0,
  "slot_name": "Shirt",
  "group": "clothing",
  "worn": true,
  "female_model": true,
  "takes_attachments": false,
  "skins_in_3d": 24,
  "cheapest_skin": 551,
  "priciest_skin": 3082,
  "viewer_url": "https://rust.wiki/skin-lab?o=0:hoodie:0&mode=outfit",
  "…": "2 more keys"
}

GET/skin-lab/linkcopy URL

A Skin Lab 3D viewer link for one item or skin

Answers "can I see this skin in 3D?". With a known item and a processed skin: `available_in_3d: true`, the `viewer_url` that opens rust.wiki/skin-lab with it on, and `embed` ({o, mode} - the same piece the "View in 3D" card on the item and skin pages loads). A real skin that has no 3D textures yet gives `available_in_3d: false` with the reason and a `fallback_url` showing the item's default look. Unknown items are 404 with suggestions.

ParameterInTypeDefaultDescription
itemquerystringItem shortname or name. Optional when `skin` is an itemdefid.
skinquerystringSkin itemdefid or name (default look when left out).
attachmentsquerystringGuns only: comma-separated attachment shortnames, e.g. `weapon.mod.holosight,weapon.mod.silencer`.
modequerystring`outfit` (on the player), `weapon` (the item on its own) or `pov` (first person, guns and tools). Default: `outfit` for worn items, `weapon` otherwise.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/skin-lab/link"

Example response

{
  "available_in_3d": true,
  "viewer_url": "https://rust.wiki/skin-lab?o=3:metal.facemask:20082&mode=outfit",
  "item": {
    "shortname": "metal.facemask",
    "name": "Metal Facemask",
    "slot": 3,
    "slot_name": "Face",
    "page": "https://rust.wiki/item/metal.facemask"
  },
  "skin": {
    "itemdefid": 20082,
    "name": "Tempered Mask",
    "price": 19067,
    "page": "https://rust.wiki/skin/20082"
  },
  "attachments": [],
  "invalid_attachments": [],
  "mode": "outfit",
  "embed": {
    "o": "3:metal.facemask:20082",
    "mode": "outfit"
  }
}

GET/skin-lab/outfitcopy URL

Build and check a Skin Lab outfit: wear-rule clashes, attachments, total price and the 3D link

Puts the pieces on in order, the way the viewer and the game do. Pieces that can't be worn together (the game's own wear rules: two pieces clash when they occupy the same under-layer or over-layer body area - a Coffee Can Helmet and a Metal Facemask both cover the head) are reported in `clashes` with the piece they conflict with and why; the first piece wins and the later one is left out of the link, exactly as the viewer would; a second piece for a viewer slot that's already filled is a clash too. `invalid_attachments` lists attachments a gun doesn't accept or that fight for the same attachment slot; `errors` lists pieces that couldn't be resolved (unknown item, or a skin that isn't in 3D yet). `slots` is the normalised outfit (slot, item, skin, price), `total_price` the sum of the chosen skins' Steam lowest listings in USD cents (default looks cost nothing; `unpriced` counts skins with no listing), `valid` is true when nothing was dropped, and `viewer_url` opens the outfit in rust.wiki/skin-lab.

ParameterInTypeDefaultDescription
pieces requiredquerystringComma-separated pieces, each `item[:skin[:attachment~attachment]]` - item by shortname or name, skin by itemdefid or name (left out or 0 = default look), attachments for guns. A bare number is a skin itemdefid. Up to 15 pieces, one per viewer slot. (min length 2, max length 2000)
modequerystringoutfitViewer mode for the link: `outfit`, `weapon` (the first piece on its own) or `pov` (first person; needs a gun or tool). (pattern ^(outfit|weapon|pov)$)
posequerystringPose key, e.g. `idle`, `wave`, `crouch`, `rifle_aim`, `walk` (default `auto`). Invalid keys are listed in the error.
bodyquerystringmaleBody model. (pattern ^(male|female)$)
facequerystringFace (head) name for that body, e.g. `Frank` - list in the error when wrong.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/skin-lab/outfit?pieces=metal.facemask:20082,hoodie:43105,pants,shoes.boots,rifle.ak:22003:weapon.mod.holosight~weapon.mod.silencer"

Example response

{
  "valid": true,
  "viewer_url": "https://rust.wiki/skin-lab?o=3:metal.facemask:20082,0:hoodie:43105,5:pants:0,4:shoes.boots:0,6:rifle.ak:22003:weapon.mod.holosight~weapon.mod.silencer&mode=outf…",
  "slots": [
    {
      "slot": 3,
      "slot_name": "Face",
      "item": "metal.facemask",
      "name": "Metal Facemask",
      "skin_id": 20082,
      "skin": "Tempered Mask",
      "price": 19067,
      "attachments": [],
      "skin_page": "https://rust.wiki/skin/20082",
      "item_page": "https://rust.wiki/item/metal.facemask"
    },
    {
      "slot": 0,
      "slot_name": "Shirt",
      "item": "hoodie",
      "name": "Hoodie",
      "skin_id": 43105,
      "skin": "Desert Raiders Hoodie",
      "price": 3082,
      "attachments": [],
      "skin_page": "https://rust.wiki/skin/43105",
      "item_page": "https://rust.wiki/item/hoodie"
    },
    {
      "slot": 5,
      "slot_name": "Pants",
      "item": "pants",
      "name": "Pants",
      "skin_id": 0,
      "skin": null,
      "price": null,
      "attachments": [],
      "skin_page": null,
      "item_page": "https://rust.wiki/item/pants"
    },
    "… 2 more"
  ],
  "total_price": 51474,
  "unpriced": 0,
  "clashes": [],
  "invalid_attachments": [],
  "errors": [],
  "warnings": [],
  "mode": "outfit",
  "pose": "auto",
  "body": "male",
  "…": "2 more keys"
}

GET/skin-lab/attachmentscopy URL

Weapon attachments: what each gun accepts and what each attachment does

From the game's own attachment data (as Skin Lab uses it). Each attachment has `shortname`, `name`, `slot` (`muzzle`, `sight`, `underbarrel`, `magazine`, `internal`, `targeting` - one attachment per slot), `description`, `effects` (readable: `damage x0.75` = 25% less damage, `aimcone_hip +2` = wider hip-fire spread) and the raw `stats` multipliers (`scalar`) and additions (`offset`). With `weapon`: that gun's `slots` and `accepts` (the attachments that fit it). Without: every gun's accepted list plus every attachment.

ParameterInTypeDefaultDescription
weaponquerystringGun shortname or name; left out = every gun and every attachment.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/skin-lab/attachments"

Example response

{
  "weapon": {
    "shortname": "rifle.ak",
    "name": "Assault Rifle",
    "page": "https://rust.wiki/item/rifle.ak"
  },
  "slots": [
    "magazine",
    "muzzle",
    "sight",
    "… 2 more"
  ],
  "accepts": [
    {
      "shortname": "weapon.mod.8x.scope",
      "name": "Variable Zoom Scope",
      "slot": "sight",
      "description": "A large military-grade scope that can be configured from 4x zoom to 16x zoom.",
      "effects": [
        "recoil x1.5",
        "zoom 8x"
      ],
      "stats": {
        "recoil": {
          "scalar": 1.5,
          "offset": 0.0
        }
      },
      "shown_on_model": true,
      "url": "https://rust.wiki/item/weapon.mod.8x.scope"
    },
    {
      "shortname": "weapon.mod.extendedmags",
      "name": "Extended Magazine",
      "slot": "magazine",
      "description": "Larger magazine size",
      "effects": [
        "magazine x1.25"
      ],
      "stats": {
        "magazine": {
          "scalar": 1.25,
          "offset": 0.0
        }
      },
      "shown_on_model": false,
      "url": "https://rust.wiki/item/weapon.mod.extendedmags"
    },
    {
      "shortname": "weapon.mod.flashlight",
      "name": "Weapon flashlight",
      "slot": "underbarrel",
      "description": "Attaches to a weapon. Provides user with a beam of light. Pressing F (default) to toggle light.",
      "effects": [
        "light / laser"
      ],
      "stats": {},
      "shown_on_model": true,
      "url": "https://rust.wiki/item/weapon.mod.flashlight"
    },
    "… 10 more"
  ],
  "rule": "One attachment per slot; a gun only takes the attachments in its accepts list."
}

GET/skin-lab/creator/{shortname}copy URL

Workshop skin making for one item: texture groups, max texture size, maps, UV previews

For Steam Workshop skin makers, from the game's own files. `texture_groups`: each material group the in-game editor shows as a tab, with `max_texture_size` (px, square; bigger images are scaled down to it), `covers` (the mesh parts it textures), `workflow` (`specular` or `metallic`), `alpha_cutout` (the diffuse alpha is a cut-out mask), `texture_maps` (the editor's slots for that material: `slot` property name, `name`, what to paint) and a `uv_preview_url` (UV wireframe image, 1024 px) with `uv_coverage` (share of the texture used). Plus `max_texture_size` over all groups, `open_for_workshop` (false = the editor doesn't list the item), `editor` (how to open it), `notes` and Facepunch's `docs`. The.obj templates themselves come from the editor's Download button.

ParameterInTypeDefaultDescription
shortname requiredpathstringItem shortname (or its name).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/skin-lab/creator/rifle.ak"

GET/skin-lab/rendercopy URL

Render a Skin Lab outfit, gun or item as an image (WebP/PNG)

Returns `{status: "done", url, cached, width, height, format}` with a permanent image URL (same request = same URL; images are cached), plus `outfit` (the normalised pieces, their Steam prices and `total_price` in USD cents, and any clashes / invalid attachments dropped exactly as /skin-lab/outfit reports them), `viewer_url` (the same outfit in the interactive 3D viewer) and `render_quota`. A render that takes longer than `wait` seconds answers **202** `{status: "queued", position, retry_after}` - call again with the same parameters (no extra quota) after `Retry-After` seconds. 429 when the render queue is full or a quota is used up. New images count against a separate render quota (100 per key per UTC day); cached images don't.

ParameterInTypeDefaultDescription
piecesquerystringThe outfit, exactly as for /skin-lab/outfit: comma-separated `item[:skin[:attachment~attachment]]` (item by shortname or name, skin by itemdefid or name, attachments for guns; a bare number is a skin itemdefid). Left out = the viewer's starter outfit.
modequerystringoutfit`outfit` (on the player), `weapon` (the FIRST piece on its own - guns, tools, deployables) or `pov` (first person; needs a gun or tool). (pattern ^(outfit|weapon|pov)$)
posequerystringPose key, e.g. `idle`, `wave`, `crouch`, `rifle_aim` (default `auto`). Moving poses are shown frozen.
bodyquerystringmaleBody model. (pattern ^(male|female)$)
facequerystringFace (head) name for that body, e.g. `Frank` (default: the first face).
backgroundquerystringstudio`studio`, `dark`, `light`, `sky`, `sunset`, or an in-game scene: plains, forest, arctic, desert, beach, set_base, set_garage, set_compound, set_monument, set_launch, set_market, set_military, set_dock, set_coast.
lightquerystringstudioLighting: studio, day, golden, overcast, dusk, night. `studio` on an in-game scene = that scene's own daylight.
weatherquerystringautoIn-game scenes only: auto, off, clear, cloudy, fog, rain, storm, snow.
yawqueryinteger0Turn the character/item, degrees. (max 180, min -180)
zoomquerynumber1.0Camera zoom (1 = the viewer's framing). (max 2.5, min 0.4)
widthqueryinteger768Image width, px. (max 1024, min 256)
heightqueryinteger768Image height, px. (max 1024, min 256)
formatquerystringwebp`webp` (small) or `png`. (pattern ^(webp|png)$)
transparentquerybooleanFalseTransparent backdrop (studio-type backgrounds only; the floor disc stays).
waitqueryinteger20Seconds to wait for a render that isn't cached yet before answering 202. (max 25, min 0)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/skin-lab/render"

GET/creatorscopy URL

Workshop artists behind Rust's skins, by total value

Everyone whose Workshop skins Facepunch accepted into Rust (https://rust.wiki/creators): `steamid`, `name` (from their latest skin), `avatar_url`, `count` of accepted skins, `total_value` (sum of their skins' Steam lowest listings, USD cents), `newest` release date and a few `icons` of their priciest skins.

ParameterInTypeDefaultDescription
sortquerystringvalue_desc`value_desc` (total value of their skins), `count_desc`, `newest` or `name`. (pattern ^(value_desc|count_desc|newest|name)$)
pagequeryinteger11-based page number. (max 1000, min 1)
per_pagequeryinteger24Results per page (max 100). (max 100, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/creators"

Example response

{
  "page": 1,
  "per_page": 24,
  "total": 450,
  "pages": 19,
  "results": [
    {
      "steamid": "76561198035849663",
      "name": "Mishka☢",
      "avatar_url": "https://avatars.steamstatic.com/02360d37bc2a0f674ee45c193ff85693f6e1dc49_medium.jpg",
      "count": 195,
      "total_value": 240755,
      "newest": "2026-09-24",
      "icons": [
        {
          "url": "https://files.facepunch.com/rust/icons/inventory/rust/67303_small.png?2937526183",
          "name": "Limited Edition Training SKS",
          "itemdefid": 67303
        },
        {
          "url": "https://files.facepunch.com/rust/icons/inventory/rust/23104_small.png?1797172763",
          "name": "Wasteland Hunter Gloves",
          "itemdefid": 23104
        },
        {
          "url": "https://files.facepunch.com/rust/icons/inventory/rust/32502_small.png?1020710634",
          "name": "Training Pants",
          "itemdefid": 32502
        },
        "… 5 more"
      ],
      "page": "https://rust.wiki/creators/76561198035849663"
    },
    {
      "steamid": "76561197971113659",
      "name": "StabbyMcStabface",
      "avatar_url": "https://avatars.steamstatic.com/20204775c3d650d5660919803f72b17976b3c181_medium.jpg",
      "count": 80,
      "total_value": 226434,
      "newest": "2026-11-05",
      "icons": [
        {
          "url": "https://files.facepunch.com/rust/icons/inventory/rust/20044_small.png?4118240488",
          "name": "Punishment Mask",
          "itemdefid": 20044
        },
        {
          "url": "https://files.facepunch.com/rust/icons/inventory/rust/24712_small.png?1109750385",
          "name": "Chop Shop Garage Door",
          "itemdefid": 24712
        },
        {
          "url": "https://files.facepunch.com/rust/icons/inventory/rust/26802_small.png?1059499092",
          "name": "Cargo Truck Garage Door",
          "itemdefid": 26802
        },
        "… 5 more"
      ],
      "page": "https://rust.wiki/creators/76561197971113659"
    },
    {
      "steamid": "76561198227603076",
      "name": "Alloy",
      "avatar_url": "https://avatars.steamstatic.com/333a2055edba21c93bd045d17e2a5c058ba2c0df_medium.jpg",
      "count": 17,
      "total_value": 202261,
      "newest": "2026-10-15",
      "icons": [
        {
          "url": "https://files.facepunch.com/rust/icons/inventory/rust/60902_small.png?2801290016",
          "name": "Undead Door",
          "itemdefid": 60902
        },
        {
          "url": "https://files.facepunch.com/rust/icons/inventory/rust/53605_small.png?2636496914",
          "name": "Arctic Skull MP5",
          "itemdefid": 53605
        },
        {
          "url": "https://files.facepunch.com/rust/icons/inventory/rust/52502_small.png?3510878769",
          "name": "Arctic Skull LR",
          "itemdefid": 52502
        },
        "… 5 more"
      ],
      "page": "https://rust.wiki/creators/76561198227603076"
    },
    "… 21 more"
  ]
}

GET/creators/{steamid}copy URL

One Workshop artist: every accepted Rust skin they made and what it's worth

The data behind https://rust.wiki/creators/<steamid>: the artist's skins with prices (USD cents), count, total and average value, top skin, first and last release, and the split by item, collection and category.

ParameterInTypeDefaultDescription
steamid requiredpathstringThe artist's SteamID64 (from /creators or a skin's creator). (pattern ^\d{17}$)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/creators/76561198035849663"

Example response

{
  "steamid": "76561198035849663",
  "name": "Mishka☢",
  "avatar_url": "https://avatars.steamstatic.com/02360d37bc2a0f674ee45c193ff85693f6e1dc49_medium.jpg",
  "profile_url": "https://steamcommunity.com/profiles/76561198035849663",
  "workshop_url": "https://steamcommunity.com/profiles/76561198035849663/myworkshopfiles/?appid=252490",
  "skins": [
    {
      "itemdefid": 67303,
      "name": "Limited Edition Training SKS",
      "icon_url": "https://files.facepunch.com/rust/icons/inventory/rust/67303_small.png?2937526183",
      "category": "weapon",
      "rarity": "f15840",
      "item": "SKS",
      "item_shortname": "rifle.sks",
      "collection": "Training",
      "released": "2026-01-22",
      "price": 200079
    },
    {
      "itemdefid": 23104,
      "name": "Wasteland Hunter Gloves",
      "icon_url": "https://files.facepunch.com/rust/icons/inventory/rust/23104_small.png?1797172763",
      "category": "deployable",
      "rarity": "35a3f1",
      "item": "Leather Gloves",
      "item_shortname": "burlap.gloves",
      "collection": "Hunter",
      "released": "2017-07-06",
      "price": 1607
    },
    {
      "itemdefid": 32502,
      "name": "Training Pants",
      "icon_url": "https://files.facepunch.com/rust/icons/inventory/rust/32502_small.png?1020710634",
      "category": "clothing",
      "rarity": "a7ec2e",
      "item": "Pants",
      "item_shortname": "pants",
      "collection": "Training",
      "released": "2019-05-16",
      "price": 1221
    },
    "… 192 more"
  ],
  "count": 195,
  "total_value": 240755,
  "avg_value": 1384,
  "top": {
    "itemdefid": 67303,
    "name": "Limited Edition Training SKS",
    "icon_url": "https://files.facepunch.com/rust/icons/inventory/rust/67303_small.png?2937526183",
    "category": "weapon",
    "rarity": "f15840",
    "item": "SKS",
    "item_shortname": "rifle.sks",
    "collection": "Training",
    "released": "2026-01-22",
    "price": 200079
  },
  "first_release": "2016-12-23",
  "last_release": "2026-09-24",
  "…": "4 more keys"
}

GET/loadoutcopy URL

Price a skin loadout: 7 clothing slots and 6 hotbar slots

The loadout builder (https://rust.wiki/loadout): every slot's skin with its price (USD cents, the wiki's Steam price: lowest listing, else highest buy order) and the `total_price`; `unpriced` counts skins with no price and `unknown` itemdefids that matched no skin. `page` opens the same loadout. Find itemdefids with /skins/search; to check that the clothing can be worn together and see it in 3D, use /skin-lab/outfit.

ParameterInTypeDefaultDescription
clothingquerystringUp to 7 comma-separated skin itemdefids worn (any clothing or armour skins).
hotbarquerystringUp to 6 comma-separated skin itemdefids on the hotbar (weapons, tools, anything).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/loadout"

Example response

{
  "slots": [
    {
      "slot": "clothing1",
      "itemdefid": 10180,
      "name": "Spacesuit",
      "icon_url": "https://files.facepunch.com/rust/icons/inventory/rust/10180_small.png?3449252217",
      "price": 1255,
      "page": "https://rust.wiki/skin/10180"
    },
    {
      "slot": "clothing2",
      "itemdefid": 14179,
      "name": "Black Hoodie",
      "icon_url": "https://files.facepunch.com/rust/icons/inventory/rust/14179_small.png?3717677650",
      "price": 38,
      "page": "https://rust.wiki/skin/14179"
    },
    {
      "slot": "hotbar1",
      "itemdefid": 10137,
      "name": "Military Camo AK47",
      "icon_url": "https://files.facepunch.com/rust/icons/inventory/rust/10137_small.png?1344447110",
      "price": 187,
      "page": "https://rust.wiki/skin/10137"
    }
  ],
  "total_price": 1480,
  "unpriced": 0,
  "unknown": [],
  "currency": "USD cents",
  "page": "https://rust.wiki/loadout?clothing1=10180&clothing2=14179&hotbar1=10137"
}

Market & prices

category market · 10,000 requests/day

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). Also where to sell: the best cash payout for every skin across marketplaces and one skin's every sell option, skins listed below their Cloth/Wood/Metal breakdown value, and multi-market arbitrage loops.

GET/market/pricescopy URL

Steam price of every skin, in one response

Every skin's Steam Community Market price in one blob (about 6,000 priced skins; ~0.7 MB in `full`, ~0.2 MB in `simple`): `prices` is keyed by Steam `market_hash_name`, values in integer USD cents. `price` is the canonical wiki price - the lowest sell order, or the highest buy order when nothing is listed for sale - exactly what every rust.wiki page displays. Steam only; third-party marketplace prices live at GET /market/marketplaces. Regenerated at most every 5 minutes (`generated_at`); the underlying Steam order books refresh every ~12 minutes, so polling faster than that gains nothing. Send `Accept-Encoding: gzip`. Single skins: GET /market/prices/{itemdefid}.

ParameterInTypeDefaultDescription
formatquerystringfull`full` (default): `{itemdefid, price, lowest_sell_order, highest_buy_order}` per skin. `simple`: just `{market_hash_name: price}` - the smallest possible price list.
include_unpricedquerybooleanFalseAlso list skins Steam has no order book for (price null). Off by default, so every entry has a price.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/market/prices"

Example response

{
  "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"
  }
}

GET/market/prices/{itemdefid}copy URL

Canonical wiki price for one skin

One entry of /market/prices: `market_hash_name`, `price` (canonical wiki price, cents, null when Steam has no order book for it), `lowest_sell_order`, `highest_buy_order` and the blob's `generated_at`. Served from the same 5-minute blob, so it costs nothing extra to call per skin. 404 for an unknown id or a skin with no Steam market name.

ParameterInTypeDefaultDescription
itemdefid requiredpathintegerThe skin's item definition id. (min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/market/prices/10337"

Example response

{
  "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
}

GET/market/marketplacescopy URL

Every skin's price on every third-party marketplace

Current listing prices on the third-party marketplaces we poll directly (Skinport, CS.Deals, DMarket, Rust.tm, CS.Trade, Waxpeer, LIS-Skins, Mannco.store, Swap.gg, Tradeit.gg, RapidSkins, Loot.farm, RustSkins): `prices` is keyed by Steam `market_hash_name`, each value a `{marketplace: price}` map. UNLIKE the rest of the API these prices are USD floats (`unit: "usd"`, e.g. 12.34) - this payload predates the API and outside tooling already reads it. Only marketplaces whose poller is currently alive are included (`sources`, with each one's `polled_at`); a source that stopped polling is listed in `excluded_sources` with its last poll time instead of serving stale prices. Listings a marketplace reports as out of stock are omitted. Cached 5 minutes, matching the ~5-minute poll cycle.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/market/marketplaces"

Example response

{
  "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"
  }
}

GET/market/indexcopy URL

Skin market index series

The rust.wiki Market Index: a basket of skins rebased to 100 at the start of the window, like a stock index, built from Steam's daily price history (one point per day; weekly beyond two years). Returns `dates` (ISO dates), `values` (index level, 100 = the window's first day), `constituent_count` (skins that had a price at the baseline; baskets are capped at 300 constituents) and `label`. A skin whose history starts inside the window joins from its first price. Cached for 24 hours per parameter combination (history only gains a point every 6 hours); the full catalogue, every category and every collection are kept warm server-side.

ParameterInTypeDefaultDescription
basket_typequeryone of `all`, `high_value`, `low_value`, `category`, `collection`, `color`, `item`, `custom`allWhich 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).
basket_valuequerystringThe 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.
rangequeryone of `7d`, `30d`, `90d`, `1y`, `2y`, `3y`, `4y`, `5y`, `all`, `custom`90dWindow: `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.
start_datequerystringCustom range start (YYYY-MM-DD, inclusive). Only read when range=custom.
end_datequerystringCustom range end (YYYY-MM-DD, inclusive). Only read when range=custom.
weight_modequeryone of `equal`, `marketcap`equal`equal`: every constituent's % move counts the same. `marketcap`: weighted by price x Workshop subscribers, like an S&P-style index.
smoothquerybooleanFalseApply a trailing 30-day moving average.
trim_daysqueryinteger0Mask each constituent's first N days of history (0-90) to drop launch-week volatility. (max 90, min 0)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/market/index"

Example response

{
  "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"
}

GET/market/comparecopy URL

Overlay skins, baskets and indices on one date axis

The data behind rust.wiki/skins/compare: one shared `dates` axis and a `series` entry per token with `key`, `name`, `icon_url`, `is_basket`, `is_index` and `prices` aligned to the axis (null where that entry has no data yet). Skin and basket entries are prices in cents (a basket is the plain average of its members' prices); index entries are index levels rebased to 100. Spans over two years are downsampled to weekly points. Cached for 24 hours per parameter combination.

ParameterInTypeDefaultDescription
entries requiredquerystringComma-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 `.`). (min length 1, max length 400)
rangequeryone of `7d`, `30d`, `90d`, `1y`, `2y`, `3y`, `4y`, `5y`, `all`, `custom`90dWindow: `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.
start_datequerystringCustom range start (YYYY-MM-DD, inclusive). Only read when range=custom.
end_datequerystringCustom range end (YYYY-MM-DD, inclusive). Only read when range=custom.
smoothquerybooleanFalseApply a trailing 30-day moving average.
trim_daysqueryinteger0Mask each constituent's first N days of history (0-90) to drop launch-week volatility. (max 90, min 0)
index_weight_modequeryone of `equal`, `marketcap`equalWeighting for any `index:` entries (see /market/index).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/market/compare?entries=10337,10148,category:weapon"

Example response

{
  "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"
      ]
    }
  ]
}

GET/market/eventscopy URL

Collection and skin release dates for a chart's window

Release markers to draw on an index or compare chart: `events` of `{date, label, icon_url, kind}` where `kind` is `collection` (the day a collection's first skin was accepted into the item store, labelled with the collection name) or `item` (an individual skin's acceptance date, only when scoped). Scoped to the skins of the given basket or compare entries so only releases related to what is plotted are returned; unscoped returns every collection release in the window. There is no DLC concept in Steam's data - store-acceptance dates are the release signal. Cached for an hour (5 minutes when scoped by `entries`).

ParameterInTypeDefaultDescription
rangequeryone of `7d`, `30d`, `90d`, `1y`, `2y`, `3y`, `4y`, `5y`, `all`, `custom`90dWindow: `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.
start_datequerystringCustom range start (YYYY-MM-DD, inclusive). Only read when range=custom.
end_datequerystringCustom range end (YYYY-MM-DD, inclusive). Only read when range=custom.
basket_typequeryone of `all`, `high_value`, `low_value`, `category`, `collection`, `color`, `item`, `custom`Scope to an index basket (same meaning as /market/index). Omit both this and `entries` for every collection's release.
basket_valuequerystringThe basket's value (see /market/index).
entriesquerystringScope to a /market/compare token list instead of a basket.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/market/events"

Example response

{
  "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"
  ]
}

GET/market/collection-valuecopy URL

Total value of a collection over time

The cost of owning one of every skin in the collection, day by day: `dates` and `values` (total in cents) plus `count`, the number of member skins with price history in the window. A skin whose history starts mid-window contributes its first known price backwards, so early totals are not "the sum of fewer skins". This is the chart on rust.wiki/collections/{slug}. Cached 15 minutes so today's point tracks the scraper.

ParameterInTypeDefaultDescription
collection requiredquerystringExact collection name (see /skins/collections). (min length 1, max length 120)
rangequeryone of `7d`, `30d`, `90d`, `1y`, `2y`, `3y`, `4y`, `5y`, `all`90dWindow: `7d`, `30d`, `90d`, `1y`, `2y`, `3y`, `4y`, `5y` or `all`.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/market/collection-value?collection=Forest%20Raiders"

Example response

{
  "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
}

GET/market/dealscopy URL

Executable buy-on-marketplace, sell-on-Steam flips

Every skin that can be bought on a third-party marketplace for less than it nets on Steam Community Market right now, as rust.wiki/skins/deals computes it. Per deal: `buy_market` and `buy_price` (the cheapest in-stock listing we poll, cents), `sell_url` (the Steam listing page), the two Steam references `bid_gross`/`bid_net` (highest buy order, and what you actually receive after Steam's 15% fee) and `ask_gross`/`ask_net` (lowest sell order, same), then for the chosen `steam_ref`: `sell_price` (the net proceeds), `sell_gross`, `spread_abs` (cents) and `spread_pct`. Only rows profitable under the chosen reference are returned. A stale buy order above a fresher ask is capped at the ask. Filters combine with AND; `search` matches the skin name case-insensitively. Marketplace links are not included. Recomputed every ~5 minutes from the marketplace poll.

ParameterInTypeDefaultDescription
steam_refqueryone of `buy`, `sell`buySteam exit price: `buy` = sell instantly into the highest buy order (default), `sell` = list just under the lowest sell order.
sortqueryone of `pct`, `abs`pctBest `pct` (spread as % of buy price) or `abs` (spread in cents) first.
categoryqueryone of `weapon`, `clothing`, `deployable`, `decoration`, `crate`, `resource`, `mask`, `none`Only skins of this category.
marketplacequeryone of `Skinport`, `CSDealsMarketplace`, `DMarket`, `RustTM`, `CSTrade`, `Waxpeer`, `LISSkins`, `ManncoStore`, `SwapGGTrade`, `TradeitGG`, `RapidSkins`, `LootFarm`, `RustSkins`, `SkinSell`, `TradeRust`[][]Only deals whose cheapest listing is on one of these marketplaces (repeat the parameter).
min_pricequeryintegerMinimum buy price in cents.
max_pricequeryintegerMaximum buy price in cents.
searchquerystringCase-insensitive substring of the skin name (or Steam market name).
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/market/deals"

Example response

{
  "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"
}

GET/market/capcopy URL

Market cap of the Rust skin market

The rust.wiki Market Cap page as data: `total_value` (cents), `skin_count`, `unit_count`, `by_category` (`{category, value}`) and `top`, every skin ranked by value with `{itemdefid, name, icon_url, price, amount, value}`. Supply is not something Steam exposes, so `amount` is the skin's Steam Workshop subscriber count - a stated approximation (subscribing is not owning) - and `value` is price x amount. Only marketable skins with a live Steam price and a linked Workshop submission are included. Cached for 15 minutes.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/market/cap"

Example response

{
  "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"
  ]
}

GET/market/insightscopy URL

The rust.wiki Insights page: `stonking` - the 10 skins trading closest to (or above) their all-time high, `crashing` - the 10 closest to their all-time low (each `{itemdefid, name, icon_url, price, reference_price}`, cents; the reference is that skin's own all-time high or low from Steam's multi-year history, skins with under 30 history points excluded), and `anticipated` - the 50 marketable skins with the most Steam Workshop subscribers (`{itemdefid, name, icon_url, subscriptions}`). Refreshed with each price-history run, about every 6 hours.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/market/insights"

Example response

{
  "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"
  ]
}

GET/market/where-to-sellcopy URL

Where to sell Rust skins: the best cash payout per skin

The table on rust.wiki/skins/where-to-sell: for each skin, the best instant cash offer across the tracked marketplaces (buy orders and site buybacks), after the site's seller fee. Each row: `itemdefid`, `name`, `category`, `venue`/`venue_label` and `url` of the best cash offer, `gross` and `net` (cents, before/after the fee), `buyback` (the site buys it itself), `count` (how many it will take), `steam_net` (what selling on Steam leaves in your Steam wallet after its 15% fee - wallet money, not cash), `list_venue`/`list_net` (the best estimate for listing it and waiting) and `offers` (how many venues bid). Rebuilt with every marketplace poll.

ParameterInTypeDefaultDescription
qquerystringSubstring of the skin name.
categoryquerystringOne skin category: `weapon`, `clothing`, `deployable`, `decoration`, `crate`, `resource`, `mask`.
venuequerystringOnly skins whose best cash offer is on this marketplace (a `venue` value from the results).
min_payoutquerynumberOnly skins paying at least this many US DOLLARS after fees.
sortqueryone of `payout`, `cheap`, `steam`, `name`payout`payout` = highest cash payout first; `cheap` = lowest; `steam` = biggest gap where Steam (wallet money) pays more than cash; `name`.
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/market/where-to-sell"

Example response

{
  "page": 1,
  "per_page": 3,
  "total": 3014,
  "pages": 1005,
  "results": [
    {
      "itemdefid": 44706,
      "name": "Lightweight Pump Shotgun",
      "category": "weapon",
      "venue": null,
      "venue_label": null,
      "gross": null,
      "net": null,
      "buyback": false,
      "count": null,
      "steam_net": 223,
      "list_venue": null,
      "list_net": null,
      "offers": 1,
      "url": null,
      "skin_url": "https://rust.wiki/skin/44706"
    },
    {
      "itemdefid": 65104,
      "name": "Volcanic Stone Pick Axe",
      "category": "weapon",
      "venue": null,
      "venue_label": null,
      "gross": null,
      "net": null,
      "buyback": false,
      "count": null,
      "steam_net": 146,
      "list_venue": null,
      "list_net": null,
      "offers": 1,
      "url": null,
      "skin_url": "https://rust.wiki/skin/65104"
    },
    "…"
  ],
  "updated_at": 1794805163,
  "page_url": "https://rust.wiki/skins/where-to-sell"
}

GET/market/where-to-sell/{itemdefid}copy URL

Every way to sell one skin, and what each pays

The "Where to sell" table from the skin's page: `instant` - every buy order or site buyback you can sell into now (`venue`, `label`, `gross` and `net` cents after the site's `fee` %, `count` it will take, `buyback`, `url`); `list` - what listing it and waiting would bring (`gross`, `net`, `fee`, recent `sold` count over `days`); and `best_cash` - the best instant cash payout (Steam's is wallet money, not cash). `found=false` when no marketplace currently bids or lists it.

ParameterInTypeDefaultDescription
itemdefid requiredpathintegerThe skin's item definition id (find it with `/skins/search`). (min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/market/where-to-sell/10138"

Example response

{
  "itemdefid": 44706,
  "name": "Lightweight Pump Shotgun",
  "found": false,
  "instant": [],
  "list": [],
  "best_cash": null,
  "skin_url": "https://rust.wiki/skin/44706"
}

GET/market/below-breakdowncopy URL

Skins listed for less than the resources they break down into

The list on rust.wiki/skins/below-breakdown: skins whose cheapest listing costs less than the Cloth, Wood or Metal they give when broken down in game. Each row: the skin (`name`, `itemdefid`, `resource`, `qty` it breaks into, `value` of that at the resource's Steam price), `target` (the value to beat for `basis`), the cheapest qualifying listing (`best_market`, `best_price`, `best_qty`, `best_url`), `saving`/`saving_pct`, and up to three `others`. Marketplaces whose data is stale right now are left out, as on the page. `resource_prices` / `resource_net` give each resource's Steam price per unit.

ParameterInTypeDefaultDescription
resourcequeryone of `Cloth`, `Wood`, `Metal`Only skins that break down into this resource.
marketqueryone of `any`, `steam`any`any` marketplace (default) or only Steam listings.
basisqueryone of `gross`, `net`grossValue to beat: the resource's Steam listing price (`gross`), or what selling it on Steam actually leaves after the 15% fee (`net`).
sortqueryone of `pct`, `abs`, `price`, `name`pct`pct` = biggest saving %; `abs` = biggest saving in cents; `price` = cheapest; `name`.
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/market/below-breakdown"

Example response

{
  "page": 1,
  "per_page": 2,
  "total": 41,
  "pages": 21,
  "results": [
    {
      "itemdefid": 10010,
      "name": "Red Jacket",
      "category": "clothing",
      "resource": "Cloth",
      "qty": 1,
      "value": 16,
      "steam_price": 13,
      "sold7": null,
      "best_market": "SteamCommunityMarket",
      "best_price": 13,
      "best_qty": 4819,
      "others": [],
      "n_markets": 1,
      "target": 16,
      "saving": 3,
      "saving_pct": 18.8,
      "best_url": "https://steamcommunity.com/market/listings/252490/Red%20Jacket"
    },
    {
      "itemdefid": 10017,
      "name": "Green Beenie Hat",
      "category": "clothing",
      "resource": "Cloth",
      "qty": 1,
      "value": 16,
      "steam_price": 13,
      "sold7": null,
      "best_market": "SteamCommunityMarket",
      "best_price": 13,
      "best_qty": 5524,
      "others": [],
      "n_markets": 1,
      "target": 16,
      "saving": 3,
      "saving_pct": 18.8,
      "best_url": "https://steamcommunity.com/market/listings/252490/Green%20Beenie%20Hat"
    }
  ],
  "resource_prices": {
    "Cloth": 16,
    "Metal": 69,
    "Wood": 19
  },
  "resource_net": {
    "Cloth": 14,
    "Metal": 60,
    "Wood": 17
  },
  "stale_markets": [
    "CSBoard",
    "CSDealsMarketplace",
    "…"
  ],
  "page_url": "https://rust.wiki/skins/below-breakdown"
}

GET/market/chainscopy URL

Multi-market arbitrage loops (buy here, sell there, repeat)

The loops on rust.wiki/skins/chains: buy a skin on market X, sell it on Y, use that balance to buy something to sell back on X (up to four markets), where the after-fee rates multiply to more than 1. Each loop: `markets` in order, `legs` (the skin bought on each market and what it fetches on the next), `factor`, `cap` (the most starting money it carries at these top-of-book prices, cents - an estimate) and `profit` at that size (cents). Prices move: check every leg before trading. Rebuilt with every marketplace poll.

ParameterInTypeDefaultDescription
modequeryone of `all`, `instant`all`instant` = every sell leg goes into a buy order or buyback now; `all` also allows listing and waiting (slower, less certain).
startquerystringOnly loops through this marketplace, rotated to start there.
hopsqueryintegerOnly loops with exactly this many legs (2-4).
min_profitquerynumberOnly loops making at least this many US DOLLARS at their capacity.
sortqueryone of `profit`, `factor`, `size`, `hops`profit`profit` at capacity, `factor` (money multiplier), `size` (capacity), or fewest `hops`.
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/market/chains"

Example response

{
  "page": 1,
  "per_page": 2,
  "total": 0,
  "pages": 1,
  "results": [],
  "mode": "all",
  "updated_at": 1794805164,
  "max_hops": 4,
  "markets": [],
  "page_url": "https://rust.wiki/skins/chains"
}

GET/market/venuescopy URL

Every Rust skin marketplace: seller fee, payment and cash-out methods, activity

The directory on rust.wiki/marketplaces. `tracked` - the sites whose prices we read, busiest first: `label`, `domain`, seller `fee` %, `trade_site` (you trade with the site's bot instead of listing), `skins_listed`, `listings`, `listed_value` (cents), `buy_orders` and `buyback` (skins you can sell into now), `sales` (skins with recorded sales), `status` of our feed, and `pay` (`deposit` and `cashout` methods, `note`). `other_sites` - more Rust skin sites, payment methods only. Methods change often and vary by country: `checked` says when they were last confirmed; check on the site before relying on one. Steam pays out to your Steam Wallet only.

ParameterInTypeDefaultDescription
pay_withqueryone of `paypal`, `card`, `crypto`, `bank`, `ewallet`Only sites you can PAY with this kind of method on.
cash_outqueryone of `paypal`, `card`, `crypto`, `bank`, `ewallet`Only sites you can CASH OUT to this kind of method from.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/market/venues"

Example response

{
  "checked": "November 2026",
  "method_groups": {
    "paypal": "PayPal",
    "card": "Card",
    "crypto": "Crypto",
    "bank": "Bank transfer",
    "ewallet": "E-wallets"
  },
  "tracked": [
    {
      "venue": "RustTM",
      "label": "Rust.tm",
      "domain": "rust.tm",
      "fee": 5.0,
      "trade_site": false,
      "pay": {
        "deposit": [
          "Card",
          "UnionPay",
          "…"
        ],
        "cashout": null,
        "coins": "BTC",
        "note": "Cash-out options are only shown after you sign in."
      },
      "skins_listed": 4836,
      "listings": 28255,
      "listed_value": 73347540,
      "buy_orders": 0,
      "buyback": 0,
      "sales": 0,
      "status": "unknown"
    },
    {
      "venue": "SteamCommunityMarket",
      "label": "Steam",
      "domain": "steamcommunity.com",
      "fee": 13.04,
      "trade_site": false,
      "pay": {
        "deposit": [
          "Card",
          "PayPal",
          "…"
        ],
        "cashout": [],
        "note": "Sales go to your Steam Wallet, which can't be withdrawn."
      },
      "skins_listed": 5602,
      "listings": 358968,
      "listed_value": 68554952,
      "buy_orders": 5578,
      "buyback": 0,
      "sales": 0,
      "status": "ok"
    },
    "…"
  ],
  "other_sites": [
    {
      "label": "Skin.land",
      "domain": "skin.land",
      "kind": "Store + instant sell",
      "deposit": [
        "Card",
        "Apple Pay",
        "…"
      ],
      "cashout": [
        "Card",
        "SEPA",
        "…"
      ],
      "coins": "BTC, ETH, LTC, SOL, BCH, BNB, USDT, USDC"
    },
    {
      "label": "Avan.market",
      "domain": "avan.market",
      "kind": "Store + instant sell",
      "deposit": [
        "Card",
        "Crypto"
      ],
      "cashout": [
        "Card",
        "PayPal",
        "…"
      ],
      "coins": "BTC, ETH, LTC, SOL, TON, TRX, BNB, USDT, USDC"
    },
    "…"
  ],
  "page_url": "https://rust.wiki/marketplaces"
}

Charts

category charts · 2,000 requests/day

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.

GET/charts/price/{itemdefid}.pngcopy URL

Price history chart for one skin (line or candlestick)

Renders the skin's Steam sale-price history over the window as a PNG: a filled line of daily prices, or weekly candlesticks with `style=candle`. The axis is in the requested currency. 404 when the skin is unknown or has fewer than two history points in the window.

ParameterInTypeDefaultDescription
itemdefid requiredpathintegerSteam itemdefid of the skin.
rangequerystring3mWindow: 1d, 1w, 1m, 3m, 6m, 1y, 2y, 5y or all.
stylequerystringline`line` (daily closes) or `candle` (weekly OHLC candlesticks).
currencyquerystringUSDISO currency code for the y-axis (converted with the site's live rates); USD by default.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/charts/price/10138.png"

Returns: image/png - image/png image (about 42 KB)

GET/charts/index.pngcopy URL

Market index chart

The same index the /skins/index page and GET /market/index compute (baseline 100 at the start of the window, equal- or market-cap-weighted), drawn as a single filled line. Pair it with GET /market/index for the numbers and constituent count.

ParameterInTypeDefaultDescription
basket_typequerystringallall, high_value, low_value, category, collection, item or custom (comma-separated itemdefids in basket_value).
basket_valuequerystringThe category / collection name / item shortname / itemdefid list for that basket type.
rangequerystring90dWindow: 7d, 30d, 90d, 1y, 2y, 3y, 4y, 5y or all.
weight_modequerystringequal`equal` or `marketcap` weighting of constituents.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/charts/index.png"

Returns: image/png - image/png image (about 32 KB)

GET/charts/collection.pngcopy URL

Collection value chart

Equal-weighted index of every skin in the collection over the window, the chart the bot's /collection command posts. 404 for an unknown collection or too little history.

ParameterInTypeDefaultDescription
collection requiredquerystringCollection name exactly as GET /skins/collections lists it.
rangequerystring90dWindow: 7d, 30d, 90d, 1y, 2y, 3y, 4y, 5y or all.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/charts/collection.png?collection=Forest%20Raiders"

Returns: image/png - image/png image (about 42 KB)

GET/charts/compare.pngcopy URL

Compare up to four skins, baskets or indexes on one chart

Overlays the entries' daily price series (baskets as their average, indexes as index points) exactly as the /skins/compare page does, rendered with a legend. `indexed` is the only mode where a $0.30 and a $300 skin read on one axis.

ParameterInTypeDefaultDescription
entries requiredquerystringComma-separated entries, the same tokens GET /market/compare accepts: an itemdefid, `category:<name>`, `collection:<name>`, `item:<shortname>` or `index:all`. First four are drawn.
rangequerystring90dWindow: 7d, 30d, 90d, 1y, 2y, 3y, 4y, 5y or all.
modequerystringindexed`indexed` rebases every line to 100 at its first point (comparable); `price` draws raw USD prices.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/charts/compare.png?entries=10138,42007"

Returns: image/png - image/png image (about 58 KB)

Item store

category store · 10,000 requests/day

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.

GET/storecopy URL

What is purchasable in Rust's item store right now, in the three sections the wiki shows: `limited_time` (this week's rotation, most Workshop subscribers first), `general` (the permanent catalogue) and `dlc_packs` (bundles, by name). Each item carries `itemdefid`, `name`, `icon_url`, `category`, `store_price` (cents), `market_price` (its Steam Community Market price in cents, null when unlisted), `rarity`, `item_collection`, `creator_name`/`creator_avatar_url`, `subscriptions`, `est_supply` with `est_supply_source` (`workshop` subscribers for brand-new items, the market estimate otherwise), `base_item_name` and the usual flags. Also `recent_rotations` (the last six, newest first, `is_current` marks the open one), `active_rotation_id` and `next_rotation_at` (the open rotation's start + 7 days; rotations land on Thursdays). Steam's own purchase URL for any item is `https://store.steampowered.com/buyitem/252490/{itemdefid}/{quantity}\`. Cached 30 minutes.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/store"

Example response

{
  "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"
}

GET/store/historycopy URL

Past item-store rotations

Every weekly rotation, newest first (the open one included): `id` (the rotation slug, `YYYY-MM-DD-HHMM`, or `General` for the permanent catalogue), `name` (Facepunch's label when it had one, usually null), `start`, `end` (null while current), `itemdefid_count` and `icons` - every skin in it as `{url, name}`, DLC packs excluded. With `search`, only the rotations that sold a matching skin are returned (same shape, newest first), which answers "when was X in the store?". Full item lists via GET /store/rotations/{rotation_id}. Cached for an hour; searches are computed live.

ParameterInTypeDefaultDescription
searchquerystringOnly rotations that contained a skin whose name matches this (case-insensitive substring), e.g. `Tempered`.
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/store/history"

Example response

{
  "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"
  ]
}

GET/store/rotations/{rotation_id}copy URL

One rotation's full item list

One rotation as the wiki's /store/rotation page shows it: `rotation` (`id`, `name`, `start`, `end`, `itemdefid_count` - the number of items that still resolve in the catalogue) and its items split into `limited_time`, `general` and `dlc_packs`, each item in the same shape as GET /store, including today's `market_price` and `is_available_on_store` (a past rotation can still contain evergreen catalogue items). Cached for an hour.

ParameterInTypeDefaultDescription
rotation_id requiredpathstringRotation id from /store/history, e.g. `2017-07-13-2006`, or `General`. (max length 40)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/store/rotations/2017-07-13-2006"

Example response

{
  "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": []
}

Workshop

category workshop · 10,000 requests/day

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.

GET/workshopcopy URL

Browse or search Workshop submissions

One page of submissions. Each carries `workshopid` (the Steam published-file id), `title`, `author_steamid64`, `preview_image_url`, `submitted_at` (UTC ISO-8601, may be null), `accepted` and `accepted_itemdefid` (the in-game item definition id when Facepunch accepted it - use it with `/skins/{itemdefid}`), `target_item_tag`, `subscriptions` and `vote_score` (Steam's 0-1 score; both null when Steam has not reported them). Same filters, ordering and cache as the /workshop page.

ParameterInTypeDefaultDescription
searchquerystringCase-insensitive substring match on the submission title.
targetquerystringOnly submissions for this target item, exactly as the Workshop tags it (e.g. `AK47`, `Garage Door`); `/workshop/targets` lists every value.
sortqueryone of `newest`, `popular`newest`newest` = most recently submitted first; `popular` = most subscribers first.
acceptedqueryone of `any`, `yes`, `no`any`yes` = only submissions Facepunch accepted into the game; `no` = only ones it has not.
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/workshop"

Example response

{
  "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"
  ]
}

GET/workshop/targetscopy URL

The distinct `target_item_tag` values (alphabetical) - Steam's own Workshop tag text for the item a skin is made for, e.g. `AK47`, `Garage Door`. Pass one as the `target` filter of `/workshop`. The set only grows when Facepunch makes a new item skinnable; cached for 15 minutes.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/workshop/targets"

Example response

{
  "total": 154,
  "results": [
    "Acoustic Guitar",
    "AK47",
    "AK47 Skin",
    "… 151 more"
  ]
}

Reference data

category reference · 25,000 requests/day

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 and their Blueprint Fragment/Page/Book costs; every NPC vending shop and price, and what each monument holds (recyclers, shops, CCTV cameras, loot containers); 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 base's build cost + upkeep + sulfur to raid, power draw and the panels/turbines/batteries to run it, furnace smelting time and wood); every gun, bow and melee weapon's damage, DPS, fire rate, magazine, reload and range; every tea recipe with its berries and Mixing Table slot order; doors, walls and deployables ranked by sulfur to raid vs build cost; 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). Also: the loot simulator (open any crate, barrel or NPC with the game's own loot roll, seeded, plus exact chances; and expected loot for a run of crates, barrels and NPCs), the animal breeder (sheep/cow gene odds), farm planner, damage calculator (shots and time to kill through any armour), Bandit Camp Big Wheel odds and blackjack strategy, decay timer, excavator/quarry yields, launch options and key bind builders, conveyor filter and loot-room planner, circuit parts and the circuit simulator, the sulfur calculator, blueprint tracker, poker odds, door code generator and checker, crosshair codes, Rust's player count, and per-devblog update pages. Also: monument puzzles (keycard doors, fuses, switches, timers, reset timers, radiation and puzzle loot for every monument), food spoilage and composting, armour inserts and which clothing takes them, Frankenstein pet parts, and NPC missions with their rewards. Also: Rust's 102 official game and loading-screen tips in every rust.wiki language (Facepunch's own wording), every Steam achievement with the exact condition from the game code and its global unlock %, and the seasonal events (Advent Calendar rewards by day, Rust's birthday, Christmas, Halloween, Easter) with the server commands behind them. Also: vehicles (health, damage taken, fuel per minute, seats, storage, decay, vendor price, explosives to destroy), the bestiary (animals, NPCs and bosses: health, attacks, aggro range, speed, gather yields, loot), traps and turrets, world-event timers (Cargo Ship, Patrol Helicopter, Chinook, Bradley, airdrops, satellite, Deep Sea) with clan score, and Apartment Complex rent. Also: horses (every breed's gallop speed, health and spawn chance, a top-speed calculator for any breed and gear, stamina, food, saddles, horseshoes, horse armour, stables) and clan score (the events that earn points, who earns them, the clan.* settings, roles and limits). Also from the game files: every gesture with its console name and unlock, every DLC and Item Store pack with the items it unlocks, survival mechanics (healing, comfort and heat sources, food and water drain, radiation, fall damage) with a fall-damage calculator, and the playable instruments' notes and keyboard maps. Also: Rust's game modes (Vanilla, Softcore, Hardcore, Primitive) side by side and the Era system, with any item's Hardcore and era status. Also the base designer: price a whole Rust base (build and upgrade cost, upkeep, decay timers, HP) and find the cheapest raid path to its tool cupboard and loot. Also: the RustProfit blog's guides (latest posts, topics, one post's text), fishing, workbench upgrades, explosive splash and fire damage, stack sizes and despawn times for every item, the per-patch game-data changelog, and site-wide search across rust.wiki's pages, items, skins and monuments. Also the knowledge layer for AI assistants: `/learn` (start here - which endpoint answers which question), concept guides to how Rust works (`/learn/{topic}`), a glossary of Rust terms and slang, `/learn/whats-new`, one `/search` across everything with typed results, and everything about one item or monument in one call (`/items/{shortname}/full`, `/monuments/{slug}/full`). Also: every explosive's damage, blast radius, fuse, dud chance and fire, and the health, protection and raid cost of every deployable (auto turrets, boxes, tool cupboards...), from the server files.

GET/commandscopy URL

Console and server commands

One page of Rust console/server commands, alphabetical. Each carries `command`, `syntax`, `description`, `category` (Rust's own ConVar namespace, e.g. `server`, `gather`), `command_type` (`command` or `variable`), `default_value` (variables only) and `permission_required` (null when any player can run it). Cached for 30 minutes.

ParameterInTypeDefaultDescription
searchquerystringCase-insensitive substring match on the command name, its description OR its category (so `workbench` finds every workbench ConVar).
admin_onlyquerybooleanFalse`true` = only commands that need admin/moderator permission.
groupqueryone of `player`, `client`, `admin`, `server-variables`Who runs it: `player` (any player's F1 commands), `client` (your own game settings), `admin` (admin commands) or `server-variables` (server convars) - the /commands/<group> pages.
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/commands"

Example response

{
  "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"
  ]
}

GET/commands/give-itemscopy URL

Item shortnames for the give command

Live items as a copy-paste reference for `give <shortname> <amount>` and `inventory.giveto <player> <shortname> <amount>`: `shortname` is the exact string those commands expect, plus `display_name`, `category`, `icon_url` and `stack_size` (the maximum one stack holds). Alphabetical by display name; cached for 30 minutes.

ParameterInTypeDefaultDescription
categoryqueryone of `weapon`, `construction`, `general`, `resource`, `attire`, `tool`, `medical`, `food`, `ammo`, `trap`, `component`, `electrical`, `fun`, `misc`Restrict to one item category.
searchquerystringCase-insensitive substring match on the display name or shortname.
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/commands/give-items"

Example response

{
  "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://files.facepunch.com/rust/item/rifle.ak.glass_512.png",
      "stack_size": 1
    },
    "… 10 more"
  ]
}

GET/monumentscopy URL

Every fixed-location monument, alphabetical, in one response (no pagination - the set is 60 and static). Each carries `slug`, `name`, `tier` (1-3, null for safe zones and minor monuments), `is_safezone`, `has_radiation` and `radiation_level`, `recyclers` (count on site), `has_tunnel_entrance` (underground rail), `has_chinook_drop_zone`, `allows_patrol_heli_crash`, `no_build_area_sqm` and `icon_url`. Moving monuments (Cargo Ship) are not included. Cached for one hour.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/monuments"

Example response

{
  "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": null
    },
    {
      "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": null
    },
    {
      "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": null
    },
    "… 57 more"
  ]
}

GET/monuments/{slug}copy URL

One monument with its loot sources

The same fields as `/monuments` for one monument plus `loot_sources`: every crate/NPC loot table that spawns at it (`id`, `name`, `drop_count`), alphabetical - fetch each with `/loot-tables/{id}` - and `placements`: what the game's monument scenes put there, one entry per layout (most monuments have one): `recyclers` (`type` recycler/safe_zone/red, `count`, `efficiency_pct`, `seconds`), `vending` (NPC shops: `shop`, `order_set` - see /vending - and `title`), `cctv` (camera ids for the Computer Station) and `crates` (`name`, `source_id` for /loot-tables/{id}, `expected` = average number present with spawns filled, `spawn_points`). Cached for one hour.

ParameterInTypeDefaultDescription
slug requiredpathstringMonument slug from `/monuments`, e.g. `airfield`. (min length 1, max length 80)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/monuments/airfield"

Example response

{
  "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": null,
  "…": "2 more keys"
}

GET/vendingcopy URL

NPC vending machines and shopkeepers: every shop, offer and price

Every NPC shop in the game files (Outpost, Bandit Camp, fishing villages, stables, water wells, floating cities, the Travelling Vendor, plus order sets no standard monument uses). `order_sets` carry `key`, `title`, `offers` (`sell` item, `sell_amount`, `sell_bp`, `currency` item, `price`, `price_text`, and `random` - weight and price range - for shops that show 7 random offers: `picks`), and `where` (monuments, with `dynamic_pricing`). `locations` lists the shops per monument. Listed prices are the base: with dynamic pricing (the default) a scrap price starts at double on a fresh map and drifts between half and double with demand every few hours; water-well shopkeepers, the Travelling Vendor and deep-sea vendors keep the listed price. With `item`, `sold` and `bought` list just that item's offers. Cached for one hour.

ParameterInTypeDefaultDescription
itemquerystringOnly offers that sell this item or take it as payment (shortname, e.g. `rifle.ak` or `scrap`).
monumentquerystringOnly the shops at this monument (slug from `/monuments`, e.g. `outpost`).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/vending"

Example response

{
  "build": "26498655",
  "order_set_count": 1,
  "order_sets": [
    {
      "key": "BuyResources",
      "title": "Scrap 4 Sale",
      "picks": null,
      "offer_count": 7,
      "offers": [
        {
          "sell": {
            "shortname": "scrap",
            "name": "Scrap",
            "icon_url": "https://files.facepunch.com/rust/item/scrap_512.png",
            "has_page": true
          },
          "sell_amount": 1,
          "sell_bp": false,
          "currency": {
            "shortname": "crude.oil",
            "name": "Crude Oil",
            "icon_url": "https://files.facepunch.com/rust/item/crude.oil_512.png",
            "has_page": true
          },
          "price": 6,
          "random": null,
          "price_text": "6 Crude Oil"
        },
        {
          "sell": {
            "shortname": "scrap",
            "name": "Scrap",
            "icon_url": "https://files.facepunch.com/rust/item/scrap_512.png",
            "has_page": true
          },
          "sell_amount": 1,
          "sell_bp": false,
          "currency": {
            "shortname": "metal.fragments",
            "name": "Metal Fragments",
            "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_512.png",
            "has_page": true
          },
          "price": 20,
          "random": null,
          "price_text": "20 Metal Fragments"
        },
        {
          "sell": {
            "shortname": "scrap",
            "name": "Scrap",
            "icon_url": "https://files.facepunch.com/rust/item/scrap_512.png",
            "has_page": true
          },
          "sell_amount": 2,
          "sell_bp": false,
          "currency": {
            "shortname": "metal.refined",
            "name": "High Quality Metal",
            "icon_url": "https://files.facepunch.com/rust/item/metal.refined_512.png",
            "has_page": true
          },
          "price": 1,
          "random": null,
          "price_text": "1 High Quality Metal"
        },
        "… 4 more"
      ],
      "where": [
        {
          "monument": "bandit-camp",
          "monument_name": "Bandit Camp",
          "shop": "Scrap 4 Sale",
          "dynamic_pricing": true
        }
      ],
      "placed": true
    }
  ],
  "locations": [
    {
      "monument": "bandit-camp",
      "name": "Bandit Camp",
      "shops": [
        {
          "shop": "Black Market",
          "order_set": "Weapons_Bandit",
          "title": "Black Market / Bandit Weapons",
          "count": 1,
          "dynamic_pricing": true
        },
        {
          "shop": "Building Supplies",
          "order_set": "building_bandit",
          "title": "Building Supplies (Bandit Camp)",
          "count": 1,
          "dynamic_pricing": true
        },
        {
          "shop": "Farming",
          "order_set": "Bandit_Farming",
          "title": "Farming",
          "count": 1,
          "dynamic_pricing": true
        },
        "… 4 more"
      ]
    }
  ],
  "page": "https://rust.wiki/vending",
  "item": "metal.refined",
  "sold": [],
  "bought": [
    {
      "order_set": "BuyResources",
      "title": "Scrap 4 Sale",
      "placed": true,
      "picks": null,
      "where": [
        {
          "monument": "bandit-camp",
          "monument_name": "Bandit Camp",
          "shop": "Scrap 4 Sale",
          "dynamic_pricing": true
        }
      ],
      "sell_amount": 2,
      "sell_bp": false,
      "price": 1,
      "price_text": "1 High Quality Metal",
      "random": false,
      "sell": {
        "shortname": "scrap",
        "name": "Scrap",
        "icon_url": "https://files.facepunch.com/rust/item/scrap_512.png",
        "has_page": true
      }
    }
  ]
}

GET/loot-tablescopy URL

Every loot source (crates, NPCs, barrels)

One page of loot sources, alphabetical. Each carries `id`, `name` (Facepunch's own loot-table name, e.g. `Elite Tier Crate`), `drop_count` (how many distinct items it can drop) and `icons` (the icons of its four likeliest drops). Fetch the full drop table with `/loot-tables/{id}`. Cached for 30 minutes.

ParameterInTypeDefaultDescription
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/loot-tables"

Example response

{
  "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"
  ]
}

GET/loot-tables/{source_id}copy URL

One loot table with every drop

The loot source's `id` and `name` plus `drops`, highest chance first: for each item `shortname`, `display_name`, `icon_url`, `chance_pct` (0-100), `amount_min`/`amount_max` and, for items that spawn damaged, `condition_min_pct`/`condition_max_pct`. Scraped from wiki.facepunch.com; cached for 30 minutes.

ParameterInTypeDefaultDescription
source_id requiredpathintegerLoot source id from `/loot-tables`, `/monuments/{slug}` or an item's `loot_sources`. (min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/loot-tables/1"

Example response

{
  "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
    }
  ]
}

GET/cctv-codescopy URL

The 12 monuments with working CCTV cameras and their Computer Station identifiers (60 codes). `codes` are the literal in-game console codes; when `randomized` is true the trailing `****` is a per-wipe random 4-digit suffix posted near the camera in-game, not a fixed code. `slug` links to `/monuments/{slug}` (null for Cargo Ship, which is a moving monument). Fixed reference data.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/cctv-codes"

Example response

{
  "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"
  ]
}

GET/worldcopy URL

World entities: animals, NPCs, resource nodes

One page of world entities (anything not tied to one monument), alphabetical. Each carries `slug`, `display_name`, `is_npc`, `npc_hp` (null for resources) and `icon_url`. Cached for one hour.

ParameterInTypeDefaultDescription
kindqueryone of `npc`, `resource``npc` = anything with hit points (animals, scientists, bosses, vehicles); `resource` = nodes, trees, barrels and other harvestables.
searchquerystringCase-insensitive substring match on the display name.
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/world"

Example response

{
  "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": null
    },
    {
      "slug": "airfield-scientist",
      "display_name": "Airfield Scientist",
      "is_npc": true,
      "npc_hp": 150.0,
      "icon_url": null
    },
    {
      "slug": "arctic-research-base-scientist",
      "display_name": "Arctic Research Base Scientist",
      "is_npc": true,
      "npc_hp": 150.0,
      "icon_url": null
    },
    "… 22 more"
  ]
}

GET/world/{slug}copy URL

One world entity with its loot

The entity's `slug`, `display_name`, `is_npc`, `npc_hp`, `icon_url` and `loot_source_id` (null when it drops nothing), plus `drops` - its five likeliest drops (`shortname`, `display_name`, `icon_url`, `chance_pct`, `amount_min`, `amount_max`) - and `drop_count`, the full number of distinct drops. The complete table is `/loot-tables/{loot_source_id}`. Cached for one hour.

ParameterInTypeDefaultDescription
slug requiredpathstringEntity slug from `/world`, e.g. `bear`. (min length 1, max length 80)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/world/bear"

Example response

{
  "slug": "bear",
  "display_name": "Bear",
  "is_npc": false,
  "npc_hp": null,
  "loot_source_id": 94,
  "icon_url": null,
  "drops": [],
  "drop_count": 0
}

GET/buildingcopy URL

Building pieces by grade

One page of building pieces (every grade of every block: foundations, walls, floors, doorways, stairs, roofs,...), alphabetical. Each carries `slug`, `display_name`, `grade` (Twig, Wood, Stone, Metal, Armored or Boat), `health` and `decay_hours` (how long an unmaintained piece takes to decay fully). Cached for one hour.

ParameterInTypeDefaultDescription
gradequeryone of `Twig`, `Wood`, `Stone`, `Metal`, `Armored`, `Boat`Restrict to one building grade.
searchquerystringCase-insensitive substring match on the display name.
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/building"

Example response

{
  "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"
  ]
}

GET/building/best-valuecopy URL

Doors, walls and deployables ranked by sulfur to raid vs build cost

The data behind https://rust.wiki/building/best-value. `doors`, `walls` (walls, foundations and floors at every grade) and `other` (raidable deployables), each hardest to raid first. Every row has `slug`, `name`, `health`, `raid` - the cheapest single standard explosive (rockets, C4, satchel charges, explosive 5.56 ammo, beancans) as `explosive` (shortname), `count` and `sulfur` - and `build`, resource name -> amount (a building block's upgrade cost at its grade, a door's or deployable's crafting recipe). Building blocks add `grade` and `type`; doors and deployables add `shortname`, `icon_url` and `url`. `explosives` names the shortnames. Raid data cached for 24 hours.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/building/best-value"

GET/building/{slug}copy URL

One building piece: costs, durability, siblings

The piece's `slug`, `display_name`, `grade`, `health` and `decay_hours`, plus `costs` (`build`, `repair` and `upkeep` lists of `item_name`, `amount` or `min_amount`/`max_amount`, with `shortname`/`icon_url` when the material maps to a catalogue item), `durability` (up to ten entries each for `explosive`, `melee` and `bullet` damage: `item_name`, `seconds_taken` to destroy, `required_items` = how many of that weapon/explosive) and `siblings` - the same piece at every other grade, Twig to Armored. Cached for one hour.

ParameterInTypeDefaultDescription
slug requiredpathstringPiece slug from `/building`, e.g. `stone-wall`. (min length 1, max length 80)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/building/stone-wall"

Example response

{
  "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://files.facepunch.com/rust/item/knife.combat_512.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"
  ]
}

GET/tech-tree/{tree}copy URL

One tech tree: nodes and prerequisite edges

The full research graph for one workbench, from the game's own tech tree data. Every node costs ONE research item, never scrap: `currency` says which - a Blueprint Fragment (Workbench Level 1 and Engineering Workbench), a Blueprint Page (Level 2) or a Blueprint Book (Level 3) - at default server settings (a server can add a tax). Unlocking a node also unlocks every locked node on the cheapest route back to the tree's start, one item each. `nodes` carry `id`, `shortname`, `name`, `icon_url`, `cost` (1), `path_cost` (items to unlock it from scratch with everything before it), `inputs` (prerequisite node ids - any one is enough) and `x`/`y`: LAYOUT PIXELS (the top-left of a 110x78 card, see `card_size`) from the game's own graph positions. `edges` are the prerequisite links (`from_id` before `to_id`) with the card-centre endpoints `x1`,`y1`,`x2`,`y2` the page draws. `unlinked` lists nodes that are in the tree's data but have no route from its start (mostly moved to the Engineering Workbench tree). Node ids are only stable until the tree is re-seeded. Cached for one hour.

ParameterInTypeDefaultDescription
tree requiredpathone of `workbench1`, `workbench2`, `workbench3`, `engineering`Which research graph: Workbench Level 1/2/3 or the Engineering Workbench.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/tech-tree/workbench1"

Example response

{
  "tree": "workbench1",
  "label": "Workbench Level 1",
  "card_size": {
    "width": 110,
    "height": 78
  },
  "currency": {
    "shortname": "blueprintfragment",
    "name": "Blueprint Fragment",
    "plural": "Blueprint Fragments",
    "icon_url": null
  },
  "node_count": 98,
  "edge_count": 96,
  "total_cost": 98,
  "nodes": [
    {
      "id": 918,
      "shortname": "hammer.salvaged",
      "name": "Salvaged Hammer",
      "icon_url": "https://files.facepunch.com/rust/item/hammer.salvaged_512.png",
      "cost": 1,
      "path_cost": 1,
      "inputs": [
        1132
      ],
      "x": 1384.0,
      "y": 40.0
    },
    {
      "id": 1000,
      "shortname": "shirt.tanktop",
      "name": "Tank Top",
      "icon_url": "https://files.facepunch.com/rust/item/shirt.tanktop_512.png",
      "cost": 1,
      "path_cost": 1,
      "inputs": [
        1132
      ],
      "x": 1640.0,
      "y": 40.0
    },
    {
      "id": 790,
      "shortname": "bucket.water",
      "name": "Water Bucket",
      "icon_url": "https://files.facepunch.com/rust/item/bucket.water_512.png",
      "cost": 1,
      "path_cost": 1,
      "inputs": [
        1132
      ],
      "x": 2408.0,
      "y": 40.0
    },
    "… 95 more"
  ],
  "edges": [
    {
      "from_id": 918,
      "to_id": 917,
      "x1": 1439.0,
      "y1": 79.0,
      "x2": 287.0,
      "y2": 271.0
    },
    {
      "from_id": 918,
      "to_id": 963,
      "x1": 1439.0,
      "y1": 79.0,
      "x2": 479.0,
      "y2": 271.0
    },
    {
      "from_id": 918,
      "to_id": 1113,
      "x1": 1439.0,
      "y1": 79.0,
      "x2": 1247.0,
      "y2": 271.0
    },
    "… 93 more"
  ],
  "unlinked": [
    {
      "id": 1012,
      "shortname": "smallengine",
      "name": "Small Boat Engine",
      "icon_url": "https://files.facepunch.com/rust/item/smallengine_512.png"
    },
    {
      "id": 794,
      "shortname": "carburetor1",
      "name": "Low Quality Carburetor",
      "icon_url": "https://files.facepunch.com/rust/item/carburetor1_512.png"
    },
    {
      "id": 814,
      "shortname": "crankshaft1",
      "name": "Low Quality Crankshaft",
      "icon_url": "https://files.facepunch.com/rust/item/crankshaft1_512.png"
    },
    "… 45 more"
  ]
}

GET/design-notescopy URL

Design notes from The Art of Rust

Curated trivia paraphrased from The Art of Rust (Facepunch Studios / Dark Horse Books, January 2026): design inspirations, cut content and in-universe lore. Each note carries `id`, `chapter`, `title`, `text` (an original paraphrase, never a quotation), `page` (the book page cited), `tags` (the wiki pages it belongs to) and `cut_content`. Text only - the book's artwork is never reproduced. Fixed editorial data.

ParameterInTypeDefaultDescription
chapterqueryone of `Characters`, `Bases & World`, `Weapons & Tech`, `Vehicles`, `Events & DLC`Restrict to one chapter of the book.
tagquerystringOnly notes tagged for one wiki page: `item:<shortname>`, `monument:<slug>`, `building:<slug>` or `world:<slug>`.
cutqueryboolean`true` = only notes about cut/unshipped content; `false` = only notes about shipped content.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/design-notes"

Example response

{
  "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
    }
  ]
}

GET/calculators/craftcopy URL

The dataset behind the craft calculator: `items` maps every item shortname to `name`, `icon_url`, `craftable` and `recipe` (direct components as `shortname` + `quantity`; empty for non-craftables). Resolve a recipe recursively through the same map to get raw-material totals, exactly as the page's accumulator does. Cached for 30 minutes.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/craft"

Example response

{
  "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"
  }
}

GET/calculators/recyclecopy URL

Recycle calculator dataset: every recycler yield

The dataset behind the recycle calculator: `items` maps every recyclable item's shortname to `name`, `icon_url`, `base` (each output's amount per item at 100% efficiency - a recycler gives that times its efficiency) and `yields`, split by recycler type: `recycler` (the standard monument recycler, 50%, 5 s a cycle), `safe_zone` (Outpost, Bandit Camp, floating cities: 40%, 8 s), `powered` (any monument recycler while the Power Plant's grid is at stage 2+, i.e. 4+ heavy fuses: 60%; 4.5 s at stage 4) and `red` (the Power Plant's red recycler: 75%, 4 s, needs grid stage 4). Each yield is `shortname`, `name`, `icon_url`, `quantity` and `chance` (0-1 probability of that output; a fractional amount is a guaranteed row plus a chance of one more). `recycler_types` describes the four. Cached for 30 minutes.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/recycle"

Example response

{
  "total": 852,
  "recycler_types": [
    {
      "key": "recycler",
      "label": "Monument recycler",
      "short": "Monument",
      "efficiency": 0.5,
      "seconds": 5.0,
      "note": "The standard recycler at monuments. Default when the Power Plant grid is below stage 2."
    },
    {
      "key": "safe_zone",
      "label": "Safe-zone recycler",
      "short": "Safe zone",
      "efficiency": 0.4,
      "seconds": 8.0,
      "note": "Outpost, Bandit Camp and the floating cities. Nobody can shoot you, but it gives less and is slower."
    },
    {
      "key": "powered",
      "label": "Monument recycler, Power Plant grid stage 2+",
      "short": "Grid 2+",
      "efficiency": 0.6,
      "seconds": 5.0,
      "note": "Every monument recycler on the map gives 60% once 4 heavy fuses power the Power Plant's grid (stage 2), and cycles in 4.5 s at stage 4 (18 fuses)."
    },
    "… 1 more"
  ],
  "items": {
    "ammo.shotgun": {
      "name": "12 Gauge Buckshot",
      "icon_url": "https://files.facepunch.com/rust/item/ammo.shotgun_512.png",
      "base": {
        "metal.fragments": 2.5,
        "gunpowder": 5.0
      },
      "yields": {
        "recycler": [
          {
            "shortname": "metal.fragments",
            "name": "Metal Fragments",
            "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_512.png",
            "quantity": 1,
            "chance": 1
          },
          {
            "shortname": "metal.fragments",
            "name": "Metal Fragments",
            "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_512.png",
            "quantity": 1,
            "chance": 0.25
          },
          {
            "shortname": "gunpowder",
            "name": "Gun Powder",
            "icon_url": "https://files.facepunch.com/rust/item/gunpowder_512.png",
            "quantity": 2,
            "chance": 1
          },
          "… 1 more"
        ],
        "safe_zone": [
          {
            "shortname": "metal.fragments",
            "name": "Metal Fragments",
            "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_512.png",
            "quantity": 1,
            "chance": 1
          },
          {
            "shortname": "gunpowder",
            "name": "Gun Powder",
            "icon_url": "https://files.facepunch.com/rust/item/gunpowder_512.png",
            "quantity": 2,
            "chance": 1
          }
        ],
        "powered": [
          {
            "shortname": "metal.fragments",
            "name": "Metal Fragments",
            "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_512.png",
            "quantity": 1,
            "chance": 1
          },
          {
            "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
          }
        ],
        "red": [
          {
            "shortname": "metal.fragments",
            "name": "Metal Fragments",
            "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_512.png",
            "quantity": 1,
            "chance": 1
          },
          {
            "shortname": "metal.fragments",
            "name": "Metal Fragments",
            "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_512.png",
            "quantity": 1,
            "chance": 0.875
          },
          {
            "shortname": "gunpowder",
            "name": "Gun Powder",
            "icon_url": "https://files.facepunch.com/rust/item/gunpowder_512.png",
            "quantity": 3,
            "chance": 1
          },
          "… 1 more"
        ]
      }
    },
    "ammo.shotgun.fire": {
      "name": "12 Gauge Incendiary Shell",
      "icon_url": "https://files.facepunch.com/rust/item/ammo.shotgun.fire_512.png",
      "base": {
        "sulfur": 10.0,
        "metal.fragments": 2.5,
        "gunpowder": 5.0
      },
      "yields": {
        "recycler": [
          {
            "shortname": "sulfur",
            "name": "Sulfur",
            "icon_url": "https://files.facepunch.com/rust/item/sulfur_512.png",
            "quantity": 5,
            "chance": 1
          },
          {
            "shortname": "metal.fragments",
            "name": "Metal Fragments",
            "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_512.png",
            "quantity": 1,
            "chance": 1
          },
          {
            "shortname": "metal.fragments",
            "name": "Metal Fragments",
            "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_512.png",
            "quantity": 1,
            "chance": 0.25
          },
          "… 2 more"
        ],
        "safe_zone": [
          {
            "shortname": "sulfur",
            "name": "Sulfur",
            "icon_url": "https://files.facepunch.com/rust/item/sulfur_512.png",
            "quantity": 4,
            "chance": 1
          },
          {
            "shortname": "metal.fragments",
            "name": "Metal Fragments",
            "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_512.png",
            "quantity": 1,
            "chance": 1
          },
          {
            "shortname": "gunpowder",
            "name": "Gun Powder",
            "icon_url": "https://files.facepunch.com/rust/item/gunpowder_512.png",
            "quantity": 2,
            "chance": 1
          }
        ],
        "powered": [
          {
            "shortname": "sulfur",
            "name": "Sulfur",
            "icon_url": "https://files.facepunch.com/rust/item/sulfur_512.png",
            "quantity": 6,
            "chance": 1
          },
          {
            "shortname": "metal.fragments",
            "name": "Metal Fragments",
            "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_512.png",
            "quantity": 1,
            "chance": 1
          },
          {
            "shortname": "metal.fragments",
            "name": "Metal Fragments",
            "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_512.png",
            "quantity": 1,
            "chance": 0.5
          },
          "… 1 more"
        ],
        "red": [
          {
            "shortname": "sulfur",
            "name": "Sulfur",
            "icon_url": "https://files.facepunch.com/rust/item/sulfur_512.png",
            "quantity": 7,
            "chance": 1
          },
          {
            "shortname": "sulfur",
            "name": "Sulfur",
            "icon_url": "https://files.facepunch.com/rust/item/sulfur_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
          },
          "… 3 more"
        ]
      }
    },
    "ammo.shotgun.slug": {
      "name": "12 Gauge Slug",
      "icon_url": "https://files.facepunch.com/rust/item/ammo.shotgun.slug_512.png",
      "base": {
        "metal.fragments": 2.5,
        "gunpowder": 5.0
      },
      "yields": {
        "recycler": [
          {
            "shortname": "metal.fragments",
            "name": "Metal Fragments",
            "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_512.png",
            "quantity": 1,
            "chance": 1
          },
          {
            "shortname": "metal.fragments",
            "name": "Metal Fragments",
            "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_512.png",
            "quantity": 1,
            "chance": 0.25
          },
          {
            "shortname": "gunpowder",
            "name": "Gun Powder",
            "icon_url": "https://files.facepunch.com/rust/item/gunpowder_512.png",
            "quantity": 2,
            "chance": 1
          },
          "… 1 more"
        ],
        "safe_zone": [
          {
            "shortname": "metal.fragments",
            "name": "Metal Fragments",
            "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_512.png",
            "quantity": 1,
            "chance": 1
          },
          {
            "shortname": "gunpowder",
            "name": "Gun Powder",
            "icon_url": "https://files.facepunch.com/rust/item/gunpowder_512.png",
            "quantity": 2,
            "chance": 1
          }
        ],
        "powered": [
          {
            "shortname": "metal.fragments",
            "name": "Metal Fragments",
            "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_512.png",
            "quantity": 1,
            "chance": 1
          },
          {
            "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
          }
        ],
        "red": [
          {
            "shortname": "metal.fragments",
            "name": "Metal Fragments",
            "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_512.png",
            "quantity": 1,
            "chance": 1
          },
          {
            "shortname": "metal.fragments",
            "name": "Metal Fragments",
            "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_512.png",
            "quantity": 1,
            "chance": 0.875
          },
          {
            "shortname": "gunpowder",
            "name": "Gun Powder",
            "icon_url": "https://files.facepunch.com/rust/item/gunpowder_512.png",
            "quantity": 3,
            "chance": 1
          },
          "… 1 more"
        ]
      }
    },
    "…": "849 more keys"
  }
}

GET/calculators/blueprintscopy URL

Blueprint tracker dataset: Research Table scrap and tech tree costs

The dataset behind the blueprint tracker. `groups` maps an unlock source to its blueprints: `Research Table` (`scrap_cost`: 20/40/100/300 scrap by rarity, 10 for a default blueprint) and one group per tech tree (`Workbench Level 1 - Tech Tree`... `Engineering Workbench - Tech Tree`). Tech tree entries cost research items, not scrap: `cost` (1) of `cost_item` (blueprintfragment, blueprintpage or blueprintbook), and `path_cost` = items to unlock it from scratch along the cheapest route, with `tree` and `node_id`. `trees` is each tree's graph (`nodes` with `inputs`) for working out what a route costs from a given set of unlocked blueprints - or use /calculators/blueprints/progress. `currencies` names the three research items. An item appears under every source it can be learned from. Cached for 30 minutes.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/blueprints"

Example response

{
  "total": 912,
  "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
      },
      "… 610 more"
    ],
    "Workbench Level 1 - Tech Tree": [
      {
        "shortname": "hammer.salvaged",
        "name": "Salvaged Hammer",
        "icon_url": "https://files.facepunch.com/rust/item/hammer.salvaged_512.png",
        "scrap_cost": null,
        "tree": "workbench1",
        "node_id": 918,
        "cost": 1,
        "cost_item": "blueprintfragment",
        "path_cost": 1
      },
      {
        "shortname": "shirt.tanktop",
        "name": "Tank Top",
        "icon_url": "https://files.facepunch.com/rust/item/shirt.tanktop_512.png",
        "scrap_cost": null,
        "tree": "workbench1",
        "node_id": 1000,
        "cost": 1,
        "cost_item": "blueprintfragment",
        "path_cost": 1
      },
      {
        "shortname": "bucket.water",
        "name": "Water Bucket",
        "icon_url": "https://files.facepunch.com/rust/item/bucket.water_512.png",
        "scrap_cost": null,
        "tree": "workbench1",
        "node_id": 790,
        "cost": 1,
        "cost_item": "blueprintfragment",
        "path_cost": 1
      },
      "… 91 more"
    ],
    "Workbench Level 2 - Tech Tree": [
      {
        "shortname": "hazmatsuit",
        "name": "Hazmat Suit",
        "icon_url": "https://files.facepunch.com/rust/item/hazmatsuit_512.png",
        "scrap_cost": null,
        "tree": "workbench2",
        "node_id": 1109,
        "cost": 1,
        "cost_item": "blueprintpage",
        "path_cost": 1
      },
      {
        "shortname": "longsword",
        "name": "Longsword",
        "icon_url": "https://files.facepunch.com/rust/item/longsword_512.png",
        "scrap_cost": null,
        "tree": "workbench2",
        "node_id": 950,
        "cost": 1,
        "cost_item": "blueprintpage",
        "path_cost": 1
      },
      {
        "shortname": "shoes.boots",
        "name": "Boots",
        "icon_url": "https://files.facepunch.com/rust/item/shoes.boots_512.png",
        "scrap_cost": null,
        "tree": "workbench2",
        "node_id": 1001,
        "cost": 1,
        "cost_item": "blueprintpage",
        "path_cost": 2
      },
      "… 87 more"
    ],
    "Workbench Level 3 - Tech Tree": [
      {
        "shortname": "wall.window.bars.toptier",
        "name": "Reinforced Glass Window",
        "icon_url": "https://files.facepunch.com/rust/item/wall.window.bars.toptier_512.png",
        "scrap_cost": null,
        "tree": "workbench3",
        "node_id": 738,
        "cost": 1,
        "cost_item": "blueprintbook",
        "path_cost": 1
      },
      {
        "shortname": "door.hinged.toptier",
        "name": "Armored Door",
        "icon_url": "https://files.facepunch.com/rust/item/door.hinged.toptier_512.png",
        "scrap_cost": null,
        "tree": "workbench3",
        "node_id": 724,
        "cost": 1,
        "cost_item": "blueprintbook",
        "path_cost": 2
      },
      {
        "shortname": "rifle.sks",
        "name": "SKS",
        "icon_url": "https://files.facepunch.com/rust/item/rifle.sks_512.png",
        "scrap_cost": null,
        "tree": "workbench3",
        "node_id": 987,
        "cost": 1,
        "cost_item": "blueprintbook",
        "path_cost": 2
      },
      "… 17 more"
    ],
    "Engineering Workbench - Tech Tree": [
      {
        "shortname": "electric.switch",
        "name": "Switch",
        "icon_url": "https://files.facepunch.com/rust/item/electric.switch_512.png",
        "scrap_cost": null,
        "tree": "engineering",
        "node_id": 876,
        "cost": 1,
        "cost_item": "blueprintfragment",
        "path_cost": 1
      },
      {
        "shortname": "generator.water",
        "name": "Water Wheel",
        "icon_url": "https://files.facepunch.com/rust/item/generator.water_512.png",
        "scrap_cost": null,
        "tree": "engineering",
        "node_id": 1127,
        "cost": 1,
        "cost_item": "blueprintfragment",
        "path_cost": 2
      },
      {
        "shortname": "electric.solarpanel.large",
        "name": "Large Solar Panel",
        "icon_url": "https://files.facepunch.com/rust/item/electric.solarpanel.large_512.png",
        "scrap_cost": null,
        "tree": "engineering",
        "node_id": 870,
        "cost": 1,
        "cost_item": "blueprintfragment",
        "path_cost": 3
      },
      "… 92 more"
    ]
  },
  "trees": {
    "workbench1": {
      "label": "Workbench Level 1",
      "currency": "blueprintfragment",
      "nodes": [
        {
          "id": 918,
          "shortname": "hammer.salvaged",
          "inputs": [
            1132
          ]
        },
        {
          "id": 1000,
          "shortname": "shirt.tanktop",
          "inputs": [
            1132
          ]
        },
        {
          "id": 790,
          "shortname": "bucket.water",
          "inputs": [
            1132
          ]
        },
        "… 95 more"
      ]
    },
    "workbench2": {
      "label": "Workbench Level 2",
      "currency": "blueprintpage",
      "nodes": [
        {
          "id": 1109,
          "shortname": "hazmatsuit",
          "inputs": [
            1131
          ]
        },
        {
          "id": 950,
          "shortname": "longsword",
          "inputs": [
            1131
          ]
        },
        {
          "id": 928,
          "shortname": "hoodie",
          "inputs": [
            1109
          ]
        },
        "… 87 more"
      ]
    },
    "workbench3": {
      "label": "Workbench Level 3",
      "currency": "blueprintbook",
      "nodes": [
        {
          "id": 738,
          "shortname": "wall.window.bars.toptier",
          "inputs": [
            1130
          ]
        },
        {
          "id": 724,
          "shortname": "door.hinged.toptier",
          "inputs": [
            738
          ]
        },
        {
          "id": 987,
          "shortname": "rifle.sks",
          "inputs": [
            738
          ]
        },
        "… 17 more"
      ]
    },
    "engineering": {
      "label": "Engineering Workbench",
      "currency": "blueprintfragment",
      "nodes": [
        {
          "id": 876,
          "shortname": "electric.switch",
          "inputs": [
            1129
          ]
        },
        {
          "id": 1127,
          "shortname": "generator.water",
          "inputs": [
            876
          ]
        },
        {
          "id": 870,
          "shortname": "electric.solarpanel.large",
          "inputs": [
            1127
          ]
        },
        "… 93 more"
      ]
    }
  },
  "currencies": {
    "blueprintfragment": {
      "shortname": "blueprintfragment",
      "name": "Blueprint Fragment",
      "plural": "Blueprint Fragments",
      "icon_url": null,
      "has_page": false
    },
    "blueprintpage": {
      "shortname": "blueprintpage",
      "name": "Blueprint Page",
      "plural": "Blueprint Pages",
      "icon_url": null,
      "has_page": false
    },
    "blueprintbook": {
      "shortname": "blueprintbook",
      "name": "Blueprint Book",
      "plural": "Blueprint Books",
      "icon_url": null,
      "has_page": false
    }
  }
}

GET/calculators/upkeepcopy URL

Upkeep decay brackets and decay times

Rust's dedicated-server upkeep defaults (the `decay.bracket_*` and `decay.duration_*` ConVars, as most servers run them). `brackets` are applied in order to a base's block count: the first 15 blocks cost 10% of their build cost per day, the next 50 cost 15%, the next 125 cost 20%, and every block beyond 190 costs 33.3% (`blocks` null = unbounded); a base's blended daily rate is the block-weighted average of the brackets it fills, paid in the resources each piece was built from. `decay_hours` is how long an unmaintained piece of each grade takes to decay completely. Fixed constants, no computation happens server-side.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/upkeep"

Example response

{
  "brackets": [
    {
      "blocks": 15,
      "rate": 0.1
    },
    {
      "blocks": 50,
      "rate": 0.15
    },
    {
      "blocks": 125,
      "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_*)."
}

GET/calculators/raidcopy URL

Raid cost table: explosives and sulfur per building piece

The dataset behind the raid calculator. `explosives` lists every explosive the building durability data covers: `shortname`, `name`, `icon_url`, `group` (`staples`, `other` or `siege`), `staple` (true for rockets, C4, satchel charges, explosive 5.56 ammo and beancans - the page's default set), `sulfur_per_unit` and `raw_cost_per_unit` (the crafting recipe resolved down to raw resources such as sulfur, charcoal, metal fragments and low grade fuel, per single unit; both null for loot-only explosives like MLRS rockets), `batch` (units one craft makes: explosive ammo 2, mortar shells 2) and `recipe_source` (`wiki` = the wiki's own crafting data, `fallback` = Rust's standard recipe where that data has none yet, e.g. rockets). `targets` is every building piece with explosive data (`slug`, `name`, `grade`, `health`), each with `costs` - for every explosive that can damage it, `required` (how many destroy one piece), `damage_per_unit` and `sulfur` (null for loot-only) - and `cheapest_staple`, the single staple explosive that destroys it for the least sulfur. Damage from different explosives adds up, so a cheaper mix can be computed from `damage_per_unit` - or use /calculators/raid/compute, which runs the page's own mix search. Doors, hatches, high walls and other deployables are included as grade `Deployable` (the `grade` filter takes building grades). Cached for 24 hours.

ParameterInTypeDefaultDescription
gradequeryone of `Twig`, `Wood`, `Stone`, `Metal`, `Armored`, `Boat`Restrict `targets` to one building grade.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/raid"

Example response

{
  "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"
  ]
}

GET/calculators/craft/computecopy URL

Raw materials to craft a list of items

Resolves every recipe down to raw materials, per unit (items made in batches, like gunpowder, are divided by their batch size), exactly as the craft calculator page does. `raw_materials` is the total, largest first; `items` echoes each input with its direct recipe; `unknown` lists inputs that matched no item.

ParameterInTypeDefaultDescription
items requiredquerystringComma-separated `shortname:quantity` pairs (display names work too; quantity defaults to 1). (min length 1, max length 2000)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/craft/compute?items=rocket:4,explosive.timed:2"

GET/calculators/recycle/computecopy URL

What recycling a list of items yields

Expected outputs (quantity x per-unit yield x chance) per input and in total, for the chosen recycler type (the standard monument recycler unless you say otherwise).

ParameterInTypeDefaultDescription
items requiredquerystringComma-separated `shortname:quantity` pairs (display names work too; quantity defaults to 1). (min length 1, max length 2000)
recyclerqueryone of `recycler`, `safe_zone`, `powered`, `red`recycler`recycler` (standard monument recycler, 50%), `safe_zone` (Outpost/Bandit Camp/floating cities, 40%), `powered` (monument recycler with the Power Plant grid at stage 2+, 60%) or `red` (the Power Plant's red recycler, 75%, needs grid stage 4).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/recycle/compute?items=gears:10,metalpipe:5"

Example response

{
  "recycler": "recycler",
  "items": [
    {
      "shortname": "gears",
      "name": "Gears",
      "quantity": 10,
      "yields": [
        {
          "shortname": "metal.fragments",
          "name": "Metal Fragments",
          "expected": 120,
          "per_unit": 12,
          "chance": 1
        },
        {
          "shortname": "metal.fragments",
          "name": "Metal Fragments",
          "expected": 5,
          "per_unit": 1,
          "chance": 0.5
        },
        {
          "shortname": "scrap",
          "name": "Scrap",
          "expected": 100,
          "per_unit": 10,
          "chance": 1
        }
      ]
    },
    {
      "shortname": "metalpipe",
      "name": "Metal Pipe",
      "quantity": 5,
      "yields": [
        {
          "shortname": "metal.refined",
          "name": "High Quality Metal",
          "expected": 5,
          "per_unit": 1,
          "chance": 1
        },
        {
          "shortname": "scrap",
          "name": "Scrap",
          "expected": 25,
          "per_unit": 5,
          "chance": 1
        }
      ]
    }
  ],
  "totals": [
    {
      "shortname": "metal.fragments",
      "name": "Metal Fragments",
      "expected": 125
    },
    {
      "shortname": "scrap",
      "name": "Scrap",
      "expected": 125
    },
    {
      "shortname": "metal.refined",
      "name": "High Quality Metal",
      "expected": 5
    }
  ],
  "unknown": [],
  "note": "Expected values: outputs with a chance below 1 average out over many recycles."
}

GET/calculators/raid/computecopy URL

Explosives needed to destroy a set of building pieces

The raid calculator page's plan (https://rust.wiki/calculators/raid). Targets are building pieces (slugs from /building), doors, hatches, high walls and other deployables (slug or item shortname, e.g. `door.hinged.metal`). `plan` is what the page shows: per piece every allowed explosive's count and sulfur, the cheapest single explosive, and the cheapest MIX when combining explosives saves sulfur; then the totals - `total_sulfur`, `explosives_to_craft` (with crafts for batch recipes) and `raw_resources` - and a `page` link to the same plan. `options` / `cheapest` are single-explosive totals over every piece at once (one explosive for the whole raid). Deployables the building data lacks (auto turrets, boxes, tool cupboards, furnaces...: item shortname or name) come back under `game_data_deployables`, from the server files: per target every explosive's `count`, `sulfur` and `cheapest`, plus `single_explosive_totals`.

ParameterInTypeDefaultDescription
targets requiredquerystringComma-separated `slug:count` building pieces (slugs from /building, or display names). (min length 1, max length 2000)
explosivesquerystringstaples`staples` (rockets, C4, satchels, explosive ammo, beancans), `all`, or a comma list of explosive shortnames.
modequeryone of `mix`, `single`mix`mix` (the page's default: mixing explosives on a piece when that saves sulfur) or `single` (one explosive per piece).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/raid/compute?targets=stone-wall:2,sheet-metal-wall:1"

Example response

{
  "targets": [
    {
      "slug": "stone-wall",
      "name": "Stone Wall",
      "grade": "Stone",
      "count": 2,
      "cheapest_staple": {
        "explosive": "explosive.timed",
        "required": 2,
        "sulfur": 4400
      }
    }
  ],
  "options": [
    {
      "explosive": "explosive.timed",
      "name": "Timed Explosive Charge",
      "units": 4,
      "sulfur": 8800,
      "loot_only": false
    },
    {
      "explosive": "ammo.rifle.explosive",
      "name": "Explosive 5.56 Rifle Ammo",
      "units": 370,
      "sulfur": 9250,
      "loot_only": false
    },
    {
      "explosive": "explosive.satchel",
      "name": "Satchel Charge",
      "units": 20,
      "sulfur": 9600,
      "loot_only": false
    },
    "… 2 more"
  ],
  "cheapest": {
    "explosive": "explosive.timed",
    "name": "Timed Explosive Charge",
    "units": 4,
    "sulfur": 8800,
    "loot_only": false
  },
  "unknown": [
    "sheet-metal-wall"
  ],
  "explosives": "staples",
  "note": "options/cheapest are single-explosive totals over every piece; \`plan\` is the page's own plan (the cheapest explosive or mix per piece).",
  "plan": {
    "mode": "mix",
    "pieces": 2,
    "targets": [
      {
        "slug": "stone-wall",
        "name": "Stone Wall",
        "grade": "Stone",
        "health": 500,
        "count": 2,
        "options": [
          {
            "explosive": "ammo.rocket.basic",
            "name": "Rocket",
            "needed": 8,
            "sulfur": 11200,
            "loot_only": false
          },
          {
            "explosive": "explosive.timed",
            "name": "Timed Explosive Charge",
            "needed": 4,
            "sulfur": 8800,
            "loot_only": false
          },
          {
            "explosive": "explosive.satchel",
            "name": "Satchel Charge",
            "needed": 20,
            "sulfur": 9600,
            "loot_only": false
          },
          "… 2 more"
        ],
        "plan": {
          "kind": "mix",
          "items": [
            {
              "explosive": "explosive.timed",
              "count": 2
            },
            {
              "explosive": "ammo.rifle.explosive",
              "count": 168
            }
          ],
          "sulfur": 8600
        },
        "single_alternative": {
          "explosive": "explosive.timed",
          "count": 4,
          "sulfur": 8800
        }
      }
    ],
    "total_sulfur": 8600,
    "explosives_to_craft": [
      {
        "explosive": "explosive.timed",
        "name": "Timed Explosive Charge",
        "count": 2,
        "sulfur": 4400
      },
      {
        "explosive": "ammo.rifle.explosive",
        "name": "Explosive 5.56 Rifle Ammo",
        "count": 168,
        "sulfur": 4200,
        "crafts": 84,
        "batch": 2
      }
    ],
    "raw_resources": [
      {
        "shortname": "sulfur",
        "name": "Sulfur",
        "amount": 8600
      },
      {
        "shortname": "charcoal",
        "name": "Charcoal",
        "amount": 11040
      },
      {
        "shortname": "metal.fragments",
        "name": "Metal Fragments",
        "amount": 1240
      },
      "… 3 more"
    ],
    "page": "https://rust.wiki/calculators/raid?t=stone-wall:2"
  }
}

GET/calculators/upkeep/computecopy URL

The upkeep calculator page's math: the block count walks Rust's default upkeep brackets to a blended daily rate, and each resource's daily upkeep is what was spent building times that rate (`per_week` = 7 days).

ParameterInTypeDefaultDescription
blocks requiredqueryintegerNumber of building blocks (foundations, walls, floors... each counts one). (max 100000, min 1)
woodquerynumber0Total wood spent building the base. (min 0)
stonequerynumber0Total stone spent. (min 0)
metal_fragmentsquerynumber0Total metal fragments spent. (min 0)
high_quality_metalquerynumber0Total high quality metal spent. (min 0)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/upkeep/compute?blocks=VALUE"

GET/calculators/base/computecopy URL

Build cost, daily upkeep and raid cost of a base

The base cost calculator page's math (https://rust.wiki/calculators/base). `build_cost` is the total resources (a block's upgrade cost at its grade, a door's crafting recipe); `upkeep` is the tool cupboard's daily and weekly cost on the building blocks at Rust's default brackets (the same result as /calculators/upkeep/compute); `raid_path` gives each layer's cheapest standard explosive and the total sulfur to reach the loot. `unknown` lists inputs that matched nothing.

ParameterInTypeDefaultDescription
pieces requiredquerystringComma-separated `slug:count` pieces: building blocks by grade slug from /building (`stone-wall`, `metal-foundation`...) and doors or deployables by slug or item shortname (`door.hinged.metal`). Display names work too. (min length 1, max length 2000)
raid_pathquerystringOptional: the layers a raider breaks through from outside to the loot, in order, same naming as `pieces` (`:n` repeats a layer).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/base/compute?pieces=stone-foundation:4,stone-wall:7,stone-wall-doorway:1,stone-floor:4,door.hinged.metal:1"

GET/calculators/electricitycopy URL

Electricity data: every component's power draw, sources and batteries

The data behind https://rust.wiki/calculators/electricity. `consumers` and `logic` list every powered component with `shortname`, `name`, `draw` (power it needs to run) and `note`; logic parts (switches, gates, timers, splitters, branches...) have drawn 0 since April 2024. `sources` are the generators (`max` = best-case output, `sizing` says what that assumes) and `batteries` give `capacity` (rWm) and `max_output` (rW). `mechanics` explains how Rust power flows; `verified` is when the numbers were last checked and `sources_cited` where. Fixed data, re-checked after Facepunch balance patches.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/electricity"

GET/calculators/electricity/computecopy URL

Power draw of a set of components, and what runs it

The electricity calculator page's math. `total_draw` is the summed power; `supply` says how many of each power source covers it at its best output (`needed`); `batteries` gives each battery's `runtime_minutes` on a full charge, or `enough_output: false` when the load is above what that battery can deliver.

ParameterInTypeDefaultDescription
components requiredquerystringComma-separated `shortname:quantity` pairs (display names work too; quantity defaults to 1). Components by shortname or name from /calculators/electricity. (min length 1, max length 2000)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/electricity/compute?components=autoturret:4,samsite:1,electric.heater:2"

GET/calculators/smeltingcopy URL

Smelting data: furnace speeds, fuel and slots

The data behind https://rust.wiki/calculators/smelting. Each of `smelters` (furnace, large furnace, electric furnace, small oil refinery) has `input_slots`, `fuel`, `wood_per_second` and `rates` per ore key (`metal_ore`, `sulfur_ore`, `hqm_ore`, `crude_oil`): `seconds_per_unit` for the WHOLE oven (since Rust's October 2022 rework every slot shares the oven's speed, so splitting ore doesn't help), `output` and `yield`. `charcoal_per_wood` is the average charcoal a burned wood leaves; `stack` is each ore's stack size.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/smelting"

GET/calculators/smelting/computecopy URL

Smelting time, wood burned and charcoal made

The smelting calculator page's math: `time`/`seconds` to smelt everything, `outputs` (metal fragments, sulfur, HQM, low grade fuel), `wood_burned` and `charcoal_made` (about 0.75 per wood), `power_draw` for the electric furnace, and `fits_one_fill` (false = you'll need to refill it). Ore a smelter can't process is listed in `not_smeltable_here`. Server-default speeds; modded servers differ.

ParameterInTypeDefaultDescription
smelterqueryone of `furnace`, `furnace.large`, `electric.furnace`, `small.oil.refinery`, `bbq`, `campfire`, `fireplace.stone`, `hobobarrel`, `skull_fire_pit`, `cursedcauldron`furnace.largeWhich smelter (item shortname).
metal_orequerynumber0Metal ore to smelt. (max 10000000, min 0)
sulfur_orequerynumber0Sulfur ore to smelt. (max 10000000, min 0)
hqm_orequerynumber0High quality metal ore to smelt. (max 10000000, min 0)
crude_oilquerynumber0Crude oil to refine (small oil refinery only). (max 10000000, min 0)
countqueryinteger1How many of that smelter share the ore. (max 100, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/smelting/compute"

GET/calculators/genetics/bestcopy URL

Best crossbreeding layout from a pool of plant clones

The gene calculator's beam search, ported exactly: which clones to plant around the centre, how many of each, and what the centre will most likely become (with every outcome's chance). Uses the game's gene weights (red W/X 1.0, green G/Y/H 0.6).

ParameterInTypeDefaultDescription
clones requiredquerystringComma-separated 6-letter gene strings of the clones you have (G Y H W X). (min length 6, max length 400)
targetquerystringOptional 6-letter target such as GGGGYY; default: as many G and Y as possible.
centrequerystringOptional genes of the plant in the centre slot (default: unknown).
max_neighboursqueryinteger8Most neighbouring plants to use (a planter grid allows 8). (max 8, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/genetics/best?clones=GGYYHX,GYYHWW,YYGGXH"

GET/calculators/genetics/predictcopy URL

What a plant will grow into from its neighbours

Every possible result for the centre plant with its probability, most likely first.

ParameterInTypeDefaultDescription
neighbours requiredquerystringComma-separated 6-letter gene strings of the neighbouring plants. (min length 6, max length 200)
centrequerystringGenes of the centre plant, if known.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/genetics/predict?neighbours=GGYYHX,GGYYHX,YYGGXH"

GET/teascopy URL

Every tea recipe: berries, Mixing Table slot order, buff and duration

The data behind https://rust.wiki/teas. Each tea has `name`, `shortname`, `tier` (Basic, Advanced, Pure), `ingredients` (`item`, `qty`, `shortname`), `slot_order` / `slots` (the Mixing Table order for Basic teas - order matters: Scrap and Warming Tea use the same berries), `effect`, `duration_minutes` and `note` (Advanced and Pure values predate Rust's 5 Nov 2026 tea nerf). `notes` covers stacking and mixing rules. Sourced from Facepunch's wiki and devblogs (`sources`, `verified`).

ParameterInTypeDefaultDescription
searchquerystringCase-insensitive match on the tea's name or effect.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/teas"

GET/weaponscopy URL

Every weapon's damage, DPS, fire rate, magazine, reload and range

The data behind https://rust.wiki/weapons: every gun, bow, launcher and main melee weapon with `damage` per bullet/pellet (standard ammo), `pellets` (shotguns), `hit` (damage x pellets), raw `dps` (hit x `rpm` / 60 - ignores reloads, recoil, armour and falloff), `magazine`, `reload_s`, `range_m` (damage falloff start-end) / `range_end`, `ammo`, `workbench` (level to craft; null = loot only, 0 = no bench) and `notes`. Checked against Facepunch's wiki and patch notes (`sources`, `verified`); Facepunch rebalances weapons often.

ParameterInTypeDefaultDescription
categoryqueryone of `Rifle`, `Machine gun`, `SMG`, `Pistol`, `Sniper`, `Shotgun`, `Bow`, `Other`, `Launcher`, `Melee`Restrict to one weapon type.
sortqueryone of `dps`, `hit`, `damage`, `rpm`, `magazine`, `reload_s`, `range_end`, `name`dpsSort key: highest first, except `name` and `reload_s` (lowest first).
searchquerystringCase-insensitive match on the weapon name.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/weapons"

GET/guides/searchcopy URL

Search the RustProfit blog's Rust guides

Published guides from blog.rustprofit.com (monuments, recyclers, farming, base building, raiding, gear, NPCs, wipes, update explainers), best match first: every word must appear somewhere in the guide, and title matches rank above summary and tag matches, which rank above body-text matches. Link the `url` when citing one.

ParameterInTypeDefaultDescription
q requiredquerystringWords to find in guide titles, summaries, tags and text. (min length 2, max length 100)
limitqueryinteger5Most results to return. (max 20, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/guides/search?q=recycler%20locations"

Example response

{
  "query": "recycler locations",
  "total": 5,
  "results": [
    {
      "title": "Rust Recycler Locations: Every Monument With a Recycler",
      "url": "https://blog.rustprofit.com/rust-recycler-locations-guide",
      "summary": "Every recycler in Rust: Outpost (3), Bandit Camp (2), Airfield, Power Plant and Sewer Branch (2 each), both Harbors, Train Yard and 16 more monuments.",
      "tags": [
        "monuments",
        "guide"
      ],
      "published": "2026-06-19"
    },
    {
      "title": "Recycler vs. Research Table vs. Repair Bench: What Each One Actually Does",
      "url": "https://blog.rustprofit.com/recycler-vs-research-table-vs-repair-bench",
      "summary": "The difference between Rust's Recycler, Research Table, and Repair Bench — what each one is for and when to use which.",
      "tags": [
        "crafting",
        "guide"
      ],
      "published": "2026-06-24"
    }
  ]
}

GET/dropscopy URL

Current Rust Twitch and Kick drops

The live drops campaigns (Twitch and Kick: round, dates, general and streamer drops with the skin each one gives), the most valuable drop skins ever by Steam price, and past rounds - the data behind rust.wiki/drops.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/drops"

GET/updatescopy URL

Facepunch's Rust updates and devblogs

Every post from rust.facepunch.com/news, newest first. Each carries `slug`, `title`, `summary`, `category` (`devblog`, `news`, `update`,...), `published_date` (UTC date), `thumbnail_url`, `url` (the official post, or this network's own write-up when `has_blog_post` is true) and `has_blog_post`. Polled every few minutes; the first page is refreshed the moment a new post is found.

ParameterInTypeDefaultDescription
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/updates"

Example response

{
  "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"
  ]
}

GET/currency/ratescopy URL

USD exchange rates the site prices with

The live rates every rust.wiki currency switcher converts USD prices through, for the currencies the switcher offers. Each row carries `code` (ISO 4217), `name`, `symbol`, `flag` (ISO country code), `rate` (units of that currency per 1 USD) and `inverse` (USD per unit). Sourced from open.er-api.com and refreshed about every 15 minutes; USD itself is included at 1.0.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/currency/rates"

Example response

{
  "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"
  ]
}

GET/calculators/loot-simulator/computecopy URL

Expected loot from a run of crates, barrels and NPCs

The loot simulator page's exact statistics (https://rust.wiki/calculators/loot-simulator): every item each container can drop is rolled on its own chance, with an amount between the table's min and max. For the whole run, each item gets `expected_amount` (average total), `chance_at_least_one` and `best_chance_per_container`; `expected_item_stacks` is how many item stacks the run gives on average. Chances come from the game's loot tables (the /loot-tables data). To actually open crates with the game's own loot roll (seeded, shareable, with exact per-open chances), use /calculators/loot-simulator/open.

ParameterInTypeDefaultDescription
run requiredquerystringComma-separated `source:count` pairs - a loot source by id (from /loot-tables) or name - count defaults to 1, max 500 each. (min length 1, max length 1000)
searchquerystringOnly items whose name contains this.
limitqueryinteger100Most items to return (by expected amount). (max 500, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/loot-simulator/compute?run=Elite%20Crate:3,Military%20Crate:5"

Example response

{
  "run": [
    {
      "id": 116,
      "name": "Elite Crate",
      "count": 3
    },
    {
      "id": 57,
      "name": "Military Crate",
      "count": 5
    }
  ],
  "containers": 8,
  "expected_item_stacks": 28.982,
  "items": [
    {
      "shortname": "scrap",
      "name": "Scrap",
      "icon": "https://files.facepunch.com/rust/item/scrap_512.png",
      "expected_amount": 115.0,
      "chance_at_least_one": 1.0,
      "best_chance_per_container": 1.0,
      "url": "https://rust.wiki/item/scrap"
    },
    {
      "shortname": "metal.refined",
      "name": "High Quality Metal",
      "icon": "https://files.facepunch.com/rust/item/metal.refined_512.png",
      "expected_amount": 32.4694,
      "chance_at_least_one": 0.848278,
      "best_chance_per_container": 0.27725,
      "url": "https://rust.wiki/item/metal.refined"
    },
    {
      "shortname": "metalpipe",
      "name": "Metal Pipe",
      "icon": "https://files.facepunch.com/rust/item/metalpipe_512.png",
      "expected_amount": 8.3255,
      "chance_at_least_one": 0.848278,
      "best_chance_per_container": 0.27725,
      "url": "https://rust.wiki/item/metalpipe"
    },
    "… 97 more"
  ],
  "items_total": 152,
  "page": "https://rust.wiki/calculators/loot-simulator?r=116x3&r=57x5"
}

GET/calculators/loot-simulator/opencopy URL

Open a crate, barrel or NPC 1-1,000 times with the game's loot roll

Opens a Rust container with the loot roll ported from the game's server code (LootContainer.PopulateLoot -> LootSpawn.SpawnIntoContainer -> Item.MoveToContainer; data from the server files, vanilla settings) - the engine of https://rust.wiki/calculators/loot-simulator. Returns the haul: `items` totals (amount, how many opens had it, average condition for items that spawn damaged), `scrap_value` (everything recycled at `recycler`, all the way down, plus loot scrap), `lost_for_room` (loot destroyed because the container was full, as in game), the first `breakdown` opens one by one, and `chance_per_open`: every item's exact chance of at least one per open and its average amount (`chance_basis` says when a container that can fill up was simulated instead). `page` opens the same result on the site. A seed reproduces a result; it doesn't predict a real server.

ParameterInTypeDefaultDescription
container requiredquerystringContainer key or name, e.g. locked-crate, elite-crate, supply-drop, bradley-crate, heli-crate, military-crate, blue-barrel, scientist, heavy-scientist. A wrong name lists every key. (min length 2, max length 80)
countqueryinteger1How many to open (1-1,000). (max 1000, min 1)
seedquerystringa-z0-9 seed; the same container, count and seed always give the same loot (here and on the page). Random if left out.
breakdownqueryinteger5How many of the opens to list one by one. (max 50, min 0)
recyclerquerystringrecyclerRecycler for scrap_value: recycler (monument, 50%), safe_zone (40%), powered (Power Plant grid stage 2+, 60%) or red (75%).
chancesqueryinteger25How many rows of the exact chance-per-open table to include. (max 300, min 0)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/loot-simulator/open?container=locked-crate"

Example response

{
  "container": {
    "key": "locked-crate",
    "name": "Locked Crate",
    "kind": "container",
    "slots": 24,
    "scrap": 0,
    "loot_table": "https://rust.wiki/loot-table/48"
  },
  "count": 100,
  "seed": "abc123",
  "items": [
    {
      "shortname": "blueprintbook",
      "name": "Blueprint Book",
      "amount": 200,
      "opens_with": 100
    },
    {
      "shortname": "clothing.mod.armorinsert_metal",
      "name": "Metal Armor Insert",
      "amount": 100,
      "opens_with": 100
    },
    {
      "shortname": "metal.facemask",
      "name": "Metal Facemask",
      "amount": 66,
      "opens_with": 59
    },
    "… 116 more"
  ],
  "distinct_items": 119,
  "total_amount": 13438,
  "scrap_value": 24877.7,
  "recycler": "recycler",
  "opens": [
    {
      "open": 1,
      "items": [
        {
          "shortname": "rifle.sks",
          "name": "SKS",
          "amount": 1
        },
        {
          "shortname": "metal.facemask",
          "name": "Metal Facemask",
          "amount": 1
        },
        {
          "shortname": "aiming.module.mlrs",
          "name": "Aiming Module",
          "amount": 1
        },
        "… 13 more"
      ],
      "scrap_value": 180.0
    },
    {
      "open": 2,
      "items": [
        {
          "shortname": "weapon.mod.lasersight",
          "name": "Weapon Lasersight",
          "amount": 1
        },
        {
          "shortname": "metal.plate.torso",
          "name": "Metal Chest Plate",
          "amount": 1
        },
        {
          "shortname": "aiming.module.mlrs",
          "name": "Aiming Module",
          "amount": 1
        },
        "… 9 more"
      ],
      "scrap_value": 349.5
    },
    {
      "open": 3,
      "items": [
        {
          "shortname": "explosive.timed",
          "name": "Timed Explosive Charge",
          "amount": 1
        },
        {
          "shortname": "metal.plate.torso",
          "name": "Metal Chest Plate",
          "amount": 1
        },
        {
          "shortname": "grenade.f1",
          "name": "F1 Grenade",
          "amount": 3
        },
        "… 14 more"
      ],
      "scrap_value": 267.5
    },
    "… 2 more"
  ],
  "chance_per_open": [
    {
      "shortname": "blueprintbook",
      "name": "Blueprint Book",
      "chance": 1.0,
      "average": 2.0,
      "chance_in_count": 1.0
    },
    {
      "shortname": "clothing.mod.armorinsert_metal",
      "name": "Metal Armor Insert",
      "chance": 1.0,
      "average": 1.0,
      "chance_in_count": 1.0
    },
    {
      "shortname": "targeting.computer",
      "name": "Targeting Computer",
      "chance": 0.556145,
      "average": 0.5883,
      "chance_in_count": 1.0
    },
    "… 22 more"
  ],
  "chance_basis": "simulated (200,000 opens; this container can fill up)",
  "game_build": "26498655",
  "…": "1 more keys"
}

GET/player-countcopy URL

Rust's player count: live on Steam, every monthly peak since 2013, by region

The data behind https://rust.wiki/player-count. `live` is Steam's own count of everyone running Rust at the last check (`updated_at`); `months` is every monthly peak since 2013 as [YYYY-MM, peak] (from SteamCharts' public record of Steam's numbers); `record` the all-time monthly peak; `years` each year's peak; `this_month` and `same_month_last_year` for comparison; `breakdown` / `regions` split the players on the servers rust.wiki polls by region and server type (null when the server poll has nothing). Server players are always fewer than Steam's figure: Steam also counts menus, queues and untracked servers.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/player-count"

Example response

{
  "live": 92772,
  "updated_at": 1794612874,
  "source_url": "https://steamcharts.com/app/252490",
  "months": [
    [
      "2013-12",
      22571
    ],
    [
      "2014-01",
      51872
    ],
    [
      "2014-02",
      58973
    ],
    "… 153 more"
  ],
  "record": {
    "month": "2025-01",
    "peak": 259646
  },
  "years": [
    {
      "year": "2026",
      "peak": 246562,
      "month": "2026-01"
    },
    {
      "year": "2025",
      "peak": 259646,
      "month": "2025-01"
    },
    {
      "year": "2024",
      "peak": 191133,
      "month": "2024-12"
    },
    "… 11 more"
  ],
  "this_month": 156861,
  "this_ym": "2026-11",
  "same_month_last_year": 184595,
  "last_year_ym": "2025-11",
  "breakdown": {
    "players": 92665,
    "queued": 1420,
    "servers": 23793,
    "countries": [
      {
        "code": "US",
        "players": 30817,
        "queued": 1236,
        "servers": 4550
      },
      {
        "code": "GB",
        "players": 27162,
        "queued": 56,
        "servers": 1455
      },
      {
        "code": "RU",
        "players": 11147,
        "queued": 17,
        "servers": 5068
      },
      "… 116 more"
    ],
    "regions": {
      "eu": 40687,
      "na": 32096
    },
    "types": {
      "official": {
        "players": 6988,
        "servers": 91
      },
      "community": {
        "players": 74895,
        "servers": 23473
      },
      "modded": {
        "players": 10782,
        "servers": 229
      }
    }
  },
  "regions": [
    {
      "key": "eu",
      "label": "Europe",
      "url": "https://servers.rustprofit.com/region/eu",
      "players": 40687
    },
    {
      "key": "na",
      "label": "North America",
      "url": "https://servers.rustprofit.com/region/na",
      "players": 32096
    },
    {
      "key": "rest",
      "label": "Rest of the world",
      "url": null,
      "players": 19882
    }
  ],
  "…": "1 more keys"
}

GET/calculators/animal-breeder/computecopy URL

Sheep and cow breeding odds: genes, inbreeding, twins, wool/milk

The animal breeder page's maths (https://rust.wiki/calculators/animal-breeder). Each gene has two copies and the animal shows the better one; the young gets one random copy of each gene from each parent, so `young_odds` per gene is the chance it shows good / ok / bad. It also gets one random family mark from each parent and is inbred when they match (`chance_inbred`; null when marks weren't given). `chance_all_good_not_inbred`, `chance_twins` (needs a good-fertility mother) and `expected_product_per_hour` (wool or milk, inbreeding counted) follow. Gene numbers come from fan tools that read the game files (`gene_confidence`).

ParameterInTypeDefaultDescription
speciesquerystringsheep`sheep` or `cow`. (pattern ^(sheep|cow)$)
mother requiredquerystringMother's genes: comma-separated `gene:copy/copy`, gene D (Dung), Y (Yield), F (Fertility) or H (Hardiness), copies good/ok/bad. Genes left out are ok/ok. (max length 200)
father requiredquerystringFather's genes, same form. (max length 200)
mother_marksquerystringMother's two family marks (0-15), e.g. `3,7`.
father_marksquerystringFather's two family marks.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/animal-breeder/compute?mother=D:good/ok,Y:good/good,F:good/bad,H:ok/ok&father=Y:good/ok,F:ok/ok"

Example response

{
  "species": "sheep",
  "young": "lamb",
  "genes": [
    {
      "key": "D",
      "name": "Dung",
      "what": "How often the animal drops dung (fertilizer).",
      "mother": [
        "good",
        "ok"
      ],
      "mother_shows": "good",
      "father": [
        "ok",
        "ok"
      ],
      "father_shows": "ok",
      "young_odds": {
        "good": 0.5,
        "ok": 0.5,
        "bad": 0.0
      }
    },
    {
      "key": "Y",
      "name": "Yield",
      "what": "Wool per fleece (sheep) or milk rate (cows).",
      "mother": [
        "good",
        "good"
      ],
      "mother_shows": "good",
      "father": [
        "good",
        "ok"
      ],
      "father_shows": "good",
      "young_odds": {
        "good": 1.0,
        "ok": 0.0,
        "bad": 0.0
      }
    },
    {
      "key": "F",
      "name": "Fertility",
      "what": "How soon it can breed again; a good-fertility mother can have twins.",
      "mother": [
        "good",
        "bad"
      ],
      "mother_shows": "good",
      "father": [
        "ok",
        "ok"
      ],
      "father_shows": "ok",
      "young_odds": {
        "good": 0.5,
        "ok": 0.5,
        "bad": 0.0
      }
    },
    "… 1 more"
  ],
  "chance_all_good_not_inbred": 0.0,
  "chance_inbred": null,
  "inbred_rule": "Good acts as OK and OK acts halfway between OK and Bad (Bad stays Bad); the real copies are still passed on.",
  "chance_twins": 0.6,
  "product": "Wool",
  "expected_product_per_hour": 307,
  "notes": [
    "Father: Dung (D) not given - assumed ok/ok",
    "Father: Hardiness (H) not given - assumed ok/ok",
    "Family marks not given for both parents: inbreeding left out (counted as 0)."
  ],
  "gene_confidence": "medium - three fan sources that read the game files agree; Facepunch publishes no gene numbers",
  "rules": [
    "Each gene has two copies; the animal shows the better one, and either copy can be passed on.",
    "A young animal gets one random copy of each gene from each parent, and one random family mark from each parent.",
    "If its two family marks match, it is inbred.",
    "… 3 more"
  ],
  "…": "2 more keys"
}

GET/calculators/farm-planner/computecopy URL

Plant grow time, clones per cut, yield bonus and water use

The farm planner page's maths (https://rust.wiki/calculators/farm-planner): time to ripe = the plant's base time / (1 + 25% per G), x1.5 unfertilized; `stages` splits it into Seed, Seedling, Sapling, Fruiting and Mature to ripe; `yield_bonus_pct` is +25% per Y; `clones_per_cut` adds one per two Y; water is per plant per tick, +10% per W. Harvests are relative (Facepunch publishes no base amounts). For the best gene layout use /calculators/genetics/best.

ParameterInTypeDefaultDescription
plantquerystringhempCrop: hemp, corn, pumpkin, potato, wheat, sunflower, rose, orchid, red_berry, blue_berry, green_berry, yellow_berry, white_berry, black_berry (or its name). (max length 40)
planterquerystringplanter.largePlanter: planter.large, planter.small, planter.triangle, bathtub.planter, minecart.planter, plantpot.single. (max length 40)
genesquerystringGGGYYYThe clone's six genes from G, Y, H, W, X. (max length 12)
countqueryinteger1How many planters. (max 200, min 1)
fertilizedquerybooleanTrueGround condition 100% (fertilizer). Unfertilized takes about half as long again.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/farm-planner/compute"

Example response

{
  "plant": "Hemp",
  "planter": "Large Planter Box",
  "genes": "GGGYYY",
  "fertilized": true,
  "ripe_minutes": 64.0,
  "ripe": "1 h 4 min",
  "growth_speed_bonus_pct": 75,
  "stages": [
    {
      "stage": "Seed",
      "minutes": 0.57,
      "time": "1 min"
    },
    {
      "stage": "Seedling",
      "minutes": 5.71,
      "time": "6 min"
    },
    {
      "stage": "Sapling",
      "minutes": 5.71,
      "time": "6 min"
    },
    "… 2 more"
  ],
  "yield_bonus_pct": 75,
  "clones_per_cut": 3,
  "planters": 1,
  "plants": 9,
  "…": "11 more keys"
}

GET/calculators/damagecopy URL

Damage calculator data: weapons, ammo, muzzle attachments, armour and suits

The data behind https://rust.wiki/calculators/damage: `weapons` (guns and bows whose ammo the model covers), `ammo` per ammo family as [name, damage multiplier, headshot multiplier, pellets override], `attachments` (muzzle damage multipliers), `armour` (projectile protection %, `slot` and `layer`: clothing goes under, armour over, dual takes both, single = hands/feet), `suits`, `zones` (hit areas and multipliers; `low` = low confidence), `presets`, `rules` and `caveats`.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/damage"

Example response

{
  "verified": "2026-11-13",
  "hp": 100,
  "zones": [
    {
      "key": "head",
      "name": "Head",
      "slot": "head",
      "mult": null
    },
    {
      "key": "chest",
      "name": "Chest",
      "slot": "chest",
      "mult": 1.0
    },
    {
      "key": "legs",
      "name": "Legs",
      "slot": "legs",
      "mult": 0.5,
      "low": true
    },
    "… 2 more"
  ],
  "ammo": {
    "5.56 Rifle Ammo": [
      [
        "5.56 Rifle Ammo",
        1.0,
        2.0,
        "… 1 more"
      ],
      [
        "HV 5.56 Rifle Ammo",
        1.0,
        2.0,
        "… 1 more"
      ],
      [
        "Incendiary 5.56 Rifle Ammo",
        1.12,
        2.0,
        "… 1 more"
      ],
      "… 1 more"
    ],
    "Pistol Bullet": [
      [
        "Pistol Bullet",
        1.0,
        2.0,
        "… 1 more"
      ],
      [
        "HV Pistol Ammo",
        1.0,
        2.0,
        "… 1 more"
      ],
      [
        "Incendiary Pistol Bullet",
        1.12,
        2.0,
        "… 1 more"
      ]
    ],
    "12 Gauge Buckshot": [
      [
        "12 Gauge Buckshot",
        1.0,
        1.2,
        "… 1 more"
      ],
      [
        "12 Gauge Slug",
        5.333333333333333,
        2.0,
        "… 1 more"
      ]
    ],
    "Handmade Shell": [
      [
        "Handmade Shell",
        1.0,
        1.2,
        "… 1 more"
      ]
    ],
    "Wooden Arrow": [
      [
        "Wooden Arrow",
        1.0,
        1.5,
        "… 1 more"
      ],
      [
        "High Velocity Arrow",
        0.8,
        1.5,
        "… 1 more"
      ],
      [
        "Bone Arrow",
        0.8,
        1.5,
        "… 1 more"
      ],
      "… 1 more"
    ]
  },
  "headshot_override": {
    "minigun": 1.0
  },
  "attachments": [
    {
      "key": "none",
      "name": "No muzzle attachment",
      "damage": 1.0
    },
    {
      "key": "silencer",
      "name": "Military Silencer",
      "damage": 0.75
    },
    {
      "key": "oilfilter",
      "name": "Oil Filter Silencer",
      "damage": 0.7
    },
    "… 2 more"
  ],
  "insert_metal_pct": 4,
  "max_inserts": 3,
  "armour": [
    {
      "name": "Metal Facemask",
      "shortname": "metal.facemask",
      "slot": "head",
      "layer": "dual",
      "projectile": 50
    },
    {
      "name": "Heavy Plate Helmet",
      "shortname": "heavy.plate.helmet",
      "slot": "head",
      "layer": "dual",
      "projectile": 90
    },
    {
      "name": "Coffee Can Helmet",
      "shortname": "coffeecan.helmet",
      "slot": "head",
      "layer": "dual",
      "projectile": 35
    },
    "… 26 more"
  ],
  "suits": [
    {
      "name": "Hazmat Suit",
      "shortname": "hazmatsuit",
      "slots": [
        "head",
        "chest",
        "legs",
        "… 2 more"
      ],
      "projectile": 30
    },
    {
      "name": "Bone Armor",
      "shortname": "bone.armor.suit",
      "slots": [
        "chest",
        "legs",
        "hands",
        "… 1 more"
      ],
      "projectile": 25
    }
  ],
  "presets": [
    [
      "Naked",
      {},
      null
    ],
    [
      "Hoodie and pants",
      {
        "chest": [
          "Hoodie"
        ],
        "legs": [
          "Pants"
        ]
      },
      null
    ],
    [
      "Road sign kit",
      {
        "head": [
          "Coffee Can Helmet"
        ],
        "chest": [
          "Hoodie",
          "Road Sign Jacket"
        ],
        "legs": [
          "Pants",
          "Road Sign Kilt"
        ],
        "hands": [
          "Road Sign Gloves"
        ],
        "feet": [
          "Boots"
        ]
      },
      null
    ],
    "… 3 more"
  ],
  "rules": [
    "Damage per hit = weapon damage × ammo × muzzle attachment × hit-area multiplier × (1 − protection).",
    "Protection from every item covering the hit area is added together, then applied once, never above 100%. A hoodie (20%) under a metal chest plate (25%) stops 45…",
    "Each Metal Armor Insert adds about 4% to the item it's in; crafted armour can have up to 3 insert slots.",
    "… 2 more"
  ],
  "…": "5 more keys"
}

GET/calculators/damage/computecopy URL

Shots and time to kill through armour, per hit area

The damage calculator page's maths (https://rust.wiki/calculators/damage). Damage per hit = weapon damage x ammo x attachment x hit-area multiplier x (1 - protection); protection of every piece covering the area is added (cap 100%), +4% per metal insert. Per zone (head, chest, legs, hands, feet): `protection_pct`, `damage_per_hit`, `shots_to_kill` (null = never) and `time_to_kill_s` (fire rate plus reloads when the magazine runs out). Close range only - no damage falloff; shotguns assume every pellet hits. Limb multipliers are low confidence.

ParameterInTypeDefaultDescription
weapon requiredquerystringWeapon shortname or name (guns and bows). (max length 60)
ammoquerystringAmmo name for that weapon (default: its standard ammo).
attachmentquerystringMuzzle attachment: none, silencer, oilfilter, sodacan, muzzlebrake.
armourquerystringComma-separated armour and clothing the target wears (shortnames or names). Per slot: one clothing piece under one armour piece; dual pieces take both.
suitquerystringFull-body suit instead: hazmatsuit or bone.armor.suit.
insertsquerystringMetal armour inserts per slot, `slot:n` (head, chest, legs, hands, feet; 0-3).
hpquerynumber100Target health. (max 1000, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/damage/compute?weapon=rifle.ak"

Example response

{
  "weapon": {
    "name": "Assault Rifle",
    "shortname": "rifle.ak",
    "category": "Rifle",
    "damage": 50,
    "rpm": 450,
    "magazine": 30,
    "reload_s": 4.4
  },
  "ammo": "HV 5.56 Rifle Ammo",
  "attachment": "No muzzle attachment",
  "suit": null,
  "armour": {
    "head": {
      "over": "Metal Facemask"
    },
    "chest": {
      "under": "Hoodie",
      "over": "Metal Chest Plate"
    },
    "legs": {
      "under": "Pants",
      "over": "Road Sign Kilt"
    },
    "hands": {
      "over": "Road Sign Gloves"
    },
    "feet": {
      "over": "Boots"
    }
  },
  "inserts": {
    "chest": 2
  },
  "target_hp": 100.0,
  "damage_per_shot": 50.0,
  "pellets": 1,
  "headshot_multiplier": 2.0,
  "zones": [
    {
      "zone": "head",
      "name": "Head",
      "multiplier": 2.0,
      "low_confidence": false,
      "protection_pct": 50,
      "damage_per_hit": 50.0,
      "shots_to_kill": 2,
      "time_to_kill_s": 0.133
    },
    {
      "zone": "chest",
      "name": "Chest",
      "multiplier": 1.0,
      "low_confidence": false,
      "protection_pct": 53,
      "damage_per_hit": 23.5,
      "shots_to_kill": 5,
      "time_to_kill_s": 0.533
    },
    {
      "zone": "legs",
      "name": "Legs",
      "multiplier": 0.5,
      "low_confidence": true,
      "protection_pct": 35,
      "damage_per_hit": 16.25,
      "shots_to_kill": 7,
      "time_to_kill_s": 0.8
    },
    "… 2 more"
  ],
  "summary": {
    "shots_to_kill_chest": 5,
    "time_to_kill_chest_s": 0.533,
    "shots_to_kill_head": 2,
    "chest_needs_reload": false
  },
  "…": "4 more keys"
}

GET/calculators/bandit-campcopy URL

Bandit Camp games' rules: Big Wheel, blackjack, poker and slots

The rules behind https://rust.wiki/calculators/big-wheel, /calculators/blackjack and /calculators/poker-odds: the wheel's segments and payout, blackjack's table rules, poker's (no rake) and the slot machines' paytable. Each rule carries how sure it is (`confirmed` by Facepunch, `corroborated`, `unconfirmed`). Slot machine odds and the house's cut aren't published anywhere. These are Rust's in-game scrap games - nothing to do with real money.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/bandit-camp"

Example response

{
  "wheel": {
    "spin_s": 45,
    "segments": [
      [
        1,
        12
      ],
      [
        3,
        6
      ],
      [
        5,
        4
      ],
      "… 2 more"
    ],
    "total": 25,
    "payout": "A win gives back your bet plus your bet times the number: 10 scrap on 3 returns 40.",
    "layout_confidence": "fan guides only - Facepunch confirms the numbers and payouts, never the layout",
    "sources": [
      {
        "label": "Facepunch - Bandit Town update (2018-08-02)",
        "url": "https://rust.facepunch.com/news/bandit-town-update"
      },
      {
        "label": "eip.gg - Bandit Camp guide (fan, 2022)",
        "url": "https://eip.gg/rust/guides/bandit-camp-monument/"
      },
      {
        "label": "whenisforcewiperust.com - Bandit Camp (fan, 2026)",
        "url": "https://whenisforcewiperust.com/bandit-camp-rust"
      }
    ]
  },
  "blackjack": {
    "where": "The Lucky caboose train carriage on rail sidings (not a safe zone) and the caboose at Outpost. There is no blackjack at Bandit Camp itself.",
    "rules": [
      [
        "Players",
        "1-3, each against a computer dealer",
        "confirmed"
      ],
      [
        "Decks",
        "6",
        "confirmed"
      ],
      [
        "Blackjack pays",
        "3 to 2",
        "confirmed"
      ],
      "… 9 more"
    ],
    "sources": [
      {
        "label": "Facepunch - Prototype 17: caboose blackjack (2022-11-03)",
        "url": "https://rust.facepunch.com/blog/prototype-17"
      },
      {
        "label": "Facepunch developer commits (blackjack decks, doubling, soft 17)",
        "url": "https://commits.facepunch.com/r/rust_reboot"
      }
    ]
  },
  "poker": {
    "where": "Five tables at Bandit Camp (2 to 6 seats), more on Hapis Island, and a 4-seat table in each caboose.",
    "rules": [
      [
        "Game",
        "Texas Hold'em against other players",
        "confirmed"
      ],
      [
        "Seats",
        "2 to 6 depending on the table",
        "confirmed"
      ],
      [
        "Buy-in",
        "At least 100 scrap (1,000 max reported)",
        "confirmed"
      ],
      "… 3 more"
    ],
    "sources": [
      {
        "label": "Facepunch - Gestures update: poker, slot rebalance (2021-04-01)",
        "url": "https://rust.facepunch.com/blog/gestures-update"
      },
      {
        "label": "Facepunch - Prototype 17: caboose blackjack (2022-11-03)",
        "url": "https://rust.facepunch.com/blog/prototype-17"
      },
      {
        "label": "eip.gg - Bandit Camp guide (fan, 2022)",
        "url": "https://eip.gg/rust/guides/bandit-camp-monument/"
      }
    ]
  },
  "slots": {
    "where": "3 machines at Bandit Camp and 2 in each caboose.",
    "spin_cost": 2,
    "paytable": [
      [
        "Charcoal",
        15
      ],
      [
        "Wood",
        25
      ],
      [
        "Rope",
        40
      ],
      "… 5 more"
    ],
    "note": "A bet multiplier scales the cost and the payouts. Facepunch hasn't published how often each symbol comes up, so nobody outside Facepunch knows the real odds or …",
    "sources": [
      {
        "label": "Facepunch - Freight Transit Line: slot machines (2021-03-04)",
        "url": "https://rust.facepunch.com/blog/freight-transit-line"
      },
      {
        "label": "Facepunch - Gestures update: poker, slot rebalance (2021-04-01)",
        "url": "https://rust.facepunch.com/blog/gestures-update"
      },
      {
        "label": "eip.gg - Bandit Camp guide (fan, 2022)",
        "url": "https://eip.gg/rust/guides/bandit-camp-monument/"
      }
    ]
  },
  "verified": "2026-11-13",
  "pages": {
    "big_wheel": "https://rust.wiki/calculators/big-wheel",
    "blackjack": "https://rust.wiki/calculators/blackjack",
    "poker_odds": "https://rust.wiki/calculators/poker-odds"
  },
  "note": "Poker win odds are a Monte Carlo simulation on the poker odds page and aren't computed by the API."
}

GET/calculators/big-wheel/computecopy URL

Bandit Camp Big Wheel: odds, house edge and expected result of your bets

Exact figures for the Big Wheel (https://rust.wiki/calculators/big-wheel): each number's chance, what it pays back per scrap and what the wheel keeps; for your bets the `expected_result` over the session, the return %, and the standard deviation per spin and per session (how far a real session typically lands from the average). The wheel layout (12 ones, 6 threes, 4 fives, 2 tens, 1 twenty) comes from fan guides only. The page also simulates whole sessions with a starting bank.

ParameterInTypeDefaultDescription
betsquerystringScrap on each number per spin as `number:scrap` (numbers 1, 3, 5, 10, 20). Left out = just the odds table.
spinsqueryinteger80How many spins. (max 5000, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/big-wheel/compute"

Example response

{
  "odds": [
    {
      "number": 1,
      "segments": 12,
      "chance": 0.48,
      "pays_back_per_scrap": 0.96,
      "house_keeps_pct": 4.0
    },
    {
      "number": 3,
      "segments": 6,
      "chance": 0.24,
      "pays_back_per_scrap": 0.96,
      "house_keeps_pct": 4.0
    },
    {
      "number": 5,
      "segments": 4,
      "chance": 0.16,
      "pays_back_per_scrap": 0.96,
      "house_keeps_pct": 4.0
    },
    "… 2 more"
  ],
  "payout": "A win gives back your bet plus your bet times the number: 10 scrap on 3 returns 40.",
  "spin_seconds": 45,
  "layout_confidence": "fan guides only - Facepunch confirms the numbers and payouts, never the layout",
  "bets": {
    "1": 10,
    "20": 2
  },
  "scrap_per_spin": 12,
  "spins": 80,
  "scrap_bet_total": 960,
  "expected_result": -57.6,
  "expected_return_pct": 94.0,
  "expected_loss_pct": 6.0,
  "std_dev_per_spin": 11.63,
  "…": "4 more keys"
}

GET/calculators/blackjack/strategycopy URL

Rust blackjack: the best play for a hand, or the whole strategy chart

The blackjack page's strategy engine (https://rust.wiki/calculators/blackjack), an exact infinite-deck calculation under Rust's caboose rules: no doubling on a hand with an Ace, one split, 3:2 blackjack, and no dealer peek by default. With `hand` + `dealer`: the `best` play and every option's expected value per 1 scrap bet. Without: the full `hard`, `soft` and `pairs` charts (H hit, S stand, D double, P split) per dealer card, plus the `house_edge_pct` with perfect play (about 0.82% under Rust's rules).

ParameterInTypeDefaultDescription
handquerystringYour first two cards, e.g. `A,7` or `10,6` (2-10, J, Q, K, A). Left out = full chart.
dealerquerystringThe dealer's face-up card (needed with hand).
dealer_hits_soft_17querybooleanTrueRust's caboose dealer hits soft 17 (since about Feb 2024).
dealer_peeksquerybooleanFalseFalse = Rust: a dealer blackjack also takes doubles and splits.
double_after_splitquerybooleanTrueDoubling after a split allowed.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/blackjack/strategy"

Example response

{
  "rules": {
    "dealer_hits_soft_17": true,
    "dealer_peeks": false,
    "double_after_split": true,
    "double_with_an_ace": false,
    "blackjack_pays": "3 to 2"
  },
  "house_edge_pct": 0.818,
  "scrap_lost_per_500_bet": 4.1,
  "ev_units": "expected scrap won (+) or lost (-) per 1 scrap bet, perfect play",
  "hand": "A,7",
  "dealer": "9",
  "best": "Hit",
  "options": [
    {
      "action": "Hit",
      "ev": -0.1007
    },
    {
      "action": "Stand",
      "ev": -0.1832
    }
  ],
  "page": "https://rust.wiki/calculators/blackjack"
}

GET/calculators/decay/computecopy URL

When a base decays once the Tool Cupboard runs out, piece or layer by layer

The decay page's maths (https://rust.wiki/calculators/decay): with no upkeep, an outside piece goes from full health to nothing in 1 h (twig), 3 h (wood), 5 h (stone), 8 h (sheet metal) or 12 h (armoured); inside pieces decay at a tenth of that. `destroyed_in_hours` counts from now (upkeep first). For `layers`, each layer behind the outer one decays at 10% until the one in front is gone, then at full speed. Vanilla server defaults.

ParameterInTypeDefaultDescription
gradequerystringstoneBuilding grade: twig, wood, stone, metal, hqm. (max length 20)
health_pctquerynumber100The piece's health left, %. (max 100, min 1)
insidequerybooleanFalseTrue = the piece is inside the base (decays at 10% speed).
upkeep_hoursquerynumber0Hours of upkeep left in the Tool Cupboard. (max 2000, min 0)
layersquerystringOptional honeycomb: comma-separated grades from the outside in (max 6).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/decay/compute"

Example response

{
  "grade": "Stone",
  "health_pct": 100,
  "inside": false,
  "upkeep_hours": 0.0,
  "decay_starts_in_hours": 0.0,
  "decay_hours": 5.0,
  "destroyed_in_hours": 5.0,
  "destroyed_in": "5 h",
  "full_decay_hours_outside": {
    "Twig": 1,
    "Wood": 3,
    "Stone": 5,
    "Sheet Metal": 8,
    "Armored": 12
  },
  "layers": [
    {
      "layer": 1,
      "grade": "Armored",
      "gone_in_hours": 12.0,
      "gone_in": "12 h"
    },
    {
      "layer": 2,
      "grade": "Stone",
      "gone_in_hours": 15.8,
      "gone_in": "15 h 48 min"
    },
    {
      "layer": 3,
      "grade": "Stone",
      "gone_in_hours": 19.22,
      "gone_in": "19 h 13 min"
    }
  ],
  "last_layer_gone_in": "19 h 13 min",
  "rules": [
    "A building joined to a Tool Cupboard that holds enough upkeep doesn't decay at all.",
    "When one resource runs out, only the pieces built from it start to decay - a stone base with no stone in the TC decays even with wood and metal left.",
    "With no upkeep, a piece facing the open air goes from full health to nothing in the times below. Pieces inside the base decay at a tenth of that rate.",
    "… 3 more"
  ],
  "…": "5 more keys"
}

GET/calculators/excavator/computecopy URL

Giant Excavator, quarries and pump jack: output and run time for your diesel

The excavator page's maths (https://rust.wiki/calculators/excavator): run time and output for the diesel. The Giant Excavator's yields per diesel are Facepunch's own (December 2021); the monument quarries' and pump jack's come from community guides (`confidence`). Vanilla server rates.

ParameterInTypeDefaultDescription
machinequerystringMachine key or name (left out = every machine's rates): excavator_stone, excavator_metal, excavator_sulfur, excavator_hqm, quarry_sulfur, quarry_stone, quarry_hqm, pumpjack.
dieselqueryinteger20Diesel fuel. (max 10000, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/excavator/compute"

Example response

{
  "machines": [
    {
      "key": "excavator_stone",
      "name": "Giant Excavator - Stone",
      "seconds_per_diesel": 120,
      "per_diesel": [
        {
          "name": "Stones",
          "amount": 10000,
          "shortname": "stones"
        }
      ],
      "confidence": "confirmed",
      "note": null
    },
    {
      "key": "excavator_metal",
      "name": "Giant Excavator - Metal Fragments",
      "seconds_per_diesel": 120,
      "per_diesel": [
        {
          "name": "Metal Fragments",
          "amount": 5000,
          "shortname": "metal.fragments"
        }
      ],
      "confidence": "confirmed",
      "note": null
    },
    {
      "key": "excavator_sulfur",
      "name": "Giant Excavator - Sulfur Ore",
      "seconds_per_diesel": 120,
      "per_diesel": [
        {
          "name": "Sulfur Ore",
          "amount": 2000,
          "shortname": "sulfur.ore"
        }
      ],
      "confidence": "confirmed",
      "note": null
    },
    "… 5 more"
  ],
  "diesel_stack": 20,
  "notes": [
    "The Giant Excavator mines one resource at a time - pick it on the excavator's control panel. Its yields per diesel are Facepunch's own (December 2021).",
    "Monument quarries and the pump jack have run on diesel since December 2022. Facepunch hasn't published their yields; the figures here come from community guides…",
    "Server owners can change all of these rates; these are vanilla defaults.",
    "… 1 more"
  ],
  "sources": [
    {
      "label": "Facepunch - December 2021 update (excavator yields per diesel)",
      "url": "https://rust.facepunch.com/news/december-update-2021"
    },
    {
      "label": "Facepunch - The Big QoL update (quarries run on diesel, 2022-12-01)",
      "url": "https://rust.facepunch.com/news/the-big-qol-update"
    },
    {
      "label": "tradeit.gg - sulfur quarry guide (community, 2025)",
      "url": "https://tradeit.gg/blog/sulfur-quarry-in-rust/"
    },
    "… 1 more"
  ],
  "page": "https://rust.wiki/calculators/excavator"
}

GET/calculators/door-codecopy URL

Code lock facts and what makes a door code easy to guess

The facts behind https://rust.wiki/calculators/door-code: the code lock's rules (`facts`: 4 digits, a shock per wrong guess, 8 wrong tries then a 15-minute lockout, guest codes), the ten most common four-digit codes (cited from DataGenetics' 2012 PIN study), the `patterns` the page flags as guessable and how long a full brute force takes. The API deliberately doesn't generate or check codes: the page makes them in your own browser and never sends them anywhere - open the page for a code.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/door-code"

Example response

{
  "facts": [
    {
      "what": "Code",
      "detail": "4 digits - 10,000 possible codes"
    },
    {
      "what": "Wrong code",
      "detail": "An electric shock: 5 damage, then 10, 15 and so on while you keep guessing"
    },
    {
      "what": "Too many wrong codes",
      "detail": "8 wrong tries locks that player out for 15 minutes (since December 2021)"
    },
    "… 2 more"
  ],
  "most_common_codes": [
    "1234",
    "1111",
    "0000",
    "… 7 more"
  ],
  "top20_share_pct": 26.8,
  "patterns": [
    "one of the 10 most common codes",
    "the same digit four times",
    "a run like 1234 or 2468 (steps of 1 or 2)",
    "… 6 more"
  ],
  "brute_force_days": 13,
  "verified": "2026-11-13",
  "sources": [
    {
      "label": "Facepunch Rust wiki - Code Lock",
      "url": "https://wiki.facepunch.com/rust/item/lock.code"
    },
    {
      "label": "Facepunch - Devblog 97 (wrong-code shock)",
      "url": "https://rust.facepunch.com/news/devblog-97"
    },
    {
      "label": "Facepunch changelist, December 2021 (8 tries, then 15-minute lockout)",
      "url": "https://rust.facepunch.com/changelist/3914"
    },
    "… 1 more"
  ],
  "page": "https://rust.wiki/calculators/door-code"
}

GET/launch-optionscopy URL

Rust launch options that work, the myths, and a Steam launch line builder

The data behind https://rust.wiki/launch-options: `groups` of options Rust (Facepunch) and Unity 6 actually read, each with its value and what it does, plus `myths` (popular 'FPS boost' flags nothing shows Rust reads). With `line`: `check.line` is the cleaned launch line (known options only, one forced graphics API) and `check.options` says what each one is (`rust`, `unity`, `myth`, `unknown`, `conflict`) with any warning.

ParameterInTypeDefaultDescription
linequerystringOptional: options to check and clean up, as you'd paste them into Steam.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/launch-options"

Example response

{
  "engine": "Rust runs on Unity 6 (since June 2026), so Unity's own player options apply.",
  "groups": [
    {
      "key": "rust",
      "title": "Read by Rust itself",
      "about": "Facepunch added these and documents them.",
      "options": [
        {
          "flag": "-cpu_priority",
          "value": "level",
          "example": "high",
          "what": "Raises Rust's process priority from inside the game - Easy Anti-Cheat stops you doing it from Task Manager."
        },
        {
          "flag": "-cpu_affinity",
          "value": "cores",
          "example": "0-7",
          "what": "Keeps Rust on the cores you list, as ranges like 0-7 or 0-7,16-23. Facepunch added it for CPUs like the 7950X3D, where only some cores have the extra cache."
        },
        {
          "flag": "-safemode",
          "value": null,
          "example": null,
          "what": "Starts with very low settings to fix a game that won't load. It overwrites your settings."
        },
        "… 2 more"
      ]
    },
    {
      "key": "unity",
      "title": "Unity engine options",
      "about": "Unity documents these for every Unity 6 game.",
      "options": [
        {
          "flag": "-window-mode",
          "value": "mode",
          "example": "borderless",
          "what": "exclusive or borderless fullscreen (Windows). Rust itself dropped exclusive fullscreen in 2023."
        },
        {
          "flag": "-screen-fullscreen",
          "value": "0 or 1",
          "example": "1",
          "what": "Start fullscreen (1) or windowed (0)."
        },
        {
          "flag": "-screen-width",
          "value": "px",
          "example": "1920",
          "what": "Start at this width."
        },
        "… 8 more"
      ]
    }
  ],
  "myths": [
    {
      "flag": "-high",
      "why": "Comes from Valve's Source games. Neither Unity nor Facepunch lists it - use -cpu_priority high."
    },
    {
      "flag": "-maxMem=",
      "why": "An Arma setting. Not a Unity or Rust option."
    },
    {
      "flag": "-cpuCount=",
      "why": "An Arma setting. Not a Unity or Rust option."
    },
    "… 5 more"
  ],
  "how_to": "In Steam, right-click Rust > Properties > General, and paste into Launch Options.",
  "verified": "2026-11-13",
  "sources": [
    {
      "label": "Facepunch - Make Your Mark (cpu_priority, cpu_affinity, safe mode; 2023-04-06)",
      "url": "https://rust.facepunch.com/news/make-your-mark"
    },
    {
      "label": "Facepunch - February 2019 update (gc.buffer)",
      "url": "https://rust.facepunch.com/blog/february-update"
    },
    {
      "label": "Unity 6.3 manual - player command-line arguments",
      "url": "https://docs.unity.com/en-us/engine/6000.3/manual/unity-editor/command-line-arguments/player"
    },
    "… 1 more"
  ],
  "page": "https://rust.wiki/launch-options",
  "check": {
    "line": "-cpu_priority high +gc.buffer 4096",
    "options": [
      {
        "flag": "-cpu_priority",
        "status": "rust",
        "what": "Raises Rust's process priority from inside the game - Easy Anti-Cheat stops you doing it from Task Manager."
      },
      {
        "flag": "+gc.buffer",
        "status": "rust",
        "what": "Rust's garbage-collection buffer. A bigger buffer means fewer stutters from clean-ups if you have spare RAM (16 GB or more)."
      },
      {
        "flag": "-maxMem",
        "status": "myth",
        "what": "An Arma setting. Not a Unity or Rust option.",
        "warning": "left out - no sign Rust reads it"
      }
    ],
    "how_to": "In Steam, right-click Rust > Properties > General, and paste into Launch Options.",
    "engine": "Rust runs on Unity 6 (since June 2026), so Unity's own player options apply."
  }
}

GET/calculators/bind-maker/computecopy URL

Make a Rust key bind command (auto-run, crafting, chat, gestures...)

The bind maker page (https://rust.wiki/calculators/bind-maker). Returns the `bind` line to paste into the F1 console and `writecfg` to save it. Without `preset`: every preset with its fields and suggested key, the bind syntax and the key names.

ParameterInTypeDefaultDescription
presetquerystringWhat the key does: autorun, sprintjump, crouch, autoattack, light_ads, craft, chat, teamchat, gesture, fov, voice, hoverloot, combatlog, kill, disconnect, custom. Left out = list the presets.
keyquerystringKey name, e.g. `x`, `f1`, `mouse3` (default: the preset's suggestion).
modifierquerystringOptional held key for a combo: leftshift, leftcontrol, leftalt.
aquerystringThe preset's first field (item ID, message, gesture, FOV, or the custom command).
bquerystringThe preset's second field (craft amount, second FOV).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/bind-maker/compute"

Example response

{
  "presets": [
    {
      "key": "autorun",
      "label": "Auto-run",
      "action": "forward;sprint",
      "fields": [],
      "defaults": [],
      "suggested_key": "x",
      "note": "Keeps running until you press forward yourself."
    },
    {
      "key": "sprintjump",
      "label": "Sprint-jump while held",
      "action": "+forward;+sprint;+jump",
      "fields": [],
      "defaults": [],
      "suggested_key": "j",
      "note": "Only while the key is held down."
    },
    {
      "key": "crouch",
      "label": "Crouch toggle",
      "action": "duck",
      "fields": [],
      "defaults": [],
      "suggested_key": "z",
      "note": "Stays crouched until you crouch normally."
    },
    "… 13 more"
  ],
  "syntax": [
    {
      "form": "bind key action",
      "meaning": "The basic form. Several words? Wrap the action in double quotes."
    },
    {
      "form": "a;b",
      "meaning": "A semicolon runs several actions from one key."
    },
    {
      "form": "+action",
      "meaning": "Only while the key is held."
    },
    "… 5 more"
  ],
  "key_names": [
    "a",
    "b",
    "c",
    "… 77 more"
  ],
  "modifiers": [
    "leftshift",
    "leftcontrol",
    "leftalt"
  ],
  "sources": [
    {
      "label": "Facepunch Rust wiki - Keybinds",
      "url": "https://wiki.facepunch.com/rust/Keybinds"
    },
    {
      "label": "Facepunch - 10 Years of Rust (meta.add binds, 2023-12-07)",
      "url": "https://rust.facepunch.com/news/10-years-of-rust"
    }
  ],
  "page": "https://rust.wiki/calculators/bind-maker"
}

GET/calculators/conveyor/filtercopy URL

Build an Industrial Conveyor filter to paste into the game

The conveyor page's filter builder (https://rust.wiki/calculators/conveyor). `filter_json` is exactly what the in-game conveyor copies and pastes (a list of {TargetCategory, TargetItemName, MaxAmountInOutput, BufferAmount, MinAmountInInput, IsBlueprint}); paste it on the conveyor's filter screen. A conveyor holds 30 filters; `unknown` lists names that matched nothing.

ParameterInTypeDefaultDescription
itemsquerystringComma-separated item shortnames or names.
categoriesquerystringComma-separated whole categories: weapon, construction, general, resource, attire, tool, medical, food, ammo, trap, misc, component, electrical, fun.
starterquerystringStart from a ready-made list: Furnace feed, Smelted output, Tool Cupboard upkeep, Raid box, Boom crafting, Meds, Fuel, Recycler run.
max_outqueryinteger0MaxAmountInOutput for every filter (0 = no limit). (max 1000000, min 0)
bufferqueryinteger0BufferAmount for every filter. (max 1000000, min 0)
min_inqueryinteger0MinAmountInInput for every filter. (max 1000000, min 0)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/conveyor/filter"

Example response

{
  "filters": 4,
  "max_filters": 30,
  "filter_json": "[\n  {\n    \"TargetCategory\": null,\n    \"MaxAmountInOutput\": 0,\n    \"BufferAmount\": 0,\n    \"MinAmountInInput\": 0,\n    \"IsBlueprint\": false,\n    \"TargetItemName\": …",
  "entries": [
    {
      "TargetCategory": null,
      "MaxAmountInOutput": 0,
      "BufferAmount": 0,
      "MinAmountInInput": 0,
      "IsBlueprint": false,
      "TargetItemName": "metal.ore"
    },
    {
      "TargetCategory": null,
      "MaxAmountInOutput": 0,
      "BufferAmount": 0,
      "MinAmountInInput": 0,
      "IsBlueprint": false,
      "TargetItemName": "sulfur.ore"
    },
    {
      "TargetCategory": null,
      "MaxAmountInOutput": 0,
      "BufferAmount": 0,
      "MinAmountInInput": 0,
      "IsBlueprint": false,
      "TargetItemName": "hq.metal.ore"
    },
    "… 1 more"
  ],
  "unknown": [],
  "how_to": "Copy filter_json, open the conveyor's filter screen in game and press paste.",
  "page": "https://rust.wiki/calculators/conveyor"
}

GET/calculators/conveyor/loot-roomcopy URL

Plan a loot room: which item categories go in which box, with each box's filter

The conveyor page's loot-room planner: each category needs (its item types x fill) slots; categories go biggest first into the tightest box they fit, spilling across the emptiest boxes when none is big enough. Each box gets the conveyor `filter_json` for its categories; `not_enough_room` says what didn't fit.

ParameterInTypeDefaultDescription
categoriesquerystringCategories to store (default: everything but food, fun and attire).
large_boxesqueryinteger8Large Wood Boxes (48 slots). (max 60, min 0)
small_boxesqueryinteger0Small Wood Boxes (18 slots). (max 60, min 0)
fill_pctquerynumber40How much of each category you'll keep, % of its item types. (max 100, min 10)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/conveyor/loot-room"

Example response

{
  "fill_pct": 40,
  "boxes": [
    {
      "box": 1,
      "type": "Large Wood Box",
      "slots": 48,
      "slots_used": 48,
      "categories": [
        {
          "category": "Items",
          "slots": 48
        }
      ],
      "filter_json": "[\n  {\n    \"TargetCategory\": 2,\n    \"MaxAmountInOutput\": 0,\n    \"BufferAmount\": 0,\n    \"MinAmountInInput\": 0,\n    \"IsBlueprint\": false,\n    \"TargetItemName\": \"\"\n…"
    },
    {
      "box": 2,
      "type": "Large Wood Box",
      "slots": 48,
      "slots_used": 48,
      "categories": [
        {
          "category": "Items",
          "slots": 33
        },
        {
          "category": "Resources",
          "slots": 15
        }
      ],
      "filter_json": "[\n  {\n    \"TargetCategory\": 2,\n    \"MaxAmountInOutput\": 0,\n    \"BufferAmount\": 0,\n    \"MinAmountInInput\": 0,\n    \"IsBlueprint\": false,\n    \"TargetItemName\": \"\"\n…"
    },
    {
      "box": 3,
      "type": "Large Wood Box",
      "slots": 48,
      "slots_used": 43,
      "categories": [
        {
          "category": "Weapons",
          "slots": 40
        },
        {
          "category": "Medical",
          "slots": 3
        }
      ],
      "filter_json": "[\n  {\n    \"TargetCategory\": 0,\n    \"MaxAmountInOutput\": 0,\n    \"BufferAmount\": 0,\n    \"MinAmountInInput\": 0,\n    \"IsBlueprint\": false,\n    \"TargetItemName\": \"\"\n…"
    },
    "… 5 more"
  ],
  "not_enough_room": [],
  "how_it_works": "Each category needs (items in it x fill) stack slots; categories are placed biggest first into the tightest box they fit, and one too big for any box spills acr…",
  "page": "https://rust.wiki/calculators/conveyor"
}

GET/calculators/circuit-simulatorcopy URL

Circuit simulator parts: every electrical part's inputs, outputs and rules

The parts and rules behind https://rust.wiki/calculators/circuit-simulator (Rust's power rules since the April 2024 rework): `parts` as [kind, name, shortname, group, inputs, outputs, settings], `devices` as [name, shortname, power draw], `rules` and `caveats`. The board and its solver run in the browser - build circuits on the page; for a plain power budget use /calculators/electricity/compute.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/circuit-simulator"

Example response

{
  "verified": "2026-11-14",
  "parts": [
    [
      "solar",
      "Large Solar Panel",
      "electric.solarpanel.large",
      "… 4 more"
    ],
    [
      "wind",
      "Wind Turbine",
      "generator.wind.scrap",
      "… 4 more"
    ],
    [
      "water",
      "Water Wheel",
      "generator.water",
      "… 4 more"
    ],
    "… 26 more"
  ],
  "rules": [
    "A device needs its full power to work - a ceiling light needs 2. Whatever's left goes out of its Passthrough.",
    "Switches, gates, timers, blockers, splitters, branches and combiners use no power (since April 2024). Sensors and radio parts use 1.",
    "A splitter shares its input evenly between the outputs you've connected; any remainder goes to the first ones, so nothing is lost.",
    "… 4 more"
  ],
  "caveats": [
    "Splitter remainders going to the first outputs, the Branch when its input is below its setting, and the strength of a battery's Fully Charged signal aren't publ…",
    "A battery's demand is worked out from the draws after it; in game a switched-off device can still count.",
    "Solar, wind and water output depend on sun, height and flow - set them with the sliders."
  ],
  "sources": [
    {
      "label": "Facepunch - Waves of Change (power rework, 2024-04-04)",
      "url": "https://rust.facepunch.com/news/waves-of-change"
    },
    {
      "label": "wikily.gg - electrical item descriptions",
      "url": "https://wikily.gg/rust/items/"
    },
    {
      "label": "The RUST Electrical Handbook (community, frozen April 2024)",
      "url": "https://github.com/atrosekta/rust-electrical-wiki/tree/master/content"
    }
  ],
  "devices": [
    [
      "Audio Alarm",
      "electric.audioalarm",
      1
    ],
    [
      "Auto Turret",
      "autoturret",
      10
    ],
    [
      "Boom Box",
      "boombox",
      10
    ],
    "… 47 more"
  ],
  "page": "https://rust.wiki/calculators/circuit-simulator"
}

GET/updates/{slug}copy URL

One Facepunch devblog: what it added - new skins, their value, drops, player peak

The data behind https://rust.wiki/updates/<slug> (devblogs only): Facepunch's `summary` and link, the RustProfit blog explainer when there is one, every skin released in the update's `window` (until the next devblog) with its price (USD cents, Steam lowest listing; first 60 listed, `skin_count` for all), how many were store skins vs Twitch/Kick drops, their total value now, the drop collections, that month's Steam player peak and the previous / next devblog.

ParameterInTypeDefaultDescription
slug requiredpathstringThe devblog's slug from /updates. (max length 120)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/updates/printed_and_polished"

Example response

{
  "slug": "printed_and_polished",
  "title": "Printed and Polished",
  "summary": "This month's update brings you a Blueprint Rework, the new Uzi 9mm, and our biggest optimisation focused updates yet! As well as many more bug fixes, refreshes,…",
  "thumbnail_url": "https://files.facepunch.com/lewis/2026/October/branding_pandp-update.png",
  "date": "2026-11-05",
  "month_label": "November 2026",
  "facepunch_url": "https://rust.facepunch.com/news/printed_and_polished",
  "blog_url": null,
  "window": {
    "from": "2026-11-05",
    "to": "2026-12-10",
    "open": true
  },
  "skins": [
    {
      "itemdefid": 71404,
      "name": "Arctic Protection Barricade",
      "icon_url": "https://community.fastly.steamstatic.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Rf4GLBfCk4nReh8DEiv5ddMa49r7czRvB6M…",
      "category": null,
      "drop": false,
      "collection": "Arctic Protection",
      "price": null
    },
    {
      "itemdefid": 71400,
      "name": "Funerary Hide Pants",
      "icon_url": "https://community.fastly.steamstatic.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Rf4GLFfCk4nReh8DEiv5dbO6A9pbE2R_m5h…",
      "category": null,
      "drop": false,
      "collection": null,
      "price": null
    },
    {
      "itemdefid": 71401,
      "name": "Funerary Hide Shirt",
      "icon_url": "https://community.fastly.steamstatic.com/economy/image/6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Rf4GLEfCk4nReh8DEiv5dYMKA_qbM_SPy67…",
      "category": null,
      "drop": false,
      "collection": null,
      "price": null
    },
    "… 11 more"
  ],
  "skin_count": 14,
  "store_count": 14,
  "…": "8 more keys"
}

GET/calculators/sulfur/computecopy URL

Sulfur, charcoal and raw materials for any number of explosives

The sulfur calculator page (https://rust.wiki/calculators/sulfur): each explosive's crafting recipe resolved down to raw materials (gunpowder and explosives broken into sulfur and charcoal - the raid calculator's own numbers). `resources` is the shopping list (sulfur first), `to_farm` the sulfur ore (smelts 1:1) and wood to burn for the charcoal, and with `sulfur` the `budget` table: how many rockets, C4, satchels... that sulfur makes. Every explosive's `sulfur_each` is in the budget table and in /calculators/raid.

ParameterInTypeDefaultDescription
explosivesquerystringComma-separated `shortname:count` explosives (names work too), e.g. rockets, C4, satchels, explosive ammo, beancans.
sulfurquerynumberOptional: the sulfur you have - how many of each standard explosive it makes.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/sulfur/compute"

Example response

{
  "explosives": [
    {
      "shortname": "ammo.rocket.basic",
      "name": "Rocket",
      "count": 4,
      "sulfur_each": 1400,
      "sulfur": 5600
    },
    {
      "shortname": "explosive.timed",
      "name": "Timed Explosive Charge",
      "count": 2,
      "sulfur_each": 2200,
      "sulfur": 4400
    }
  ],
  "unknown": [],
  "resources": [
    {
      "shortname": "sulfur",
      "name": "Sulfur",
      "amount": 10000
    },
    {
      "shortname": "charcoal",
      "name": "Charcoal",
      "amount": 13800
    },
    {
      "shortname": "metal.fragments",
      "name": "Metal Fragments",
      "amount": 800
    },
    "… 4 more"
  ],
  "sulfur": 10000,
  "to_farm": {
    "sulfur_ore": 10000,
    "wood_for_charcoal": 18400,
    "note": "Sulfur ore smelts 1:1 into sulfur; burning wood leaves about 0.75 charcoal per wood."
  },
  "page": "https://rust.wiki/calculators/sulfur"
}

GET/calculators/blueprints/progresscopy URL

Blueprint tracker: what you've unlocked and the scrap, fragments, pages and books left

The blueprint tracker page (https://rust.wiki/calculators/blueprints) for a list of blueprints you have. Tech tree blueprints cost research items, not scrap: 1 Blueprint Fragment each on the Workbench Level 1 and Engineering Workbench trees, 1 Blueprint Page on Level 2, 1 Blueprint Book on Level 3 (game default; a server can add a tax). Unlocking one also unlocks every locked blueprint on the cheapest route to it, 1 item each. `trees` gives, per tree, the blueprints unlocked, the research items spent and left, and the cheapest locked ones with `cost_now` (what reaching it costs from what you have). `research_items` totals those per item. `research_table` is the Research Table side: scrap by rarity (20/40/100/300, default blueprints 10), spent and left. `page` opens the tracker with the same ticks. The full list is /calculators/blueprints.

ParameterInTypeDefaultDescription
unlockedquerystringComma-separated shortnames (or names) of the blueprints you have. Left out = nothing unlocked yet.
remainingqueryinteger25How many still-locked blueprints to list per tech tree and for the Research Table (cheapest first). (max 500, min 0)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/blueprints/progress"

Example response

{
  "unlocked_items": [
    "ammo.rocket.basic",
    "explosive.timed",
    "rifle.ak"
  ],
  "unknown": [],
  "research_items": {
    "blueprintfragment": {
      "spent": 0,
      "total": 194,
      "left": 194,
      "name": "Blueprint Fragment"
    },
    "blueprintpage": {
      "spent": 0,
      "total": 90,
      "left": 90,
      "name": "Blueprint Page"
    },
    "blueprintbook": {
      "spent": 3,
      "total": 20,
      "left": 17,
      "name": "Blueprint Book"
    }
  },
  "scrap_spent": 300,
  "scrap_total": 38765,
  "scrap_left": 38465,
  "trees": [
    {
      "tree": "workbench1",
      "label": "Workbench Level 1",
      "currency": "blueprintfragment",
      "unlocked": 0,
      "total": 98,
      "spent": 0,
      "left": 98,
      "remaining_count": 98,
      "remaining": [
        {
          "shortname": "hammer.salvaged",
          "name": "Salvaged Hammer",
          "cost_now": 1
        },
        {
          "shortname": "shirt.tanktop",
          "name": "Tank Top",
          "cost_now": 1
        },
        {
          "shortname": "bucket.water",
          "name": "Water Bucket",
          "cost_now": 1
        },
        "… 22 more"
      ]
    },
    {
      "tree": "workbench2",
      "label": "Workbench Level 2",
      "currency": "blueprintpage",
      "unlocked": 0,
      "total": 90,
      "spent": 0,
      "left": 90,
      "remaining_count": 90,
      "remaining": [
        {
          "shortname": "hazmatsuit",
          "name": "Hazmat Suit",
          "cost_now": 1
        },
        {
          "shortname": "longsword",
          "name": "Longsword",
          "cost_now": 1
        },
        {
          "shortname": "shoes.boots",
          "name": "Boots",
          "cost_now": 2
        },
        "… 22 more"
      ]
    },
    {
      "tree": "workbench3",
      "label": "Workbench Level 3",
      "currency": "blueprintbook",
      "unlocked": 3,
      "total": 20,
      "spent": 3,
      "left": 17,
      "remaining_count": 17,
      "remaining": [
        {
          "shortname": "wall.window.bars.toptier",
          "name": "Reinforced Glass Window",
          "cost_now": 1
        },
        {
          "shortname": "door.hinged.toptier",
          "name": "Armored Door",
          "cost_now": 2
        },
        {
          "shortname": "rifle.sks",
          "name": "SKS",
          "cost_now": 2
        },
        "… 14 more"
      ]
    },
    "… 1 more"
  ],
  "research_table": {
    "unlocked": 3,
    "total": 613,
    "scrap_spent": 300,
    "scrap_total": 38765,
    "remaining_count": 610,
    "remaining": [
      {
        "shortname": "electric.andswitch",
        "name": "AND Switch",
        "scrap": 15
      },
      {
        "shortname": "fun.guitar",
        "name": "Acoustic Guitar",
        "scrap": 15
      },
      {
        "shortname": "anchor",
        "name": "Anchor",
        "scrap": 15
      },
      "… 22 more"
    ]
  },
  "page": "https://rust.wiki/calculators/blueprints?unlocked=ammo.rocket.basic,explosive.timed,rifle.ak"
}

GET/calculators/poker-odds/computecopy URL

Texas Hold'em win odds and pot odds for a hand (Bandit Camp poker)

The poker odds page's simulation (https://rust.wiki/calculators/poker-odds): the rest of the board and every opponent's cards are dealt at random `trials` times. `win_pct` = you win outright, `split_pct` = your share of split pots, `equity_pct` = both; `margin_pct` is the 95% margin of error. With `to_call`, `pot_odds_need_pct` (call / (pot + call)) and a `verdict` (call or fold); `made_hands` is how often you end with each hand and how often that hand wins. Bandit Camp's poker is Rust's in-game scrap game (no rake) - nothing to do with real money.

ParameterInTypeDefaultDescription
hand requiredquerystringYour two cards, e.g. `As,Kd` (ranks 2-10 J Q K A or T, suits s h d c). (min length 4, max length 20)
boardquerystringCommunity cards so far (0-5).
opponentsqueryinteger1Other players still in the hand (1-5, as on the page). (max 5, min 1)
potquerynumber0Scrap in the pot (for pot odds). (max 10000000, min 0)
to_callquerynumber0Scrap you need to call (0 = nothing to call). (max 10000000, min 0)
trialsqueryinteger20000Random deals to simulate (the page uses 20,000; fewer is faster but rougher). (max 20000, min 1000)
seedqueryintegerOptional random seed for a repeatable answer.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/poker-odds/compute?hand=As,Kd"

Example response

{
  "hand": [
    "As",
    "Kd"
  ],
  "board": [
    "Qs",
    "Js",
    "2c"
  ],
  "opponents": 1,
  "win_pct": 63.08,
  "split_pct": 0.72,
  "equity_pct": 63.8,
  "margin_pct": 0.67,
  "trials": 20000,
  "made_hands": [
    {
      "hand": "Straight flush",
      "pct": 0.11,
      "win_pct": 100.0
    },
    {
      "hand": "Flush",
      "pct": 4.01,
      "win_pct": 98.5
    },
    {
      "hand": "Straight",
      "pct": 15.95,
      "win_pct": 94.9
    },
    "… 4 more"
  ],
  "pot": 0.0,
  "to_call": 0.0,
  "pot_odds_need_pct": 0,
  "…": "3 more keys"
}

GET/calculators/door-code/generatecopy URL

Random code lock codes that avoid the ones raiders try first

The door code generator (https://rust.wiki/calculators/door-code): random four-digit codes from the server's cryptographic random source, re-drawn until they match none of the guessable patterns the page checks (the 10 most common codes, one digit four times, runs like 1234, repeated pairs, mirrors, years, dates, two-digit codes), each with a different guest code. Codes are made fresh per request and never stored (the response is marked no-store); for a code that never leaves your device, use the page, which makes them in your browser.

ParameterInTypeDefaultDescription
countqueryinteger1How many code pairs to make. (max 10, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/door-code/generate"

Example response

{
  "codes": [
    {
      "code": "0289",
      "guest_code": "6394"
    }
  ],
  "rules": "Random 4-digit codes that avoid the 10 most common codes, repeated digits, runs, repeated pairs, mirrors, years, dates and two-digit codes - the same filter as …",
  "page": "https://rust.wiki/calculators/door-code"
}

GET/calculators/door-code/checkcopy URL

Is this door code easy to guess?

The door code page's checker: `verdict` is `good`, `guessable` (a weak pattern: a year, a date, doubled digits, a mirror, only two digits) or `easy to guess` (a top-10 code, one digit four times, a run, a repeated pair), with the `reasons`. Check a code BEFORE you set it - don't send the code that's on your door now.

ParameterInTypeDefaultDescription
code requiredquerystringA four-digit code to check. (min length 4, max length 8)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/door-code/check?code=1987"

Example response

{
  "code": "1987",
  "verdict": "guessable",
  "message": "Guessable - a raider might try it.",
  "reasons": [
    {
      "level": "weak",
      "reason": "Looks like a year"
    }
  ],
  "page": "https://rust.wiki/calculators/door-code"
}

GET/crosshaircopy URL

Rust crosshair presets, styles and colours (the in-game crosshair editor's codes)

The data behind https://rust.wiki/crosshair: Rust's built-in crosshair editor (Options > User Interface > Crosshair, since October 2025) shares crosshairs as codes like `RUST-FceIG-V4T`. `presets` are ready-made crosshairs with their codes and settings; `styles`, `colors` and `outline_colors` are the editor's choices (index = the value in a code); `ranges` are the sliders' min, max and step. Build or read a code with /crosshair/code.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/crosshair"

Example response

{
  "presets": [
    {
      "name": "Game default",
      "settings": {
        "style": 0,
        "color": 0,
        "dot": 1.7,
        "spacing": 1.0,
        "length": 7.0,
        "width": 2.0,
        "outline": false,
        "outline_color": 0,
        "dynamic_visibility": true,
        "dynamic_spacing": true
      },
      "code": "RUST-FceIG-V4T",
      "page": "https://rust.wiki/crosshair?code=RUST-FceIG-V4T"
    },
    {
      "name": "Default, always visible",
      "settings": {
        "style": 0,
        "color": 0,
        "dot": 1.7,
        "spacing": 1.0,
        "length": 7.0,
        "width": 2.0,
        "outline": false,
        "outline_color": 0,
        "dynamic_visibility": false,
        "dynamic_spacing": false
      },
      "code": "RUST-FceIG-V3h",
      "page": "https://rust.wiki/crosshair?code=RUST-FceIG-V3h"
    },
    {
      "name": "Default with outline",
      "settings": {
        "style": 0,
        "color": 0,
        "dot": 1.7,
        "spacing": 1.0,
        "length": 7.0,
        "width": 2.0,
        "outline": true,
        "outline_color": 0,
        "dynamic_visibility": true,
        "dynamic_spacing": true
      },
      "code": "RUST-FceIG-VbV",
      "page": "https://rust.wiki/crosshair?code=RUST-FceIG-VbV"
    },
    "… 19 more"
  ],
  "styles": [
    {
      "index": 0,
      "name": "Default"
    },
    {
      "index": 1,
      "name": "Dot"
    },
    {
      "index": 2,
      "name": "T-Shape"
    }
  ],
  "colors": [
    {
      "index": 0,
      "name": "White",
      "hex": "#ffffff"
    },
    {
      "index": 1,
      "name": "Green",
      "hex": "#2bff2b"
    },
    {
      "index": 2,
      "name": "Blue",
      "hex": "#3d8bff"
    },
    "… 5 more"
  ],
  "outline_colors": [
    {
      "index": 0,
      "name": "Black",
      "hex": "#000000"
    },
    {
      "index": 1,
      "name": "Green",
      "hex": "#2bff2b"
    },
    {
      "index": 2,
      "name": "Blue",
      "hex": "#3d8bff"
    },
    "… 5 more"
  ],
  "ranges": {
    "dot": {
      "min": 0,
      "max": 5,
      "step": 0.05
    },
    "spacing": {
      "min": 0,
      "max": 3,
      "step": 0.05
    },
    "length": {
      "min": 1,
      "max": 20,
      "step": 0.1
    },
    "width": {
      "min": 1,
      "max": 8,
      "step": 0.1
    }
  },
  "default": {
    "style": 0,
    "color": 0,
    "dot": 1.7,
    "spacing": 1.0,
    "length": 7.0,
    "width": 2.0,
    "outline": false,
    "outline_color": 0,
    "dynamic_visibility": true,
    "dynamic_spacing": true
  },
  "how_to": "In game: F1 console, paste \`crosshair.load_code <code>\`; or Options > User Interface > Crosshair and import the code.",
  "page": "https://rust.wiki/crosshair"
}

GET/crosshair/codecopy URL

Make a Rust crosshair code from settings, or read one

The crosshair generator (https://rust.wiki/crosshair): start from `code` (or the game's default crosshair), change any setting, and get back the shareable `code`, the `console` line to paste into F1 (`crosshair.load_code...`), the page's console `commands` form, the full `settings` and a `page` link that opens it in the editor preview. Values are rounded to the editor's precision (0.01 for dot and spacing, 0.1 for length and width), as codes store them.

ParameterInTypeDefaultDescription
codequerystringA crosshair code to read (e.g. `RUST-FceIG-V4T`); other settings given with it are changed on top of it.
stylequerystringDefault, Dot or T-Shape (or 0-2).
colorquerystringWhite, Green, Blue, Red, Yellow, Magenta, Cyan or Black (or 0-7).
dotquerynumberDot size 0-5 (0 = no dot).
spacingquerynumberGap from the centre, 0-3.
lengthquerynumberLine length, 1-20.
widthquerynumberLine width, 1-8.
outlinequerybooleanDraw an outline.
outline_colorquerystringOutline colour: Black, Green, Blue, Red, Yellow, Magenta, Cyan or White (or 0-7).
dynamic_visibilityquerybooleanHide the crosshair while aiming down sights / moving (the game's dynamic visibility).
dynamic_spacingquerybooleanSpread the lines with weapon spread (the game's dynamic spacing).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/crosshair/code"

Example response

{
  "code": "RUST-FceIG-V4T",
  "console": "crosshair.load_code RUST-FceIG-V4T",
  "commands": "client.crosshair true\ncrosshair.style 0\ncrosshair.color 0\ncrosshair.dotsize 1.7\ncrosshair.spacing 1\ncrosshair.length 7\ncrosshair.width 2\ncrosshair.outline false…",
  "settings": {
    "style": 0,
    "color": 0,
    "dot": 1.7,
    "…": "11 more keys"
  },
  "page": "https://rust.wiki/crosshair?code=RUST-FceIG-V4T"
}

GET/calculators/circuit-simulator/computecopy URL

Simulate a Rust circuit: power on every wire and which devices run

The circuit simulator's solver (https://rust.wiki/calculators/circuit-simulator), Rust's power rules since the April 2024 rework: each part's `inputs` and `outputs` (rW), whether it's `on`, device and battery `status` ("Needs 10, gets 4", "Empty in 4 h 0 min"), the power on every wire, `power_generated`, `devices_on` of `devices_total`, and a `page` link that opens the same circuit on the board. A device takes its full draw or nothing; splitters share evenly between connected outputs; batteries give only what the parts after them draw, up to their maximum. Wiring something back into itself is reported as `short_circuit`.

ParameterInTypeDefaultDescription
parts requiredquerystringComma-separated `label:Part` - a part from /calculators/circuit-simulator (Large Solar Panel, Wind Turbine, Large Battery, Splitter, Electrical Branch, Switch, AND Switch...) or a powered device by name (Auto Turret, Ceiling Light, SAM Site...). Settings in brackets: `b:Large Battery(charge=50)`, `br:Electrical Branch(b=10)`, `sw:Switch(state=0)`. (min length 3, max length 3000)
wiresquerystringComma-separated `from>to` wires between labels, each end optionally `.port` - a port name or 1-based number (`sp.Out 2>t`, `br.Branch Out>l`, `g>sw.Switch On`). Default: first output to first input.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/circuit-simulator/compute?parts=s:Large%20Solar%20Panel,b:Large%20Battery,t:Auto%20Turret,l:Ceiling%20Light"

Example response

{
  "short_circuit": false,
  "power_generated": 20,
  "devices_on": 2,
  "devices_total": 2,
  "summary": "everything has power",
  "parts": [
    {
      "label": "s",
      "part": "Large Solar Panel",
      "kind": "solar",
      "shortname": "electric.solarpanel.large",
      "settings": {
        "out": 20
      },
      "inputs": [],
      "outputs": [
        {
          "port": "Power Out",
          "power": 20
        }
      ]
    },
    {
      "label": "b",
      "part": "Large Battery",
      "kind": "battery",
      "shortname": "electric.battery.rechargable.large",
      "settings": {
        "charge": 100
      },
      "inputs": [
        {
          "port": "Power In",
          "power": 20
        }
      ],
      "outputs": [
        {
          "port": "Power Out",
          "power": 12
        },
        {
          "port": "Fully Charged",
          "power": 1
        }
      ],
      "on": true,
      "status": "Full"
    },
    {
      "label": "t",
      "part": "Auto Turret",
      "kind": "device",
      "shortname": "autoturret",
      "draw": 10,
      "inputs": [
        {
          "port": "Power In",
          "power": 12
        }
      ],
      "outputs": [
        {
          "port": "Passthrough",
          "power": 2
        }
      ],
      "on": true,
      "status": "Working (uses 10)"
    },
    "… 1 more"
  ],
  "wires": [
    {
      "from": "s.Power Out",
      "to": "b.Power In",
      "power": 20
    },
    {
      "from": "b.Power Out",
      "to": "t.Power In",
      "power": 12
    },
    {
      "from": "t.Passthrough",
      "to": "l.Power In",
      "power": 2
    }
  ],
  "units": "power in rW, battery capacity in rWm",
  "rules": [
    "A device needs its full power to work - a ceiling light needs 2. Whatever's left goes out of its Passthrough.",
    "Switches, gates, timers, blockers, splitters, branches and combiners use no power (since April 2024). Sensors and radio parts use 1.",
    "A splitter shares its input evenly between the outputs you've connected; any remainder goes to the first ones, so nothing is lost.",
    "… 4 more"
  ],
  "page": "https://rust.wiki/calculators/circuit-simulator#c=eyJuIjpbWzEsIkxhcmdlIFNvbGFyIFBhbmVsIiw0MCw0MCx7Im91dCI6MjB9LG51bGxdLFsyLCJMYXJnZSBCYXR0ZXJ5IiwyODAsNDAseyJjYX…"
}

GET/base-designer/evaluatecopy URL

Price a Rust base: build/upgrade cost, upkeep, decay, HP and the cheapest raid path

The base designer's numbers for one design (https://rust.wiki/base-designer): `cost` (twig `placement`, `upgrade`, `deployables` = door/deployable recipes, `total`), `upkeep` (`per_day`/`per_week` by resource, `rate_pct` = the bracketed tax rate over `blocks`, `group_multiplier`), `hp`, `decay` (if the TC runs dry: `first_piece_hours`, `tc_open_hours` = when a free way in to the TC opens, `all_gone_hours`), and `raid`: the cheapest path from outside to the TC (`raid.tc`), to each loot room (`raid.loot`) and the whole raid (`raid.full`, TC first then each loot room). Each path has `sulfur` (or `seconds`/`tools` in eco mode), `explosives`, `raw` resources and its `layers` in order (piece index, name, the explosives for that layer, `side` soft/hard for eco raids, `splash` onto nearby pieces). Layers marked `unverified` are foundation steps, priced like a wall of the same grade as the game files say (pending an in-game check). `page` opens the same base in the 3D designer. Pieces the design gets wrong come back in `warnings`.

ParameterInTypeDefaultDescription
designquerystringA design as JSON: {"v":1,"p":[pieces]}, each piece {"t": type, "g": grade, "x": m, "z": m, "l": level, "r": degrees[, "y": m for wall/ceiling deployables]} - see /base-designer/pieces for the types (every placeable deployable included) and the coordinate rules. A rust.wiki/base-designer#d=... share link (or just its d= code) works too.
templatequeryone of `showcase`, `starter`, `2x2`, `2x2-2f`, `3x3-metal`One of the example bases instead of `design`.
sizequerystringInstead of `design`: a plain rectangular base of W x D square foundations, walls all round, one front door, the TC and two large boxes inside - e.g. 2x2.
floorsqueryinteger1With `size`: storeys (stairs are added). (max 6, min 1)
gradequeryone of `twig`, `wood`, `stone`, `metal`, `armored`stoneWith `size`: the grade of every piece.
doorquerystringdoor.hinged.metalWith `size`: the front door's item shortname.
explosivesquerystringstaples`staples` (rockets, C4, satchels, explosive ammo, beancans), `all`, or a comma list of explosive shortnames.
modequeryone of `mix`, `single`, `eco`mix`mix` (cheapest mix of explosives per piece, the raid calculator's default), `single` (one explosive per piece) or `eco` (melee, priced in seconds of work - soft sides matter).
ecoqueryone of `jackhammer`, `salvaged-icepick`, `pickaxe`, `salvaged-axe`, `hatchet`jackhammerTool for `mode=eco`.
playersqueryinteger1Players authorised on the TC (5 or more pay group upkeep). (max 200, min 1)
decayquerybooleanTrueRun the no-upkeep decay simulation.
timelinequerybooleanFalseInclude the decay timeline (hours, piece index) per destroyed piece.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/base-designer/evaluate"

GET/base-designer/piecescopy URL

Base designer pieces: every building piece, door, insert and deployable with HP and costs

What a base designer design can contain, and how pieces are placed. Building pieces have a cost and HP per grade (twig, wood, stone, metal = sheet metal, armored); inserts (doors, hatches, window bars) go INTO a doorway, wall frame, window or floor frame; deployables (tool cupboard, boxes...) stand inside a cell. `coordinates` explains the grid.

ParameterInTypeDefaultDescription
deployablesquerystringDeployables are many (380+): give a search word ("turret", "box"), a category (Storage & utility, Building, Electrical, Traps & defence, Farming & food, Fun & decor, Misc) or `all`. Left out, only the categories and their counts are listed.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/base-designer/pieces"

GET/monument-puzzlescopy URL

Monument puzzles: keycards, fuses, radiation and puzzle loot for every monument

One row per monument the game files have puzzle, radiation or bench data for: `cards` (keycard colours its doors take), `fuse_boxes`, `doors` (number of puzzle doors), `rad` (highest radiation zone, rads/s before protection: you need that much radiation protection to take none), `reset` (puzzle reset timer), `loot` (best things the puzzle rooms respawn, with `max` per reset and `url`), `amenities` (recycler, research_table, repair_bench, workbench levels). `rules`: fuse life, keycard swipes, radiation tiers, reset-radiation convars. Fetch one monument's full route with `/monument-puzzles/{slug}`.

ParameterInTypeDefaultDescription
cardquerystringOnly monuments with a door for this keycard.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/monument-puzzles"

Example response

{
  "count": 5,
  "monuments": [
    {
      "slug": "missile-silo",
      "name": "Missile Silo",
      "cards": [
        "red"
      ],
      "fuse_boxes": 0,
      "doors": 3,
      "rad": 80.0,
      "reset": "30 min",
      "amenities": {},
      "loot": [
        {
          "name": "Blueprint Book (pickup)",
          "max": 1.0,
          "url": "https://rust.wiki/item/blueprintbook"
        },
        {
          "name": "Elite Crate",
          "max": 4.0,
          "url": "https://rust.wiki/loot-table/116"
        },
        "… 2 more"
      ],
      "page": "https://rust.wiki/monument/missile-silo#puzzle"
    },
    {
      "slug": "launch-site",
      "name": "Launch Site",
      "cards": [
        "green",
        "red"
      ],
      "fuse_boxes": 2,
      "doors": 9,
      "rad": 51.0,
      "reset": "30 min",
      "amenities": {
        "research_table": 1,
        "repair_bench": 1,
        "recycler": 1
      },
      "loot": [
        {
          "name": "Blueprint Book (pickup)",
          "max": 1.0,
          "url": "https://rust.wiki/item/blueprintbook"
        },
        {
          "name": "Elite Crate",
          "max": 3.0,
          "url": "https://rust.wiki/loot-table/116"
        },
        "… 2 more"
      ],
      "page": "https://rust.wiki/monument/launch-site#puzzle"
    },
    "… 3 more"
  ],
  "rules": {
    "fuse_seconds": 200,
    "card_uses": {
      "green": 4.0,
      "blue": 4.0,
      "red": 2.0
    },
    "press_button_s": 5.0,
    "card_reader_on": "until reset or power loss",
    "rad_tiers": {
      "Minimal": 2.0,
      "Low": 10.0,
      "Medium": 25.0,
      "High": 51.0
    },
    "max_rad_protection": 50.0,
    "reset_rad": {
      "enabled": true,
      "pre_reset_s": 300.0,
      "empty_s": 120.0,
      "amount": 3.0,
      "radius_mult": 1.5,
      "radius_max_add": 20.0
    },
    "pause_unlooted": true,
    "reset_tick_s": 10.0,
    "powergrid_enabled": true,
    "fuse_text": "3 min 20 s",
    "pre_reset_text": "5 min",
    "empty_text": "2 min"
  },
  "page": "https://rust.wiki/monument-puzzles"
}

GET/monument-puzzles/{slug}copy URL

One monument's puzzle: every door, what opens it in order, resets and loot

`doors`: each puzzle door (`door` kind, `card` colour or null, `count` identical doors, `area` = the room's name in the game files when it has one) with `ways` to open it - ordered `steps` (`t` = grid/fuse/switch/timer/card/button with `seconds`, `colour`, `stage`, and a readable `text`) and `stays_open` - plus `exit_button` and `resets` (indexes into `resets`). `resets`: each PuzzleReset (`seconds`, `players_block` + `radius` or `ai_zone`, `pause_until_looted`, `radiation_push`) with the `loot` it respawns (`name`, `max` per reset, `url` to the loot table or item). `radiation`: zones by tier. `missions`: missions the monument's NPCs give.

ParameterInTypeDefaultDescription
slug requiredpathstringMonument slug from `/monuments`, e.g. `military-tunnel`. (min length 1, max length 80)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/monument-puzzles/military-tunnel"

Example response

{
  "slug": "the-dome",
  "name": "The Dome",
  "build": "26498655",
  "cards": [
    "green"
  ],
  "fuse_boxes": 1,
  "doors": [
    {
      "door": "green security door",
      "area": "",
      "card": "green",
      "cards": [
        "green"
      ],
      "needs_fuse": true,
      "switches": 1,
      "timer_s": null,
      "ways": [
        {
          "steps": [
            {
              "where": "",
              "t": "fuse",
              "seconds": 200,
              "text": "Insert an Electric Fuse in the fuse box - it lasts 3 min 20 s"
            },
            {
              "where": "",
              "t": "switch",
              "text": "Flip the switch"
            },
            "… 1 more"
          ],
          "text": "insert an Electric Fuse in the fuse box; flip the switch; swipe a Green Keycard",
          "stays_open": "open while the fuse lasts (3 min 20 s)"
        }
      ],
      "exit_button": true,
      "stays_open": "open while the fuse lasts (3 min 20 s)",
      "resets": [
        0
      ],
      "count": 1,
      "reset_nos": [
        1
      ]
    }
  ],
  "resets": [
    {
      "area": "",
      "ai_zone": false,
      "seconds": 1800.0,
      "players_block": true,
      "radius": 6.0,
      "scale_with_pop": false,
      "pause_until_looted": true,
      "radiation_push": true,
      "broadcast": false,
      "loot": [
        {
          "name": "Blueprint Page (pickup)",
          "loot_table": null,
          "item": "blueprintpage",
          "max": 1.0,
          "prefab": "blueprintpage_singlepickup.entity.prefab",
          "source_id": null,
          "url": "https://rust.wiki/item/blueprintpage"
        },
        {
          "name": "Blue Keycard (pickup)",
          "loot_table": null,
          "item": "keycard_blue",
          "max": 1.0,
          "prefab": "keycard_blue_pickup.entity.prefab",
          "source_id": null,
          "url": "https://rust.wiki/item/keycard_blue"
        },
        "… 1 more"
      ],
      "n": 1,
      "time": "30 min"
    }
  ],
  "radiation": {
    "max_rads": 10.0,
    "tiers": [
      {
        "tier": "Low",
        "rads": 10.0,
        "zones": 1
      }
    ],
    "custom": []
  },
  "rad_text": "10 rad",
  "rad_protection": 10.0,
  "amenities": {
    "recycler": 1
  },
  "puzzle_loot": [
    {
      "name": "Blueprint Page (pickup)",
      "loot_table": null,
      "item": "blueprintpage",
      "max": 1.0,
      "source_id": null,
      "url": "https://rust.wiki/item/blueprintpage"
    },
    {
      "name": "Blue Keycard (pickup)",
      "loot_table": null,
      "item": "keycard_blue",
      "max": 1.0,
      "source_id": null,
      "url": "https://rust.wiki/item/keycard_blue"
    },
    "… 1 more"
  ],
  "has_puzzle": true,
  "missions": [],
  "rules": {
    "fuse_seconds": 200,
    "card_uses": {
      "green": 4.0,
      "blue": 4.0,
      "red": 2.0
    },
    "press_button_s": 5.0,
    "card_reader_on": "until reset or power loss",
    "rad_tiers": {
      "Minimal": 2.0,
      "Low": 10.0,
      "Medium": 25.0,
      "High": 51.0
    },
    "max_rad_protection": 50.0,
    "reset_rad": {
      "enabled": true,
      "pre_reset_s": 300.0,
      "empty_s": 120.0,
      "amount": 3.0,
      "radius_mult": 1.5,
      "radius_max_add": 20.0
    },
    "pause_unlooted": true,
    "reset_tick_s": 10.0,
    "powergrid_enabled": true,
    "fuse_text": "3 min 20 s",
    "pre_reset_text": "5 min",
    "empty_text": "2 min"
  },
  "page": "https://rust.wiki/monument/the-dome#puzzle"
}

GET/spoilagecopy URL

Food spoil times, fridges, and composting fertilizer per item

`spoil`: every food that spoils (`item`, `hours` of normal storage, `becomes` = the spoiled item). `spoil_rules`: powered fridge / vending machine multipliers (0 = paused), the arctic biome (0), stack-merge limits. `compost`: every item a composter takes (`item`, `fertilizer` produced per item - fractions are rounded up at random) and `compost_rules` (`cycle_s` per item per stack, `slots`). Names come with each row.

ParameterInTypeDefaultDescription
itemquerystringOne item's spoil time and compost value (shortname).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/spoilage"

Example response

{
  "spoil": [
    {
      "item": "bearmeat",
      "hours": 6.0,
      "becomes": "bearmeat.spoiled",
      "name": "Raw Bear Meat",
      "becomes_name": "Spoiled Bear Meat"
    }
  ],
  "spoil_rules": {
    "enabled_default": true,
    "fridge_powered_multiplier": 0.0,
    "vending_powered_multiplier": 0.0,
    "arctic_biome_multiplier": 0.0,
    "arctic_biome_threshold": 0.1,
    "stack_merge_max_diff_s": 180.0,
    "stack_merge_threshold": 0.9
  },
  "compost": [
    {
      "item": "bearmeat",
      "fertilizer": 0.2,
      "name": "Raw Bear Meat"
    }
  ],
  "compost_rules": {
    "cycle_s": 300.0,
    "per_stack_per_cycle": 1,
    "slots": 8,
    "output": "fertilizer",
    "update_interval_convar": 300.0
  },
  "page": "https://rust.wiki/spoilage"
}

GET/armour-insertscopy URL

Armour inserts: protection added, clothing with insert slots, slot odds

`inserts`: each insert with `protection` per damage type in percent (added to the clothing's own, per insert) and `speed_reduction`. `clothing`: every item with insert slots (`min`/`max` slots, `crafted_only` - looted armour has none, `covers` body parts, base `protection_pct`). `slot_odds`: chance of each slot count at craft time, keyed "min-max", with no crafting-quality bonus.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/armour-inserts"

Example response

{
  "build": "26498655",
  "columns": [
    {
      "key": "Bullet",
      "label": "Bullet"
    },
    {
      "key": "Arrow",
      "label": "Arrow"
    },
    "… 8 more"
  ],
  "inserts": [
    {
      "shortname": "clothing.mod.armorinsert_asbestos",
      "name": "Asbestos Armor Insert",
      "icon_url": "https://files.facepunch.com/rust/item/clothing.mod.armorinsert_asbestos_64.png",
      "url": "https://rust.wiki/item/clothing.mod.armorinsert_asbestos",
      "protection": {
        "Bullet": 1.0,
        "Arrow": 0,
        "Slash": 1.0,
        "Stab": 1.0,
        "Blunt": 1.0,
        "Explosion": 50.0,
        "Heat": 65.0,
        "ElectricShock": 65.0,
        "ColdExposure": 0,
        "RadiationExposure": 0
      },
      "speed_reduction": 0.0
    },
    {
      "shortname": "clothing.mod.armorinsert_lead",
      "name": "Lead Armor Insert",
      "icon_url": "https://files.facepunch.com/rust/item/clothing.mod.armorinsert_lead_64.png",
      "url": "https://rust.wiki/item/clothing.mod.armorinsert_lead",
      "protection": {
        "Bullet": 1.0,
        "Arrow": 1.0,
        "Slash": 1.0,
        "Stab": 1.0,
        "Blunt": 1.0,
        "Explosion": 0,
        "Heat": 0,
        "ElectricShock": 0,
        "ColdExposure": 0,
        "RadiationExposure": 5.0
      },
      "speed_reduction": 0.0
    },
    "… 3 more"
  ],
  "clothing": [
    {
      "shortname": "hazmatsuit.diver",
      "name": "Abyss Hazmat",
      "icon_url": "https://files.facepunch.com/rust/item/hazmatsuit.diver_64.png",
      "url": "https://rust.wiki/item/hazmatsuit.diver",
      "min": 1,
      "max": 3,
      "crafted_only": true,
      "covers": [
        "head",
        "chest",
        "… 5 more"
      ],
      "protection": {
        "Bullet": 0.3,
        "Arrow": 0.3,
        "Slash": 0.3,
        "Stab": 0.3,
        "Blunt": 0.3,
        "Explosion": 0.3
      },
      "protection_pct": {
        "Bullet": 30,
        "Arrow": 30,
        "Slash": 30,
        "Stab": 30,
        "Blunt": 30,
        "Explosion": 30
      }
    },
    {
      "shortname": "hazmatsuit.arcticsuit",
      "name": "Arctic Suit",
      "icon_url": "https://files.facepunch.com/rust/item/hazmatsuit.arcticsuit_64.png",
      "url": "https://rust.wiki/item/hazmatsuit.arcticsuit",
      "min": 1,
      "max": 3,
      "crafted_only": true,
      "covers": [
        "head",
        "chest",
        "… 5 more"
      ],
      "protection": {
        "Bullet": 0.3,
        "Arrow": 0.3,
        "Slash": 0.2,
        "Stab": 0.3,
        "Blunt": 0.2,
        "Explosion": 0.2
      },
      "protection_pct": {
        "Bullet": 30,
        "Arrow": 30,
        "Slash": 20,
        "Stab": 30,
        "Blunt": 20,
        "Explosion": 20
      }
    },
    "… 32 more"
  ],
  "slot_odds": {
    "1-1": {
      "0": 0.5,
      "1": 0.5
    },
    "1-3": {
      "0": 0.5,
      "1": 0.25,
      "2": 0.15,
      "3": 0.1
    },
    "2-3": {
      "0": 0.5,
      "2": 0.25,
      "3": 0.25
    }
  },
  "page": "https://rust.wiki/armour-inserts"
}

GET/pet-gearcopy URL

Frankenstein pet parts and the stats they change

`parts`: each Frankenstein head/torso/legs part with flat changes to the pet's `speed`, `max_health`, `attack_damage` and `attack_rate_s` (seconds between attacks: positive = slower). The only pet gear in this build.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/pet-gear"

Example response

{
  "build": "26498655",
  "parts": [
    {
      "shortname": "frankensteins.monster.01.head",
      "name": "Light Frankenstein Head",
      "icon_url": "https://files.facepunch.com/rust/item/frankensteins.monster.01.head_64.png",
      "url": "https://rust.wiki/item/frankensteins.monster.01.head",
      "speed": 0.2,
      "max_health": -50.0,
      "attack_damage": 0.0,
      "attack_rate_s": 1.0
    },
    {
      "shortname": "frankensteins.monster.01.legs",
      "name": "Light Frankenstein Legs",
      "icon_url": "https://files.facepunch.com/rust/item/frankensteins.monster.01.legs_64.png",
      "url": "https://rust.wiki/item/frankensteins.monster.01.legs",
      "speed": 1.0,
      "max_health": -20.0,
      "attack_damage": 0.0,
      "attack_rate_s": 0.0
    },
    "… 4 more"
  ],
  "page": "https://rust.wiki/pet-gear"
}

GET/missionscopy URL

NPC missions: where they're given, steps, rewards, time limits, repeat timers

`locations`: each monument with mission givers and its `missions` - `name`, `desc`, ordered `objectives` (`text`), `rewards` (`item` shortname + `amount`, or `other` for non-item rewards like the Outpost spawn unlock), `time_limit`, `repeat` (cooldown after success, or "once per wipe"), `requires` (missions to finish first). Without `monument`, also `tutorial` (tutorial-island missions) and `unplaced` (in the files, not offered on standard maps).

ParameterInTypeDefaultDescription
monumentquerystringOnly missions given at this monument (slug).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/missions"

Example response

{
  "build": "26498655",
  "locations": [
    {
      "monument": "outpost",
      "name": "Outpost",
      "missions": [
        {
          "key": "oilrigmission",
          "name": "Oil Rig Supply Run",
          "desc": null,
          "tutorial": false,
          "objectives": [
            {
              "text": "Go to the marked location",
              "optional": false,
              "cls": "Move"
            },
            {
              "text": "Go to the marked location",
              "optional": false,
              "cls": "Move"
            },
            "… 3 more"
          ],
          "rewards": [
            {
              "item": "scrap",
              "amount": 200,
              "other": null,
              "name": "Scrap",
              "icon_url": "https://files.facepunch.com/rust/item/scrap_64.png",
              "url": "https://rust.wiki/item/scrap"
            }
          ],
          "reward_choices": 1,
          "time_limit_s": null,
          "repeat_s": 5400,
          "retry_after_fail_s": 5400,
          "can_abandon": true,
          "requires": [],
          "followup": null,
          "given_at": [
            "outpost"
          ],
          "giver": [
            "Outpost A"
          ],
          "other_eras": false,
          "repeat": "1 h 30 min",
          "time_limit": null,
          "requires_names": []
        },
        {
          "key": "safezonespawnunlock",
          "name": "Outpost validation",
          "desc": "We have heard reports of other locations on the island that are considered \"safe\" for subjects like yourself. Find one and bring back some documentation about how the area is organized.",
          "tutorial": false,
          "objectives": [
            {
              "text": "Go to the safe zone",
              "optional": false,
              "cls": "Move"
            },
            {
              "text": "Retrieve the documents",
              "optional": false,
              "cls": "AcquireItem"
            },
            "… 1 more"
          ],
          "rewards": [
            {
              "item": null,
              "amount": null,
              "other": "Unlock permanent Outpost spawn point",
              "name": "Unlock permanent Outpost spawn point"
            }
          ],
          "reward_choices": 1,
          "time_limit_s": null,
          "repeat_s": null,
          "retry_after_fail_s": 600,
          "can_abandon": true,
          "requires": [],
          "followup": null,
          "given_at": [
            "outpost"
          ],
          "giver": [
            "Outpost A"
          ],
          "other_eras": false,
          "repeat": "once per wipe",
          "time_limit": null,
          "requires_names": []
        },
        "… 1 more"
      ]
    }
  ],
  "tutorial": [],
  "unplaced": [],
  "page": "https://rust.wiki/missions"
}

GET/tipscopy URL

Rust's official game and loading-screen tips, in any rust.wiki language

`groups`: topics, each with its `tips` - `key` (the game's phrase key), `kind` (game = in-game hint, menu = loading screen), `text` with key binds filled in as `[Key]` (Rust's default binds), `segments` (`k`: t text / k key / v value), `source` (official = Facepunch's own wording; machine = our translation for Indonesian/Thai, which Rust doesn't ship; english = the game has no translation in that language), `links` (related wiki pages). `binds`: the default keys used.

ParameterInTypeDefaultDescription
langquerystringenLanguage code: en or one of the wiki's 18 (de, es, ja, ru, zh, pt-br,...). (max length 8)
groupquerystringOnly one topic, e.g. `staying-alive`, `building-your-base`, `fishing`.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/tips"

GET/achievementscopy URL

Every Rust achievement: exact unlock condition from the game code + global unlock %

`achievements` (most common first): `key` (Steam api name), `name`, `desc` (Steam's text), `pct` (share of all Rust players who have it), `how` (the exact condition, from the server code; for `type` client it is Steam's text), `type` (server_direct / server_field / steam_stat / client / new), `hidden`, `progress_max` + `stat` for counter achievements, `items` (shortnames), `note` (caveats). `stats`: the counters the game tracks and what increments them. `global_rules`: achievements only unlock on official servers.

ParameterInTypeDefaultDescription
qquerystringFilter by words in the name, description or key.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/achievements"

GET/achievements/{key}copy URL

One Rust achievement: how to unlock it, from the game code

Same fields as one row of `/achievements`, plus `global_rules`.

ParameterInTypeDefaultDescription
key requiredpathstringSteam api name, e.g. `PRO_ANGLER` (case-insensitive). (min length 2, max length 60)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/achievements/PRO_ANGLER"

GET/seasonal-eventscopy URL

Rust seasonal events: Advent Calendar by day, birthday, Christmas, Halloween, Easter

From the server code. `advent`: `days` (Dec 16-25) with `rewards`, `primitive` alternatives and `by_era` (what Primitive/Medieval/Frontier/Modern servers give or skip), `rules`, `clock` (server-clock dates), the calendar `item`. `birthday`: Dec 7-16 window, cake + party hat. `christmas`: `rules`, `convars`, `presents`/`stockings`/`gift_box` loot odds (`chance_pct`, `min`/`max`), `tree`, `dungeon`, sleigh. `halloween`/`easter`: hunts, prizes, convars. `status`: whether the dated events are on now (UTC) or days until they start. `how_servers_switch_it_on`: commands. Every rule has a `source` (decompiled file:line or prefab).

ParameterInTypeDefaultDescription
eventquerystringOnly one event.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/seasonal-events"

GET/horses/breedscopy URL

Every horse breed: gallop speed, health and spawn chance, fastest first

One row per breed, fastest first: `speed_mult` (multiplies the gallop only), `gallop_kmh` / `gallop_ms` with no gear, `gallop_road_kmh` on a road or railway, `best_kmh` (High Quality Horse Shoes + road + apple boost), `hp`, `spawn_pct` (breeds are rolled at random when a horse spawns; horses can't be bred). Answers "which horse is fastest".

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/horses/breeds"

Example response

{
  "build": "26498655",
  "count": 10,
  "fastest": [
    "Black Thoroughbred",
    "White Thoroughbred"
  ],
  "breeds": [
    {
      "key": "black-thoroughbred",
      "name": "Black Thoroughbred",
      "speed_mult": 1.25,
      "health_mult": 1.0,
      "hp": 400.0,
      "spawn_chance": 0.1,
      "gallop_ms": 17.5,
      "gallop_kmh": 63.0,
      "gallop_road_kmh": 67.5,
      "best_ms": 25.0,
      "best_kmh": 90.0,
      "spawn_pct": 10.0,
      "stamina": 60.0
    },
    {
      "key": "white-thoroughbred",
      "name": "White Thoroughbred",
      "speed_mult": 1.25,
      "health_mult": 1.0,
      "hp": 400.0,
      "spawn_chance": 0.1,
      "gallop_ms": 17.5,
      "gallop_kmh": 63.0,
      "gallop_road_kmh": 67.5,
      "best_ms": 25.0,
      "best_kmh": 90.0,
      "spawn_pct": 10.0,
      "stamina": 60.0
    },
    "…"
  ],
  "page": "https://rust.wiki/horses#breeds"
}

GET/horses/speedcopy URL

Top speed of a horse for a breed and its gear, on or off road

The game's formula (RidableHorse.GetCurrentMaxSpeed): at a gallop, `(14 + road bonus + every gear speed change + boost) x breed speed multiplier`. Returns `gallop_kmh`/`gallop_ms`, every gait's top speed, the extra `storage_slots` and `stamina_seconds_full` (how long a full 60 stamina gallops). 422 for an unknown breed/item or more than 4 gear items.

ParameterInTypeDefaultDescription
breedquerystringwhite-thoroughbredBreed key from `/horses/breeds`, e.g. `chestnut`. (min length 2, max length 40)
shoesquerystring`horse.shoes.basic` or `horse.shoes.advanced`.
armourquerystring`horse.armor.wood`, `horse.armor.roadsign` or `horse.armor.lny26`.
saddlebagsqueryinteger0How many saddlebags (each -1 m/s, +12 storage slots). (max 4, min 0)
roadquerybooleanFalseGalloping on a road or railway (+1 m/s, half the stamina use).
boostquerystringA gallop boost item: `apple` or `syringe.medical`.
towingquerybooleanFalseAlso return the speed limit while towing a siege weapon.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/horses/speed"

Example response

{
  "build": "26498655",
  "breed": "white-thoroughbred",
  "breed_name": "White Thoroughbred",
  "breed_speed_mult": 1.25,
  "road": true,
  "road_bonus_ms": 1.0,
  "gear": [
    {
      "item": "horse.shoes.advanced",
      "name": "High Quality Horse Shoes",
      "ms": 2.5
    }
  ],
  "boost": {
    "item": "apple",
    "name": "Apple",
    "ms": 2.5,
    "seconds": 60.0
  },
  "gallop_ms": 25.0,
  "gallop_kmh": 90.0,
  "gaits": [
    {
      "gait": "walk",
      "max_ms": 2.0,
      "max_kmh": 7.2
    },
    {
      "gait": "trot",
      "max_ms": 4.5,
      "max_kmh": 16.2
    },
    "…"
  ],
  "storage_slots": 0,
  "stamina_seconds_full": 120.0,
  "formula": "(gallop 14 + road 1 + gear + boost) x breed 1.25",
  "page": "https://rust.wiki/horses#calculator"
}

GET/horsescopy URL

Horses: breeds, gaits, stamina, food, saddles, shoes, armour, stables, decay, towing

Everything on rust.wiki/horses. `breeds` (as `/horses/breeds`); `gaits` (top speed and stamina per gait); `stamina` (max 60, gallop cost, road/swim factors, regen, how food raises it); `gear` (each saddle/shoe/armour/saddlebag: gallop speed change, storage, scrap price at the Stables, recipe, `horse_taken`/`rider_taken` = % of each damage type that gets through; `protection_note`: without armour a horse takes full damage in game - the prefab's resistances are wiped by the server); `foods` (per food: `stamina_core` added, `heal`, `dung`, boosts); `stables`, `spawn` (wild horses: biomes, per km²); `decay`, `dung`, `towing`, `convars`, `rules` (code facts: no breeding, breed stamina unused...).

ParameterInTypeDefaultDescription
sectionquerystringOnly one part, to keep the answer short.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/horses"

Example response

{
  "build": "26498655",
  "gear": [
    {
      "item": "horse.saddle.single",
      "name": "Single Horse Saddle",
      "slot": "saddle",
      "slot_label": "Saddle",
      "speed_ms": 0.0,
      "speed_kmh": 0.0,
      "storage_slots": 0,
      "seats": 1,
      "buy_scrap": 75,
      "craftable": false,
      "dlc": false,
      "workbench": null,
      "ingredients": [],
      "horse_taken": null,
      "rider_taken": null,
      "icon_url": "https://files.facepunch.com/rust/item/horse.saddle.single_256.png"
    },
    {
      "item": "horse.saddle.double",
      "name": "Double Horse Saddle",
      "slot": "saddle_double",
      "slot_label": "Saddle",
      "speed_ms": 0.0,
      "speed_kmh": 0.0,
      "storage_slots": 0,
      "seats": 2,
      "buy_scrap": 90,
      "craftable": false,
      "dlc": false,
      "workbench": null,
      "ingredients": [],
      "horse_taken": null,
      "rider_taken": null,
      "icon_url": "https://files.facepunch.com/rust/item/horse.saddle.double_256.png"
    },
    "…"
  ],
  "saddles": [
    {
      "item": "horse.saddle.single",
      "name": "Single Horse Saddle",
      "slot": "saddle",
      "slot_label": "Saddle",
      "speed_ms": 0.0,
      "speed_kmh": 0.0,
      "storage_slots": 0,
      "seats": 1,
      "buy_scrap": 75,
      "craftable": false,
      "dlc": false,
      "workbench": null,
      "ingredients": [],
      "horse_taken": null,
      "rider_taken": null,
      "icon_url": "https://files.facepunch.com/rust/item/horse.saddle.single_256.png"
    },
    {
      "item": "horse.saddle.double",
      "name": "Double Horse Saddle",
      "slot": "saddle_double",
      "slot_label": "Saddle",
      "speed_ms": 0.0,
      "speed_kmh": 0.0,
      "storage_slots": 0,
      "seats": 2,
      "buy_scrap": 90,
      "craftable": false,
      "dlc": false,
      "workbench": null,
      "ingredients": [],
      "horse_taken": null,
      "rider_taken": null,
      "icon_url": "https://files.facepunch.com/rust/item/horse.saddle.double_256.png"
    }
  ],
  "page": "https://rust.wiki/horses"
}

GET/clanscopy URL

Clan score: every scoring event, its points and who earns it, plus clan settings, roles and limits

`events`: the 17 clan score events (`label`, `score` points, `who` earns them, `convar` that changes it or null when it is fixed, `pvp`), highest first. PvP events are 0 on vanilla and have no setting. Also `convars` (clan.enabled, clan.maxmembercount, clan.editsrequireclantable), admin `commands`, `limits` (name/message lengths), default `roles` and the `clan_table` recipe.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/clans"

Example response

{
  "build": "26498655",
  "events": [
    {
      "event": "DestroyedBradley",
      "id": 7,
      "label": "Destroying the Bradley APC",
      "who": "The player who lands the killing blow.",
      "score": 50,
      "convar": "clan.scorefordestroyingbradley",
      "help": "How much score players earn for destroying bradley",
      "pvp": false
    },
    {
      "event": "DestroyedPatrolHeli",
      "id": 11,
      "label": "Shooting down the Patrol Helicopter",
      "who": "The player who lands the killing blow.",
      "score": 50,
      "convar": "clan.scorefordestroyingpatrolheli",
      "help": "How much score players earn for destroying patrol heli",
      "pvp": false
    },
    "…"
  ],
  "earning": [
    {
      "event": "DestroyedBradley",
      "id": 7,
      "label": "Destroying the Bradley APC",
      "who": "The player who lands the killing blow.",
      "score": 50,
      "convar": "clan.scorefordestroyingbradley",
      "help": "How much score players earn for destroying bradley",
      "pvp": false
    },
    {
      "event": "DestroyedPatrolHeli",
      "id": 11,
      "label": "Shooting down the Patrol Helicopter",
      "who": "The player who lands the killing blow.",
      "score": 50,
      "convar": "clan.scorefordestroyingpatrolheli",
      "help": "How much score players earn for destroying patrol heli",
      "pvp": false
    },
    "…"
  ],
  "pvp": [
    {
      "event": "ClanPlayerDied",
      "id": 2,
      "label": "Being killed by another clan",
      "who": "A player from a different clan kills you (scored for your clan).",
      "score": 0,
      "convar": null,
      "help": "",
      "pvp": true
    },
    {
      "event": "DestroyedToolCupboard",
      "id": 4,
      "label": "Destroying a Tool Cupboard",
      "who": "You destroy a Tool Cupboard whose owner is in a clan.",
      "score": 0,
      "convar": null,
      "help": "",
      "pvp": true
    },
    "…"
  ],
  "max_event": {
    "event": "DestroyedBradley",
    "id": 7,
    "label": "Destroying the Bradley APC",
    "who": "The player who lands the killing blow.",
    "score": 50,
    "convar": "clan.scorefordestroyingbradley",
    "help": "How much score players earn for destroying bradley",
    "pvp": false
  },
  "convars": [
    {
      "key": "clan.enabled",
      "default": true,
      "help": "Enables the clan system if set to true (must be set at boot, requires restart)"
    },
    {
      "key": "clan.maxmembercount",
      "default": 100,
      "help": "Maximum number of members each clan can have (local backend only!)"
    },
    "…"
  ],
  "commands": [
    {
      "command": "clan.info",
      "help": "Prints info about a clan given its ID or a steamID of a player in that clan"
    },
    {
      "command": "clan.disband",
      "help": "Disbands your current clan"
    },
    "…"
  ],
  "limits": {
    "name_min": 3,
    "name_max": 32,
    "motd_max": 4096,
    "note_max": 256,
    "chat_max": 128
  },
  "roles": [
    {
      "name": "Leader",
      "rank": null,
      "can": [
        "access_logs",
        "access_score_events",
        "…"
      ]
    },
    {
      "name": "Member",
      "rank": null,
      "can": [
        "access_score_events"
      ]
    }
  ],
  "generic_score": 1,
  "clan_table": {
    "item": "clantable",
    "name": "Clan Table",
    "recipe": [
      {
        "item": "wood",
        "amount": 200.0
      },
      {
        "item": "metal.fragments",
        "amount": 100.0
      }
    ],
    "workbench": 1,
    "icon_url": "https://files.facepunch.com/rust/item/clantable_256.png",
    "ingredients": [
      {
        "item": "wood",
        "amount": 200.0,
        "icon_url": "https://files.facepunch.com/rust/item/wood_64.png",
        "name": "Wood"
      },
      {
        "item": "metal.fragments",
        "amount": 100.0,
        "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_64.png",
        "name": "Metal Fragments"
      }
    ]
  },
  "achievement": {
    "key": "CLAN_SCORE",
    "url": "https://rust.wiki/achievements#CLAN_SCORE"
  },
  "page": "https://rust.wiki/clans"
}

GET/vehiclescopy URL

Every vehicle: health, fuel per minute, seats, storage and vendor price

One row per vehicle (`key`, `name`, `category` air/water/land/rail, `hp`, `seats`, `storage_slots`, `fuel_per_min` at full throttle, `buy_scrap` at the Air Wolf or boat vendor, `url`). Fetch everything about one with `/vehicles/{key}`.

ParameterInTypeDefaultDescription
categoryquerystringOnly this kind of vehicle.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/vehicles"

Example response

{
  "build": "26498655",
  "count": 4,
  "categories": {
    "air": "Air",
    "water": "Water",
    "land": "Land",
    "rail": "Rail"
  },
  "vehicles": [
    {
      "key": "minicopter",
      "name": "Minicopter",
      "category": "air",
      "hp": 750.0,
      "seats": 2,
      "storage_slots": 0,
      "fuel_per_min": 30.0,
      "buy_scrap": 750,
      "icon_url": "https://files.facepunch.com/rust/item/minihelicopter.repair_256.png",
      "url": "https://rust.wiki/vehicles/minicopter"
    },
    {
      "key": "scrap-transport-helicopter",
      "name": "Scrap Transport Helicopter",
      "category": "air",
      "hp": 1000.0,
      "seats": 2,
      "storage_slots": 0,
      "fuel_per_min": 30.0,
      "buy_scrap": 1250,
      "icon_url": "https://files.facepunch.com/rust/item/scraptransportheli_256.png",
      "url": "https://rust.wiki/vehicles/scrap-transport-helicopter"
    },
    {
      "key": "attack-helicopter",
      "name": "Attack Helicopter",
      "category": "air",
      "hp": 850.0,
      "seats": 2,
      "storage_slots": 0,
      "fuel_per_min": 30.0,
      "buy_scrap": 2250,
      "icon_url": "https://files.facepunch.com/rust/item/attackhelicopter_256.png",
      "url": "https://rust.wiki/vehicles/attack-helicopter"
    }
  ],
  "page": "https://rust.wiki/vehicles"
}

GET/vehicles/{key}copy URL

One vehicle: HP, damage taken, fuel, decay, price, repair cost, explosives to destroy

`hp`; `damage_taken` (% of each damage type it takes after its armour - 300% = triple); `fuel` (`per_min` at full throttle, `idle_per_min`, `tank`, `tank_minutes`); `seats`, `storage_slots`; `decay` (each timer with its ConVar); `buy` (scrap at the vendor), `craft`, `repair_full` (cost from near-zero to full); `explosives` (direct hits of each explosive to destroy it from full HP); `engine` (kW / thrust, `max_speed_kmh` for trains); `horse` (gaits and breeds); `convars` (the server settings behind the numbers, with their defaults). `modular-car` also returns `car`: chassis, every module (HP, seats, engine kW, fuel use, storage, recipe) and engine parts by tier.

ParameterInTypeDefaultDescription
key requiredpathstringVehicle key from `/vehicles`, e.g. `minicopter`, `rhib`, `modular-car`. (min length 1, max length 60)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/vehicles/minicopter"

Example response

{
  "build": "26498655",
  "key": "minicopter",
  "name": "Minicopter",
  "class": "Minicopter",
  "category": "air",
  "hp": 750.0,
  "protection": "player_helicopter_protection",
  "seats": 2,
  "drivers": 1,
  "storage_slots": 0,
  "buy": {
    "scrap": 750,
    "where": "Air Wolf vendor (Bandit Camp)",
    "convar": "npc.vendor_minicopter_enabled"
  },
  "rockets": null,
  "gun_slots": null,
  "flares": {
    "item": "flare",
    "cooldown_s": 30.0
  },
  "torpedo_slots": null,
  "building_privilege": null,
  "doors": null,
  "pedal_powered": null,
  "sprint": null,
  "rider_protection": null,
  "driver_protection": null,
  "horse": null,
  "category_label": "Air",
  "url": "https://rust.wiki/vehicles/minicopter",
  "how_to_get": "Buy at the Air Wolf vendor (Bandit Camp).",
  "fuel": {
    "item": "lowgradefuel",
    "item_name": "Low Grade Fuel",
    "per_min": 30.0,
    "idle_per_min": null,
    "tank": 500,
    "tank_minutes": 16.7
  },
  "decay": [
    {
      "label": "Loses all its health indoors in",
      "minutes": 2880.0,
      "text": "48 h",
      "convar": "playerhelicopter.insidedecayminutes"
    },
    {
      "label": "Loses all its health outside in",
      "minutes": 480.0,
      "text": "8 h",
      "convar": "playerhelicopter.outsidedecayminutes"
    }
  ],
  "damage_taken": [
    {
      "type": "Bullet",
      "label": "Bullets",
      "pct": 5,
      "note": null
    },
    {
      "type": "Explosion",
      "label": "Explosions",
      "pct": 300,
      "note": "takes extra"
    },
    {
      "type": "AntiVehicle",
      "label": "Anti-vehicle (HV rockets, SAM)",
      "pct": 100,
      "note": null
    },
    {
      "type": "Heat",
      "label": "Fire",
      "pct": 300,
      "note": "takes extra"
    }
  ],
  "explosives": [
    {
      "item": "ammo.rocket.basic",
      "label": "Rocket",
      "damage": 825.0,
      "hits": 1,
      "name": "Rocket"
    },
    {
      "item": "ammo.rocket.hv",
      "label": "High Velocity Rocket",
      "damage": 397.5,
      "hits": 2,
      "name": "High Velocity Rocket"
    },
    {
      "item": "explosive.timed",
      "label": "Timed Explosive Charge (C4)",
      "damage": 1650.0,
      "hits": 1,
      "name": "Timed Explosive Charge (C4)"
    },
    {
      "item": "explosive.satchel",
      "label": "Satchel Charge",
      "damage": 225.0,
      "hits": 4,
      "name": "Satchel Charge"
    }
  ],
  "engine": {
    "kw": null,
    "thrust": 3000.0,
    "force": null,
    "max_speed_ms": null,
    "max_speed_kmh": null,
    "lift": null,
    "auto_surface_s": null,
    "paddle": null
  },
  "repair_full": [
    {
      "item": "metal.fragments",
      "name": "Metal Fragments",
      "amount": 250,
      "icon_url": "https://files.facepunch.com/rust/item/metal.fragments_64.png"
    }
  ],
  "craft": null,
  "item": "minihelicopter.repair",
  "world_slug": "minicopter",
  "convars": [
    {
      "key": "playerhelicopter.insidedecayminutes",
      "default": "2880",
      "help": "How long before a player helicopter loses all its health while indoors"
    },
    {
      "key": "playerhelicopter.outsidedecayminutes",
      "default": "480",
      "help": "How long before a player helicopter loses all its health while outside"
    },
    {
      "key": "npc.vendor_minicopter_enabled",
      "default": "True",
      "help": ""
    }
  ],
  "icon_url": "https://files.facepunch.com/rust/item/minihelicopter.repair_256.png",
  "page": "https://rust.wiki/vehicles/minicopter"
}

GET/bestiarycopy URL

Every animal, NPC and boss: HP, hardest hit, aggro range, top speed

One row per creature (`key`, `name`, `group`, `hp`, `max_hit`, `aggro_range` in metres, `top_speed` m/s, `players_reaction` attacks/flees for animals, `url`). Fetch one with `/bestiary/{key}`.

ParameterInTypeDefaultDescription
groupquerystringOnly this group.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/bestiary"

Example response

{
  "build": "26498655",
  "count": 9,
  "groups": {
    "predators": "Predators",
    "prey": "Prey & passive animals",
    "livestock": "Livestock",
    "npcs": "Scientists & NPCs",
    "event": "Event NPCs",
    "bosses": "Bosses"
  },
  "creatures": [
    {
      "key": "bear",
      "name": "Bear",
      "group": "predators",
      "kind": "animal",
      "hp": 325.0,
      "max_hit": 35.0,
      "aggro_range": 15.0,
      "top_speed": 8.0,
      "players_reaction": "attacks",
      "url": "https://rust.wiki/bestiary/bear",
      "icon_url": "https://files.facepunch.com/rust/item/bearmeat_256.png"
    },
    {
      "key": "polar-bear",
      "name": "Polar Bear",
      "group": "predators",
      "kind": "animal",
      "hp": 420.0,
      "max_hit": 45.0,
      "aggro_range": 20.0,
      "top_speed": 8.0,
      "players_reaction": "attacks",
      "url": "https://rust.wiki/bestiary/polar-bear",
      "icon_url": "https://files.facepunch.com/rust/item/bearmeat_256.png"
    },
    {
      "key": "wolf",
      "name": "Wolf",
      "group": "predators",
      "kind": "animal",
      "hp": 150.0,
      "max_hit": 30.0,
      "aggro_range": 30.0,
      "top_speed": 9.0,
      "players_reaction": "attacks",
      "url": "https://rust.wiki/bestiary/wolf",
      "icon_url": "https://files.facepunch.com/rust/item/wolfmeat.raw_256.png"
    }
  ],
  "page": "https://rust.wiki/bestiary"
}

GET/bestiary/{key}copy URL

One animal, NPC or boss: HP, attacks, senses, speeds, gather yields, weapons, loot

`hp`, `damage_taken` (% per damage type), `attacks` (`damage`, `type`), `attack_interval_s`, `attack_range`, `senses` (vision/sense range and angle, hearing), `aggro_range`, `speeds` (m/s per gait), `chase_speed`, `flee_below_health`, `gather` (full-harvest yields), `weapons` (NPCs: per-shot damage after the NPC's damage scale), `wear`, `loot_url` (opens the loot simulator on its body/crate). Bosses add guns, rockets, crates, respawn and explosives to destroy.

ParameterInTypeDefaultDescription
key requiredpathstringCreature key from `/bestiary`, e.g. `bear`, `heavy-scientist`, `bradley-apc`. (min length 1, max length 60)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/bestiary/bear"

Example response

{
  "build": "26498655",
  "key": "polar-bear",
  "name": "Polar Bear",
  "kind": "animal",
  "class": "PolarBear",
  "hp": 420.0,
  "protection": "bear.protection",
  "world_slug": "polar-bear",
  "attack_range": 2.5,
  "attack_interval_s": 3.0,
  "chase_give_up_s": 20.0,
  "flee_below_health": 0.2,
  "chase_speed": 8.0,
  "players_reaction": "attacks",
  "where": null,
  "damage_scale": null,
  "egg_every_s": null,
  "shark": null,
  "snake": null,
  "team": "Bear",
  "group": "predators",
  "url": "https://rust.wiki/bestiary/polar-bear",
  "damage_taken": [
    {
      "type": "Bullet",
      "label": "Bullets",
      "pct": 100,
      "note": null
    },
    {
      "type": "Arrow",
      "label": "Arrows",
      "pct": 100,
      "note": null
    },
    {
      "type": "Slash",
      "label": "Slash",
      "pct": 100,
      "note": null
    },
    {
      "type": "Stab",
      "label": "Stab",
      "pct": 150,
      "note": "takes extra"
    }
  ],
  "attacks": [
    {
      "name": "AnimalBite",
      "damage": 45.0,
      "type": "Bite",
      "range": null,
      "label": "Animal bite"
    }
  ],
  "max_hit": 45.0,
  "dps": 15.0,
  "speeds": {
    "sneak": 0.53,
    "walk": 0.79,
    "jog": 2.18,
    "run": 3.91,
    "sprint": 5.33,
    "full_sprint": 8.0
  },
  "top_speed": 8.0,
  "senses": {
    "vision_range": 20.0,
    "vision_half_angle": 143.0,
    "hearing_range": null,
    "touch_range": 5.0,
    "food_range": null,
    "fire_range": 20.0,
    "forget_s": 30.0
  },
  "aggro_range": 20.0,
  "gather": [
    {
      "item": "bearmeat",
      "name": "Raw Bear Meat",
      "amount": 22.0,
      "icon_url": "https://files.facepunch.com/rust/item/bearmeat_64.png"
    },
    {
      "item": "bone.fragments",
      "name": "Bone Fragments",
      "amount": 170.0,
      "icon_url": "https://files.facepunch.com/rust/item/bone.fragments_64.png"
    },
    {
      "item": "fat.animal",
      "name": "Animal Fat",
      "amount": 120.0,
      "icon_url": "https://files.facepunch.com/rust/item/fat.animal_64.png"
    },
    {
      "item": "leather",
      "name": "Leather",
      "amount": 125.0,
      "icon_url": "https://files.facepunch.com/rust/item/leather_64.png"
    }
  ],
  "weapons": [],
  "wear": [],
  "loot_key": null,
  "loot_url": null,
  "icon_url": "https://files.facepunch.com/rust/item/bearmeat_256.png",
  "placeholder_icon": "https://rust.wiki/static/images/wiki/world-creature.svg",
  "page": "https://rust.wiki/bestiary/polar-bear"
}

GET/traps-and-turretscopy URL

Turrets and traps: damage, range, arc, ammo, power, HP, recipe, TC rules

Every player trap/turret plus the NPC safe-zone turrets: `hp`, `damage_text`, the raw damage fields, `sight_range`, `arc_degrees`, `range`, `power` (electricity), ammo/fuel, `craft` recipe, `needs_privilege_to_use`, `notes` (targeting and Tool Cupboard rules), `explosives` to destroy.

ParameterInTypeDefaultDescription
keyquerystringJust one, e.g. `autoturret`, `samsite`, `guntrap`, `trap-landmine`, `electric-teslacoil`.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/traps-and-turrets"

Example response

{
  "build": "26498655",
  "count": 1,
  "traps": [
    {
      "key": "autoturret",
      "item": "autoturret",
      "name": "Auto Turret",
      "class": "AutoTurret",
      "hp": 1000.0,
      "protection": "turret_protection",
      "craft": {
        "craftable": true,
        "workbench": 2,
        "research_scrap": 300,
        "ingredients": [
          {
            "item": "targeting.computer",
            "name": "Targeting Computer",
            "amount": 1,
            "icon_url": "https://files.facepunch.com/rust/item/targeting.computer_64.png"
          },
          {
            "item": "cctv.camera",
            "name": "CCTV Camera",
            "amount": 1,
            "icon_url": "https://files.facepunch.com/rust/item/cctv.camera_64.png"
          },
          {
            "item": "metal.refined",
            "name": "High Quality Metal",
            "amount": 25,
            "icon_url": "https://files.facepunch.com/rust/item/metal.refined_64.png"
          }
        ]
      },
      "stack": 1,
      "needs_privilege_to_use": true,
      "pickup": true,
      "power": 10,
      "sight_range": 30.0,
      "aim_cone": 4.0,
      "weapon_slots": 1,
      "ammo_slots": 6,
      "arc_degrees": 180.0,
      "max_interference": 12,
      "interference_radius": 40.0,
      "hostile_duration_s": 120.0,
      "target_all": false,
      "damage_taken": [
        {
          "type": "Bullet",
          "label": "Bullets",
          "pct": 10,
          "note": null
        },
        {
          "type": "Explosion",
          "label": "Explosions",
          "pct": 100,
          "note": null
        },
        {
          "type": "Heat",
          "label": "Fire",
          "pct": 20,
          "note": null
        },
        {
          "type": "Blunt",
          "label": "Blunt",
          "pct": 50,
          "note": null
        }
      ],
      "explosives": [
        {
          "item": "ammo.rocket.basic",
          "label": "Rocket",
          "damage": 312.5,
          "hits": 4
        },
        {
          "item": "ammo.rocket.hv",
          "label": "High Velocity Rocket",
          "damage": 345.0,
          "hits": 3
        },
        {
          "item": "explosive.timed",
          "label": "Timed Explosive Charge (C4)",
          "damage": 550.0,
          "hits": 2
        },
        {
          "item": "explosive.satchel",
          "label": "Satchel Charge",
          "damage": 275.0,
          "hits": 4
        }
      ],
      "anchor": "autoturret",
      "notes": [
        "Shoots at anyone in its 180° arc it can see, out to its sight range - except players on its authorised list.",
        "Peacekeeper mode: only shoots players marked hostile, i.e. who attacked someone in the last 2 minutes (sentry.hostileduration).",
        "Only players authorised on the base's Tool Cupboard can loot it, rotate it or change its authorised list; it needs a gun and ammo of that gun's type in its inventory.",
        "Interference: every turret within the interference radius counts against a cap; turrets past it go offline."
      ],
      "ammo_name": null,
      "icon_url": "https://files.facepunch.com/rust/item/autoturret_256.png",
      "item_name": "Auto Turret",
      "damage_text": "Uses the gun you load"
    }
  ],
  "page": "https://rust.wiki/traps-and-turrets"
}

GET/event-timerscopy URL

World event timers: Cargo Ship, Patrol Heli, Chinook, Bradley, airdrops, satellite, Deep Sea

Each event's `every` (in-game hours and the real-time equivalent with the default day length), its `facts` (durations, crates, hack timer...), the `convars` that control it and `links`. `clan_score`: points per clan event. Vanilla defaults; servers can change them.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/event-timers"

Example response

{
  "build": "26498655",
  "day_length_minutes": 80.0,
  "game_hour_minutes": 3.33,
  "events": [
    {
      "key": "cargo",
      "name": "Cargo Ship",
      "blurb": "Sails in from the map edge, loops the island and leaves. Scientists guard it and locked crates refill while it sails.",
      "every": {
        "game_hours": [
          45.0,
          78.0
        ],
        "real_minutes": [
          150,
          260
        ],
        "text": "45-78 game hours (about 2.5 h-4.3 h)",
        "kind": "EventSchedule"
      },
      "facts": [
        "Sails for 50 minutes, then leaves the map over 10 more.",
        "Locked crates appear in 3 rounds, 10 minutes apart."
      ],
      "convars": [
        {
          "key": "cargoship.event_enabled",
          "default": "true",
          "help": ""
        },
        {
          "key": "cargoship.event_duration_minutes",
          "default": "50",
          "help": ""
        }
      ],
      "links": [
        {
          "label": "Cargo Ship scientists",
          "url": "https://rust.wiki/bestiary/cargo-scientist"
        },
        {
          "label": "Locked crate loot",
          "url": "https://rust.wiki/calculators/loot-simulator?c=locked-crate"
        }
      ]
    },
    {
      "key": "patrol_heli",
      "name": "Patrol Helicopter",
      "blurb": "Flies over the map hunting players; shoot it down for its crates.",
      "every": {
        "game_hours": [
          36.0,
          54.0
        ],
        "real_minutes": [
          120,
          180
        ],
        "text": "36-54 game hours (about 2 h-3 h)",
        "kind": "EventSchedule"
      },
      "facts": [
        "Stays up for 30 minutes, then leaves.",
        "10,000 HP; drops up to 4 crates when it's shot down."
      ],
      "convars": [
        {
          "key": "heli.lifetimeminutes",
          "default": "30",
          "help": "(Generated) How many minutes the patrol helicopter stays airborne before self-destructing; default is 30 minutes"
        },
        {
          "key": "heli.bulletdamagescale",
          "default": "1",
          "help": "(Generated) Multiplier applied to all bullet damage dealt by the patrol helicopter; 1.0 = normal, 2.0 = double damage"
        }
      ],
      "links": [
        {
          "label": "Patrol Helicopter stats",
          "url": "https://rust.wiki/bestiary/patrol-helicopter"
        },
        {
          "label": "Heli crate loot",
          "url": "https://rust.wiki/calculators/loot-simulator?c=heli-crate"
        }
      ]
    }
  ],
  "server_events": {
    "key": "server.events",
    "default": "true",
    "help": "(Generated) Enables automatic server-side game events such as helicopter patrols, airdrops and cargo ship visits"
  },
  "clan_score": [
    {
      "event": "Destroying the Bradley APC",
      "score": 50,
      "convar": "clan.scorefordestroyingbradley"
    },
    {
      "event": "Destroying the Patrol Helicopter",
      "score": 50,
      "convar": "clan.scorefordestroyingpatrolheli"
    }
  ],
  "page": "https://rust.wiki/events"
}

GET/apartmentscopy URL

Apartment Complex: rooms, prices, minimum rent, tax table, eviction rules

`rooms` (`size`, `label`, `count`, `price` scrap, `min_rent` scrap per day), `tax` (scrap per full stack of each taxed item), `rent_scaling` (0 by default: rent is just the minimum), eviction/free-rent/master-key/break-in values. Work out a rent with `/apartments/rent`.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/apartments"

Example response

{
  "rent_scaling": 0.0,
  "eviction_delay_s": 86400.0,
  "free_rent_hours": 4.0,
  "master_key_price": 1000,
  "break_in_s": 30.0,
  "intruder_auth_s": 300.0,
  "owner_range_m": 200.0,
  "rooms": [
    {
      "size": 1,
      "label": "Small",
      "count": 21,
      "price": 25,
      "min_rent": 10
    },
    {
      "size": 2,
      "label": "Medium",
      "count": 41,
      "price": 150,
      "min_rent": 50
    },
    {
      "size": 3,
      "label": "Large",
      "count": 7,
      "price": 350,
      "min_rent": 100
    }
  ],
  "tax": [
    {
      "item": "diesel_barrel",
      "name": "Diesel Fuel",
      "scrap_per_stack": 40.0,
      "stack": 20,
      "icon_url": "https://files.facepunch.com/rust/item/diesel_barrel_64.png"
    },
    {
      "item": "sulfur",
      "name": "Sulfur",
      "scrap_per_stack": 25.0,
      "stack": 1000,
      "icon_url": "https://files.facepunch.com/rust/item/sulfur_64.png"
    },
    {
      "item": "metal.refined",
      "name": "High Quality Metal",
      "scrap_per_stack": 20.0,
      "stack": 100,
      "icon_url": "https://files.facepunch.com/rust/item/metal.refined_64.png"
    },
    {
      "item": "sulfur.ore",
      "name": "Sulfur Ore",
      "scrap_per_stack": 20.0,
      "stack": 1000,
      "icon_url": "https://files.facepunch.com/rust/item/sulfur.ore_64.png"
    }
  ],
  "convars": [
    {
      "key": "apartment.rentscaling",
      "default": "0",
      "help": "Should the rent scale based on the items you have stored inside your apartment?"
    },
    {
      "key": "apartment.apartmentevictiondelay",
      "default": "86400",
      "help": "How long should we wait before evicting a player from their apartment if they don't pay rent?"
    },
    {
      "key": "apartment.apartmentfreerenthours",
      "default": "4",
      "help": "How many hours of scrap upkeep does the apartments spawn with (so players don't see 'Eviction' vital right after renting an apartment"
    },
    {
      "key": "apartment.masterkeyprice",
      "default": "1000",
      "help": "How much scrap the apartment security NPC charges for a master key"
    }
  ],
  "build": "26498655",
  "page": "https://rust.wiki/apartments"
}

GET/apartments/rentcopy URL

Daily apartment rent for a room size and what you keep in it

The game's formula: `max(minimum rent, sum(tax per stack x amount / stack size) x apartment.rentscaling)` scrap per real day, taken continuously from the room's upkeep terminal; evicted after `eviction_after_s` unpaid.

ParameterInTypeDefaultDescription
sizequeryinteger21 small, 2 medium, 3 large. (max 3, min 1)
itemsquerystringComma-separated `shortname:amount` you store in the room or carry nearby, e.g. `sulfur:5000,metal.fragments:10000`. (max length 600)
rent_scalingquerynumberOverride apartment.rentscaling (the server's value; vanilla 0).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/apartments/rent"

Example response

{
  "build": "26498655",
  "size": 2,
  "min_rent": 50,
  "rent_scaling": 1.0,
  "item_tax": 165.0,
  "daily_rent": 165.0,
  "daily_rent_scrap": 165,
  "lines": [
    {
      "item": "sulfur",
      "name": "Sulfur",
      "amount": 5000,
      "stacks": 5.0,
      "tax": 125.0
    },
    {
      "item": "diesel_barrel",
      "name": "Diesel Fuel",
      "amount": 20,
      "stacks": 1.0,
      "tax": 40.0
    }
  ],
  "eviction_after_s": 86400.0,
  "page": "https://rust.wiki/apartments"
}

GET/gesturescopy URL

Every gesture: console name, unlock (free, pack, DLC, admin), length and limits

`gestures`: one per gesture - `command` (the console name: `bind g "gesture <command>"`), `name`, `desc` (`desc_source` "game" = Facepunch's text, "rust.wiki" = ours), `unlock` (`type` free / steam_item (an Item Store pack, with `itemdefid` + `name`) / dlc (`appid` + `name`) / cinematic = admins, or everyone with server.cinematic on), `unlock_text`, `unlock_url`, `duration_s`, `loops`, `full_body` (can't be used mounted, swimming or crouched), `can_move`, `in_wheel` (false = the game plays it for you), `two_player`, `bind` (a ready bind line).

ParameterInTypeDefaultDescription
unlockquerystringOnly gestures unlocked this way.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/gestures"

Example response

{
  "build": "26498655",
  "count": 3,
  "gestures": [
    {
      "command": "cabbagepatch",
      "name": "Cabbage Patch",
      "anim": "sillydance",
      "type": "player",
      "unlock": {
        "type": "dlc",
        "appid": 1670430,
        "name": "Voice Props Pack"
      },
      "duration_s": 8.04,
      "loops": true,
      "full_body": true,
      "can_move": false,
      "can_cancel": true,
      "can_crouch": false,
      "hides_held_item": true,
      "in_wheel": true,
      "two_player": false,
      "action": "dance",
      "desc": "The Cabbage Patch dance.",
      "desc_source": "rust.wiki",
      "gesture_id": 1855420636,
      "unlock_text": "Voice Props Pack DLC",
      "unlock_url": "https://store.steampowered.com/app/1670430/",
      "bind": "bind g \"gesture cabbagepatch\""
    },
    {
      "command": "raiseroof",
      "name": "Raise the Roof",
      "anim": "hiphopdance",
      "type": "player",
      "unlock": {
        "type": "dlc",
        "appid": 1670430,
        "name": "Voice Props Pack"
      },
      "duration_s": 8.04,
      "loops": true,
      "full_body": true,
      "can_move": false,
      "can_cancel": true,
      "can_crouch": false,
      "hides_held_item": true,
      "in_wheel": true,
      "two_player": false,
      "action": "dance",
      "desc": "Raise the Roof dance.",
      "desc_source": "rust.wiki",
      "gesture_id": 478760625,
      "unlock_text": "Voice Props Pack DLC",
      "unlock_url": "https://store.steampowered.com/app/1670430/",
      "bind": "bind g \"gesture raiseroof\""
    },
    {
      "command": "twist",
      "name": "The Twist",
      "anim": "sillydance2",
      "type": "player",
      "unlock": {
        "type": "dlc",
        "appid": 1670430,
        "name": "Voice Props Pack"
      },
      "duration_s": 8.04,
      "loops": true,
      "full_body": true,
      "can_move": false,
      "can_cancel": true,
      "can_crouch": false,
      "hides_held_item": true,
      "in_wheel": true,
      "two_player": false,
      "action": "dance",
      "desc": "The Twist dance.",
      "desc_source": "rust.wiki",
      "gesture_id": 1702547860,
      "unlock_text": "Voice Props Pack DLC",
      "unlock_url": "https://store.steampowered.com/app/1670430/",
      "bind": "bind g \"gesture twist\""
    }
  ],
  "unlock_packs": {
    "steam_item:10273": {
      "name": "Jungle Pack",
      "type": "steam_item",
      "itemdefid": 10273,
      "gestures": [
        "beatchest"
      ]
    },
    "steam_item:10270": {
      "name": "Gesture Pack",
      "type": "steam_item",
      "itemdefid": 10270,
      "gestures": [
        "crankfinger",
        "throatcut",
        "doublemiddlefinger"
      ]
    },
    "dlc:1670430": {
      "name": "Voice Props Pack",
      "type": "dlc",
      "appid": 1670430,
      "gestures": [
        "cabbagepatch",
        "raiseroof",
        "twist"
      ]
    }
  },
  "page": "https://rust.wiki/gestures"
}

GET/dlccopy URL

Rust DLC and Item Store packs: what each unlocks in game, Twitch drops

`dlc`: each Steam DLC (`key`, `name`, `appid`, `store_url`, `items` it unlocks). `packs`: every Steam inventory item (mostly Item Store packs) that unlocks game items - `itemdefid`, `name`, `desc`, `limited`, `url` (Steam item store), `items`. `twitch`: every Twitch-drop Steam item in the files and the items it unlocks (most are skins and unlock nothing new). With `item`: just that item's requirement (`kind` dlc / steam_item / twitch, or null when anyone can craft it). Each DLC also carries `steam_price`: today's US Steam store price (`price`, `initial`, in cents; `discount` percent; `price_text`) or `on_steam` false when Steam doesn't sell it; `prices_fetched_at` says when it was read (refreshed every few hours; null before the first read).

ParameterInTypeDefaultDescription
itemquerystringOne item: which DLC or Steam item unlocks it (shortname).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/dlc"

Example response

{
  "item": "piano",
  "requires": {
    "kind": "dlc",
    "name": "Instrument Pack",
    "url": "https://store.steampowered.com/app/1174370/",
    "page": "https://rust.wiki/dlc#instruments"
  },
  "page": "https://rust.wiki/dlc"
}

GET/survival-mechanicscopy URL

Healing, comfort and heat sources, food/water drain, radiation, fall damage - from the code

Everything on https://rust.wiki/survival-mechanics. `k`: the constants read from the decompiled game code (heal conditions `heal_*`, drains, temperature, wetness, bleeding, radiation `rad_*`, fall damage `fall_*`, gravity). `limits`: the player's metabolism ranges. `heal`: HP/s by calories and comfort for a 100 HP player. `drain`: calories and water per minute by activity. `comfort`: every comfort source (`comfort` 0-1, `full_within` and `zero_at` metres, `radius`, `kind` deployable / map-placed / monument, `count` in the files). `heat`: every heat, cold and shade source (`temperature`, `full_within`, `radius`; `shade` rows cool by `shade_cools` in daylight). `falls`: damage at common heights (awake player, estimated gravity - see calculate_fall_damage).

ParameterInTypeDefaultDescription
sectionquerystringOnly one part: healing, comfort, heat, food, fall or constants.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/survival-mechanics"

Example response

{
  "comfort": [
    {
      "name": "Bear Skin Rug",
      "item": "rug.bear",
      "kind": "deployable",
      "prefab": "assets/prefabs/deployable/rug/rug.bear.deployed.prefab",
      "comfort": 1.0,
      "radius": 3.0,
      "full_within": 2.0,
      "zero_at": 3.0,
      "horses": false,
      "count": 2,
      "icon_url": "https://files.facepunch.com/rust/item/rug.bear_64.png",
      "url": "https://rust.wiki/item/rug.bear"
    },
    {
      "name": "Engineering Workbench",
      "item": "iotable",
      "kind": "deployable",
      "prefab": "assets/prefabs/deployable/io research table/io.table.deployed.prefab",
      "comfort": 1.0,
      "radius": 4.0,
      "full_within": 2.5,
      "zero_at": 3.51,
      "horses": false,
      "count": 1,
      "icon_url": "https://files.facepunch.com/rust/item/iotable_64.png",
      "url": "https://rust.wiki/item/iotable"
    },
    {
      "name": "Pookie Bear",
      "item": "pookie.bear",
      "kind": "deployable",
      "prefab": "assets/prefabs/misc/xmas/pookie/pookie_deployed.prefab",
      "comfort": 1.0,
      "radius": 6.0,
      "full_within": 3.0,
      "zero_at": 4.01,
      "horses": false,
      "count": 1,
      "icon_url": "https://files.facepunch.com/rust/item/pookie.bear_64.png",
      "url": "https://rust.wiki/item/pookie.bear"
    }
  ],
  "build": "26498655",
  "counts": {
    "comfort_triggers": 306,
    "heat_triggers": 376,
    "comfort_rows": 176,
    "heat_rows": 194
  },
  "page": "https://rust.wiki/survival-mechanics"
}

GET/calculators/fall-damage/computecopy URL

Fall damage from a height or a landing speed

Damage = 500 x InverseLerp(15, 100, landing speed m/s), before clothing protection (BasePlayer. ApplyFallDamageFromVelocity), plus bleeding 0.5 x the same fraction. Returns `damage`, `bleeding`, `speed_ms`, `height_m`, `safe_height_m` (no damage below), `lethal_height_m` (100 damage), `gravity_ms2` and `height_is_estimate`. Speed -> damage is exact; heights assume no air resistance.

ParameterInTypeDefaultDescription
heightquerynumberFall height in metres.
speedquerynumberLanding speed in m/s (overrides height).
playerquerystringawakeawake (gravity estimated - awake movement runs on the client) or sleeping (the server's own fall for sleeping/wounded players, from the code). (pattern ^(awake|sleeping)$)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/calculators/fall-damage/compute"

Example response

{
  "speed_ms": 22.15,
  "height_m": 10.0,
  "mode": "awake",
  "gravity_ms2": 24.525,
  "damage": 42.0,
  "bleeding": 0.042,
  "lethal_at_100hp": false,
  "safe_height_m": 4.59,
  "lethal_height_m": 20.88,
  "height_is_estimate": true,
  "note": "Speed -> damage is from the server code. The height assumes awake-player gravity of 9.81 x 2.5 m/s^2 - an estimate: awake movement runs on the client, which the server files don't include. Damage is before clothing protection.",
  "page": "https://rust.wiki/survival-mechanics#fall"
}

GET/instrumentscopy URL

Playable instruments: notes, mouse notes, octaves, keyboard maps, autoplay songs

Every instrument (`item` shortname, `name`, `dlc`): `notes` (pitch names, lowest first; drum kit = drum pieces), `lowest`/`highest`, `primary_click`/`secondary_click` (mouse notes), `default_octave`/`shifted_octave`, `max_notes_at_once`, `keyboard` (full-keyboard mode: key label -> note, UK QWERTY as the game's map), `song` (the built-in autoplay song: `notes`, `seconds`, `lowest`/`highest`, `chords` - described, no audio). `tips`: the game's own control tips.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/instruments"

Example response

{
  "build": "26498655",
  "instruments": [
    {
      "item": "fun.guitar",
      "name": "Acoustic Guitar",
      "short": "acousticguitar",
      "percussion": false,
      "notes": [
        "E2",
        "F2",
        "F#2"
      ],
      "note_count": 44,
      "drum_pieces": null,
      "lowest": "E2",
      "highest": "B5",
      "midi_numbers": [
        40,
        41,
        42
      ],
      "primary_click": "A3",
      "secondary_click": "B3",
      "default_octave": 3,
      "shifted_octave": 4,
      "max_notes_at_once": 3,
      "hold_to_sustain": true,
      "sustain_pedal": false,
      "loops_while_held": false,
      "max_note_s": null,
      "full_keyboard": true,
      "keyboard_map_file": "qwerty-uk.acousticguitar.json",
      "keyboard": {
        "Z": "E2",
        "J": "E2",
        "]": "E2",
        "X": "F2",
        "K": "F2",
        "\\": "F2",
        "C": "G2",
        "L": "G2",
        "1": "G2",
        "V": "A2",
        ";": "A2",
        "2": "A2"
      },
      "autoplay": true,
      "song": {
        "notes": 49,
        "seconds": 18.2,
        "distinct": 7,
        "chords": 5,
        "lowest": "G2",
        "highest": "C4",
        "notes_used": [
          "G2",
          "A2",
          "E3"
        ],
        "per_second": 2.7
      },
      "stat": "notesplayed_acousticguitar",
      "icon_url": "https://files.facepunch.com/rust/item/fun.guitar_256.png",
      "url": "https://rust.wiki/item/fun.guitar",
      "dlc": null,
      "primary_text": "A3",
      "secondary_text": "B3"
    },
    {
      "item": "fun.jerrycanguitar",
      "name": "Jerry Can Guitar",
      "short": "jerrycanguitar",
      "percussion": false,
      "notes": [
        "E2",
        "F2",
        "F#2"
      ],
      "note_count": 44,
      "drum_pieces": null,
      "lowest": "E2",
      "highest": "B5",
      "midi_numbers": [
        40,
        41,
        42
      ],
      "primary_click": "A3",
      "secondary_click": "B3",
      "default_octave": 3,
      "shifted_octave": 4,
      "max_notes_at_once": 3,
      "hold_to_sustain": true,
      "sustain_pedal": false,
      "loops_while_held": false,
      "max_note_s": null,
      "full_keyboard": true,
      "keyboard_map_file": "qwerty-uk.jerrycanguitar.json",
      "keyboard": {
        "Z": "E2",
        "L": "E2",
        "3": "E2",
        "X": "F2",
        ";": "F2",
        "4": "F2",
        "C": "G2",
        "'": "G2",
        "5": "G2",
        "V": "A2",
        "Q": "A2",
        "6": "A2"
      },
      "autoplay": true,
      "song": {
        "notes": 51,
        "seconds": 23.7,
        "distinct": 10,
        "chords": 0,
        "lowest": "E2",
        "highest": "G3",
        "notes_used": [
          "E2",
          "F2",
          "G2"
        ],
        "per_second": 2.1
      },
      "stat": "notesplayed_jerrycanguitar",
      "icon_url": "https://files.facepunch.com/rust/item/fun.jerrycanguitar_256.png",
      "url": "https://rust.wiki/item/fun.jerrycanguitar",
      "dlc": {
        "kind": "dlc",
        "name": "Instrument Pack",
        "url": "https://store.steampowered.com/app/1174370/",
        "page": "https://rust.wiki/dlc#instruments"
      },
      "primary_text": "A3",
      "secondary_text": "B3"
    },
    {
      "item": "fun.flute",
      "name": "Pan Flute",
      "short": "flute",
      "percussion": false,
      "notes": [
        "C4",
        "C#4",
        "D4"
      ],
      "note_count": 36,
      "drum_pieces": null,
      "lowest": "C4",
      "highest": "B6",
      "midi_numbers": [
        60,
        61,
        62
      ],
      "primary_click": "A5",
      "secondary_click": "B5",
      "default_octave": 5,
      "shifted_octave": 1,
      "max_notes_at_once": 1,
      "hold_to_sustain": true,
      "sustain_pedal": false,
      "loops_while_held": true,
      "max_note_s": 8.0,
      "full_keyboard": true,
      "keyboard_map_file": "qwerty-uk.flute.json",
      "keyboard": {
        "Z": "C5",
        ",": "C5",
        "G": "C5",
        "Q": "C5",
        "I": "C5",
        "2": "C5",
        "9": "C5",
        "X": "D5",
        ".": "D5",
        "H": "D5",
        "W": "D5",
        "O": "D5"
      },
      "autoplay": true,
      "song": {
        "notes": 35,
        "seconds": 11.7,
        "distinct": 7,
        "chords": 0,
        "lowest": "C5",
        "highest": "B5",
        "notes_used": [
          "C5",
          "D5",
          "E5"
        ],
        "per_second": 3.0
      },
      "stat": "notesplayed_flute",
      "icon_url": "https://files.facepunch.com/rust/item/fun.flute_256.png",
      "url": "https://rust.wiki/item/fun.flute",
      "dlc": {
        "kind": "dlc",
        "name": "Instrument Pack",
        "url": "https://store.steampowered.com/app/1174370/",
        "page": "https://rust.wiki/dlc#instruments"
      },
      "primary_text": "A5",
      "secondary_text": "B5"
    }
  ],
  "tips": {
    "gametip_instrumentplay": "You can play instruments with the numpad buttons",
    "gametip_instrumentfullkeyboard": "Press reload [+reload] to switch to full keyboard mode",
    "gametip_instrumentnumlock": "Turn numlock on to play this instrument"
  },
  "page": "https://rust.wiki/instruments"
}

GET/instruments/{item}copy URL

One instrument: notes, mouse notes, octaves, keyboard map, autoplay song

One instrument from `/instruments` with the same fields.

ParameterInTypeDefaultDescription
item requiredpathstringItem shortname (e.g. `piano`, `fun.guitar`) or short name (`acousticguitar`). (min length 1, max length 40)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/instruments/piano"

Example response

{
  "item": "fun.flute",
  "name": "Pan Flute",
  "short": "flute",
  "percussion": false,
  "notes": [
    "C4",
    "C#4",
    "D4"
  ],
  "note_count": 36,
  "drum_pieces": null,
  "lowest": "C4",
  "highest": "B6",
  "midi_numbers": [
    60,
    61,
    62
  ],
  "primary_click": "A5",
  "secondary_click": "B5",
  "default_octave": 5,
  "shifted_octave": 1,
  "max_notes_at_once": 1,
  "hold_to_sustain": true,
  "sustain_pedal": false,
  "loops_while_held": true,
  "max_note_s": 8.0,
  "full_keyboard": true,
  "keyboard_map_file": "qwerty-uk.flute.json",
  "keyboard": {
    "Z": "C5",
    ",": "C5",
    "G": "C5",
    "Q": "C5",
    "I": "C5",
    "2": "C5",
    "9": "C5",
    "X": "D5",
    ".": "D5",
    "H": "D5",
    "W": "D5",
    "O": "D5"
  },
  "autoplay": true,
  "song": {
    "notes": 35,
    "seconds": 11.7,
    "distinct": 7,
    "chords": 0,
    "lowest": "C5",
    "highest": "B5",
    "notes_used": [
      "C5",
      "D5",
      "E5"
    ],
    "per_second": 3.0
  },
  "stat": "notesplayed_flute",
  "icon_url": "https://files.facepunch.com/rust/item/fun.flute_256.png",
  "url": "https://rust.wiki/item/fun.flute",
  "dlc": {
    "kind": "dlc",
    "name": "Instrument Pack",
    "url": "https://store.steampowered.com/app/1174370/",
    "page": "https://rust.wiki/dlc#instruments"
  },
  "primary_text": "A5",
  "secondary_text": "B5",
  "page": "https://rust.wiki/instruments#fun.flute"
}

GET/skins/{itemdefid}/game-filescopy URL

A skin as Rust's own approved-skin list has it: workshop id, base item, flags, release batch

From Rust.Workshop.dll (Approved.cs) - exact, not matched by name: `workshopid`, `item` (base item shortname), `tradable`, `marketable`, `crate_drop`, `twitch_drop`, `added` (the date of the store-update batch it shipped in) and `batch`. 404 for skins older than the list (2015 workshop skins) or newer than the game build.

ParameterInTypeDefaultDescription
itemdefid requiredpathintegerThe skin's Steam item definition id. (min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/skins/20518/game-files"

Example response

{
  "itemdefid": 20518,
  "workshopid": 827190175,
  "item": "door.hinged.metal",
  "name": "Doomsday Door",
  "tradable": true,
  "marketable": true,
  "crate_drop": true,
  "twitch_drop": false,
  "added": "2016-12-29",
  "batch": "December_29_2016",
  "batch_label": "",
  "build": "26498655",
  "page": "https://rust.wiki/skin/20518"
}

GET/game-modescopy URL

Rust game modes compared (Vanilla, Softcore, Hardcore, Primitive) and the Era system

`compare`: rule-by-rule table (`values` in the order of `modes`: vanilla, softcore, hardcore, primitive; only rules that differ). `modes`: each mode's own added/removed/changed feature text from the game, the ConVars it sets (`value` vs `default`, with `help`), and its tech tree per workbench. `hardcore_items`: the 37 items Hardcore restricts with `how` (Loot only = can't be crafted, researched or bought; Not sold; Removed) and `allowed` sources. `eras`: server.era values and the items tagged with each era (a server set to an era can't loot, craft or buy items of a later era). `recipe_overrides`, `era_vending`, `era_missions`, `era_loot`: what Primitive changes. `test_modes`: round-based modes in the files that no normal server runs. With `item=`: `{item, name, hardcore, era, primitive_recipe}` (null parts don't apply).

ParameterInTypeDefaultDescription
modequerystringOnly this mode's rules.
itemquerystringAn item shortname: just that item's Hardcore and era status.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/game-modes"

GET/guidescopy URL

Latest Rust guides from the RustProfit blog

Every published post on blog.rustprofit.com, newest first: `title`, `slug`, `url`, `summary`, `author`, `published` (UTC). Guides cover monuments, recyclers, farming and genetics, base building, raiding, PvP gear, NPCs, wipes, Facepunch update explainers and skin trading. To find posts by words use `/guides/search`; for one post's text use `/guides/posts/{slug}`. Refreshed the moment a post is published.

ParameterInTypeDefaultDescription
topicquerystringOnly posts in one topic (slug from `/guides/topics`, e.g. `base-building`).
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/guides"

Example response

{
  "page": 1,
  "per_page": 3,
  "total": 324,
  "pages": 108,
  "results": [
    {
      "title": "Rust Power Usage: How Much Power Each Device Needs",
      "slug": "rust-power-usage-chart",
      "url": "https://blog.rustprofit.com/rust-power-usage-chart",
      "summary": "How much power each Rust device needs: SAM Site 25, Auto Turret 10, Electric Furnace 3 and more, with generator outputs and battery runtimes.",
      "author": "RustProfit Team",
      "published": "2026-11-10T15:00:00+00:00"
    },
    {
      "title": "Rust Boat Building: Parts, Costs and How It Works",
      "slug": "rust-boat-building-guide",
      "url": "https://blog.rustprofit.com/rust-boat-building-guide",
      "summary": "How boat building works in Rust: the Boat Building Station, hull and deck costs, engines, sails, anchors and cannons, and how fragile a boat is.",
      "author": "RustProfit Team",
      "published": "2026-11-03T15:00:00+00:00"
    },
    "…"
  ]
}

GET/guides/topicscopy URL

Every topic (tag) on the RustProfit blog with its `slug`, `label`, number of `posts` and archive `url`, biggest first. Pass a slug as `topic` to `/guides`.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/guides/topics"

Example response

{
  "total": 36,
  "results": [
    {
      "slug": "devblog",
      "label": "Devblog",
      "posts": 230,
      "url": "https://blog.rustprofit.com/tag/devblog"
    },
    {
      "slug": "rust-updates",
      "label": "Rust Updates",
      "posts": 230,
      "url": "https://blog.rustprofit.com/tag/rust-updates"
    },
    "…"
  ]
}

GET/guides/posts/{slug}copy URL

A published post as plain text for reading or quoting: `title`, `url`, `summary`, `author`, `tags`, `published`/`updated` (UTC), `headings` (its h2/h3 outline), `text` (the body without HTML, cut at 20,000 characters - `text_truncated` says so), `faq` (question/answer pairs the post carries) and `related` posts. Cite and link the `url`. From the blog's own per-post cache.

ParameterInTypeDefaultDescription
slug requiredpathstringThe post's slug (from `/guides` or the end of its blog URL). (min length 1, max length 200, pattern ^[a-z0-9-]+$)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/guides/posts/rust-recycler-locations"

Example response

{
  "title": "Rust Power Usage: How Much Power Each Device Needs",
  "slug": "rust-power-usage-chart",
  "url": "https://blog.rustprofit.com/rust-power-usage-chart",
  "summary": "How much power each Rust device needs: SAM Site 25, Auto Turret 10, Electric Furnace 3 and more, with generator outputs and battery runtimes.",
  "author": "RustProfit Team",
  "tags": [
    "Electricity",
    "Guide"
  ],
  "published": "2026-11-10T15:00:00",
  "updated": "2026-11-10T15:00:00",
  "headings": [
    "How Rust Measures Power",
    "Defence and Security Devices",
    "…"
  ],
  "text": "A\nSAM Site\nneeds 25 power, an\nAuto Turret\n10, a\nSearch Light\n10, and an Electric Furnace or CCTV Camera 3. Most sensors, alarms and small lights need just 1. This chart lists what each common device draws, what each generator and battery can supply, and how to size a setup so the turrets are still running at 4am.\nThe draw figures come from our electrical item data, and the SAM Site's own descripti…",
  "text_truncated": false,
  "faq": [
    {
      "q": "How much power does a SAM Site need in Rust?",
      "a": "25. The SAM Site's own description says it requires 25 electricity to function, which also means a Small Rechargeable Battery (15 max output) can't run one."
    },
    {
      "q": "How much power does an Auto Turret use?",
      "a": "10 rW, the same as a Search Light, a Boom Box or a Jukebox. A full Large Rechargeable Battery runs one for about 40 hours."
    },
    "…"
  ],
  "related": [
    {
      "title": "Rust Electricity Guide: Solar Panels, Wind Turbines, and Wiring",
      "url": "https://blog.rustprofit.com/rust-electricity-guide-solar-wind-and-wiring"
    },
    {
      "title": "Rust SAM Site and Auto Turret Guide: Power, Ammo, Setup",
      "url": "https://blog.rustprofit.com/rust-turrets-and-sam-sites"
    },
    "…"
  ]
}

GET/fishingcopy URL

Every fish and junk catch, where it bites, and bait values

From the game's server files (the data on rust.wiki/fishing): `fish` (`name`, `shortname`, `where` it bites - river, ocean, swamp, deep sea, moon pool - `min_bait`/`max_bait` bait points, `min_depth_m`/`max_depth_m`, relative `chance`, `fight` strength, `junk`, `mountable` on a trophy), `bait` (bait points each item is worth) and `rules` (how bait, depth and location combine). Vanilla values.

ParameterInTypeDefaultDescription
itemquerystringOnly one catch or bait, by shortname or name.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/fishing"

Example response

{
  "build": "26498655",
  "rules": [
    "Bait level = the bait's value x how many you put on, up to its stack limit (e.g. 3 grubs = 10.5). Items with no stack limit count once.",
    "A fish can only bite if the bait level is at least its minimum (and not above its maximum, for junk and small fish).",
    "…"
  ],
  "fish": [
    {
      "chance": 1.0,
      "fight": 1.25,
      "junk": false,
      "max_bait": null,
      "max_depth_m": null,
      "min_bait": 5.0,
      "min_depth_m": 4.5,
      "mountable": true,
      "name": "Salmon",
      "shortname": "fish.salmon",
      "where": [
        "Anywhere"
      ],
      "url": "https://rust.wiki/item/fish.salmon"
    }
  ],
  "bait": [],
  "page": "https://rust.wiki/fishing"
}

GET/workbench-upgradescopy URL

The ten workbench upgrades: effect, numbers and recipe

Every workbench upgrade (Accelerated, Comfort, Defensive, Efficiency, Prototype, Range, Recycle Bin, Reinforced, Salvage, Surplus): `name`, `shortname`, `effect` in words, the exact `values` from the server files, the `workbench` level it fits and `min_workbench`, and its `recipe`. The data on rust.wiki/workbench-upgrades.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/workbench-upgrades"

Example response

{
  "build": "26498655",
  "total": 10,
  "results": [
    {
      "effect": "Each further item in a batch crafts 25% faster, down to 25% of the normal time.",
      "min_workbench": 0,
      "name": "Accelerated Workbench Upgrade",
      "recipe": [
        {
          "amount": 5,
          "item": "gears",
          "name": "Gears",
          "url": "https://rust.wiki/item/gears"
        },
        {
          "amount": 100,
          "item": "scrap",
          "name": "Scrap",
          "url": "https://rust.wiki/item/scrap"
        }
      ],
      "shortname": "workbench.upgrade.accelerated",
      "values": {
        "maxSpeedMultiplier": 0.25,
        "minimumWorkbenchLevel": 0,
        "speedBonusPerItem": 0.25
      },
      "workbench": 1,
      "url": "https://rust.wiki/item/workbench.upgrade.accelerated"
    },
    {
      "effect": "Gives 100% comfort near the workbench.",
      "min_workbench": 0,
      "name": "Comfort Workbench Upgrade",
      "recipe": [
        {
          "amount": 100,
          "item": "wood",
          "name": "Wood",
          "url": "https://rust.wiki/item/wood"
        },
        {
          "amount": 100,
          "item": "scrap",
          "name": "Scrap",
          "url": "https://rust.wiki/item/scrap"
        },
        "…"
      ],
      "shortname": "workbench.upgrade.comfort",
      "values": {
        "comfortLevel": 1.0,
        "minimumWorkbenchLevel": 0
      },
      "workbench": 1,
      "url": "https://rust.wiki/item/workbench.upgrade.comfort"
    },
    "…"
  ],
  "page": "https://rust.wiki/workbench-upgrades"
}

GET/raid/splash-and-firecopy URL

Explosive splash radius, fire and siege damage vs every building grade

For every explosive, explosive ammo, fire source and siege weapon: `damage` by type, `radius_m` (full damage inside `min_radius_m`, falling off in a straight line to nothing at `radius_m` - see `falloff`), `fire`, and `per_target` - damage and hits to destroy each building grade and door (`twigs`, `wood`, `stone`, `metal`, `toptier`, `door.hinged.*`, garage door), from outside; `hits_inside` / `damage_inside` where a wall's soft (inside) side needs a different count. `fire_rules` says which grades burn (stone and up never do). From the server files; the data on rust.wiki/raid/splash-and-fire. For the cheapest way to raid a base use the raid calculator (`/calculators/raid/compute`).

ParameterInTypeDefaultDescription
itemquerystringOnly one explosive, ammo or weapon, by shortname or name.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/raid/splash-and-fire"

Example response

{
  "build": "26498655",
  "falloff": "Explosions: full damage within the minimum radius, then falling off in a straight line to nothing at the full radius, measured to the closest point of each piece, with line of sight. C4 and satchel charges are different: stuck to a wall or door they do full damage to it alone and never damage the building pieces next to it (deployables and players around them still take falloff damage). Explosive ammo and fire arrows fall off from the impact point the same way. The outside of walls, and both sides of doors, have extra protection against blunt, stab, slash, bullet and arrow damage (not explosion or fire), so where a count differs the first number is from outside and the second from the soft (inside) side.",
  "fire_rules": [
    "Fire only hurts twig and wood (and wooden doors): stone, metal and armored grades take no Heat damage.",
    "Fireballs burn whatever they rest against every half second; most land on the floor, so the fire figures are the most a single piece could take.",
    "…"
  ],
  "targets": [
    {
      "hp": 10.0,
      "key": "twigs",
      "name": "Twig"
    },
    {
      "hp": 250.0,
      "key": "wood",
      "name": "Wood"
    },
    "…"
  ],
  "uncertain": [
    "Counts are for a direct hit with no falloff and nothing in the way; real raids need more when splash is shared or blocked.",
    "Explosive ammo, beancans, F1s and other splash do less from outside a wall than from its soft side; doors take the reduced damage from both sides.",
    "…"
  ],
  "rows": [
    {
      "damage": {
        "Explosion": 550.0
      },
      "fire": null,
      "kind": "explosive",
      "min_radius_m": 0.0,
      "name": "Timed Explosive Charge",
      "note": null,
      "per_target": {
        "door.hinged.metal": {
          "damage": 440.0,
          "hits": 1
        },
        "door.hinged.toptier": {
          "damage": 440.0,
          "hits": 3
        },
        "door.hinged.wood": {
          "damage": 1100.0,
          "hits": 1
        },
        "metal": {
          "damage": 275.0,
          "hits": 4
        },
        "stone": {
          "damage": 275.0,
          "hits": 2
        },
        "toptier": {
          "damage": 275.0,
          "hits": 8
        },
        "twigs": {
          "damage": 550.0,
          "hits": 1
        },
        "wall.frame.garagedoor": {
          "damage": 440.0,
          "hits": 2
        },
        "wood": {
          "damage": 495.0,
          "hits": 1
        }
      },
      "radius_m": 4.0,
      "shortname": "explosive.timed",
      "url": "https://rust.wiki/item/explosive.timed"
    }
  ],
  "page": "https://rust.wiki/raid/splash-and-fire"
}

GET/stack-sizescopy URL

Stack size of every item

Every live item's vanilla `stack` size (how many fit in one inventory slot) with `name`, `shortname`, `category` and item `url`, alphabetical - the list on rust.wiki/stack-sizes. `no_limit` is true for liquids, which the game stores without a real limit. Servers can change stack sizes with plugins.

ParameterInTypeDefaultDescription
qquerystringSubstring of the item name or shortname.
categoryquerystringOne item category (`resource`, `component`, `ammo`, `medical`, `food`, `weapon`, `tool`, `construction`,...).
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/stack-sizes"

Example response

{
  "page": 1,
  "per_page": 50,
  "total": 2,
  "pages": 1,
  "results": [
    {
      "name": "Sulfur",
      "shortname": "sulfur",
      "category": "resource",
      "stack": 1000,
      "no_limit": false,
      "url": "https://rust.wiki/item/sulfur"
    },
    {
      "name": "Sulfur Ore",
      "shortname": "sulfur.ore",
      "category": "resource",
      "stack": 1000,
      "no_limit": false,
      "url": "https://rust.wiki/item/sulfur.ore"
    }
  ],
  "page_url": "https://rust.wiki/stack-sizes"
}

GET/despawn-timescopy URL

How long every dropped item lasts before it despawns

Every live item's vanilla `despawn_seconds` once dropped on the ground (longest first), with `name`, `shortname`, `category` and item `url` - the list on rust.wiki/despawn-times. Servers scale these with server.itemdespawn (see `/servers/config/convars/server.itemdespawn`).

ParameterInTypeDefaultDescription
qquerystringSubstring of the item name or shortname.
categoryquerystringOne item category.
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/despawn-times"

Example response

{
  "page": 1,
  "per_page": 3,
  "total": 1148,
  "pages": 383,
  "results": [
    {
      "name": "40mm HE Grenade",
      "shortname": "ammo.grenadelauncher.he",
      "category": "ammo",
      "despawn_seconds": 3600,
      "url": "https://rust.wiki/item/ammo.grenadelauncher.he"
    },
    {
      "name": "Abyss Assault Rifle",
      "shortname": "rifle.ak.diver",
      "category": "weapon",
      "despawn_seconds": 3600,
      "url": "https://rust.wiki/item/rifle.ak.diver"
    },
    "…"
  ],
  "page_url": "https://rust.wiki/despawn-times"
}

GET/coming-sooncopy URL

Upcoming Rust items: on the staging (test) branch, not in the live game yet

Items on Rust's public staging branch (Facepunch's test build) that the live game doesn't have yet, read from the test branch's server files and refreshed whenever it updates (2026-11-17). `items`: `shortname`, `name`, `description`, `category`, `recipe` (`ingredients` with `upcoming` true for ingredients that are new too, `workbench`, `craft_time_s`, `research_scrap`), `stats` (label/value pairs), `recycle`, `loot` (container, `chance_pct`), `icon_url`, `has_3d`, `first_seen` (when rust.wiki first saw it on staging). `changed`: live items whose recipe or stats differ on staging (`changes`: `label`, `old` = live, `new` = staging). `removed`: live items missing from staging. Test-branch content can change before release or never ship; items leave this list once they reach the live game. `other_changes` (2026-11-17): what else the test branch changes - `stats` (balance changes in plain words: `area`, `name`, `text`, `changes`), `settings` (server settings / console commands added, removed or with a new default, with the game's `help`), `hints` (guesses from the names of code added or removed - not announced features) and `text` (new or changed English game text).

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/coming-soon"

GET/game-data-changescopy URL

Which Rust builds changed the game data

The per-patch changelog rust.wiki's game-data pipeline writes after reading each new Rust server build: `build`, `prev_build`, `date` and `summary` counts (`added`, `changed`, `removed`), newest first. Fetch one with `/game-data-changes/{build}`. Empty until the pipeline has recorded a change.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/game-data-changes"

Example response

{
  "total": 1,
  "results": [
    {
      "build": "26498655",
      "prev_build": null,
      "date": "2026-11-16",
      "summary": {
        "added": 0,
        "changed": 40,
        "removed": 0
      },
      "url": "https://rust.wiki/game-data-changes/26498655"
    }
  ],
  "page": "https://rust.wiki/game-data-changes"
}

GET/game-data-changes/{build}copy URL

What one Rust build changed: items, recipes, loot, research, recycling

What a Rust patch changed in the game data the wiki reads from the server files. Per dataset: `status` (applied/unchanged/held), and the `added`, `changed` (`field`, `old`, `new`) and `removed` rows, each with a `key`, `label` and a rust.wiki `url` where one exists. Up to 500 rows per list (`truncated` says when more were recorded). Only items live on rust.wiki are listed - rows about anything not released yet are left out.

ParameterInTypeDefaultDescription
build requiredpathstringA build id from `/game-data-changes`, or `latest` for the newest. (pattern ^[A-Za-z0-9_-]{1,32}$)
datasetquerystringOnly one dataset (`items`, `recipes`, `research`, `recycle`, `loot`, `npc_health`, `commands`).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/game-data-changes/latest"

Example response

{
  "build": "26498655",
  "prev_build": null,
  "date": "2026-11-16T01:25:54Z",
  "label": "Rust server files, build 26498655",
  "datasets": [
    {
      "name": "loot",
      "status": "applied",
      "reason": null,
      "count": 40,
      "truncated": false,
      "added": [],
      "changed": [
        {
          "key": "Elite Crate|ammo.pistol",
          "label": "Elite Crate - Pistol Bullet",
          "field": "chance %/amount",
          "old": [
            [
              2.0312,
              30,
              "…"
            ],
            [
              14.66,
              15,
              "…"
            ]
          ],
          "new": [
            14.66,
            15,
            "…"
          ],
          "url": "https://rust.wiki/item/ammo.pistol"
        },
        {
          "key": "Elite Crate|ammo.rifle",
          "label": "Elite Crate - 5.56 Rifle Ammo",
          "field": "chance %/amount",
          "old": [
            [
              1.2188,
              20,
              "…"
            ],
            [
              1.2188,
              50,
              "…"
            ],
            "…"
          ],
          "new": [
            7.31,
            8,
            "…"
          ],
          "url": "https://rust.wiki/item/ammo.rifle"
        },
        "…"
      ],
      "removed": []
    }
  ],
  "page": "https://rust.wiki/game-data-changes/26498655"
}

GET/explosivescopy URL

Every explosive: damage, blast radius, fuse, dud chance, fire and sulfur

Every raid explosive, fire source and siege round from the server files: `damage` by type (vs buildings and deployables) and `player_damage` when players take something different; `radius_m` with full damage inside `min_radius_m`, falling off linearly to nothing at `radius_m` (`splash`: `parent` = C4/satchel, full damage only to what it is stuck to plus falloff to deployables/players around it; `radius` = everything in range; `impact` = bullets, with `radial` splash); `fuse_s` [min, max]; `dud` (`chance`) and `lit_per_success` (expected lights per explosion); `fire` (burst Heat, fireballs, each fireball's Heat/s, life, radius and `spread` with `expected_total` fireballs); `handling` (draw / between-throw seconds, throw speed); `launcher`; `sulfur` per unit; `walls` = how many break one wood/stone/sheet metal/armored wall from `outside` (hard side) and `inside`. `rules` quotes the game code each mechanic comes from. Page: rust.wiki/explosives.

ParameterInTypeDefaultDescription
qquerystringSubstring of the name or shortname.
groupquerystringOne group: `placed` (C4 & satchels), `thrown` (Grenades), `rocket` (Rockets & launchers), `fire` (Fire), `ammo` (Explosive & incendiary ammo), `siege` (Siege & heavy weapons), `other` (Other).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/explosives"

Example response

{
  "build": "26498655",
  "total": 5,
  "results": [
    {
      "shortname": "grenade.molotov",
      "name": "Molotov Cocktail",
      "group": "fire",
      "damage": {
        "Heat": 35.0
      },
      "radius_m": 3.0,
      "min_radius_m": 1.0,
      "splash": "radius",
      "splash_text": "Damages everything in its radius with line of sight, falling off with distance to each target's nearest point.",
      "fuse_s": [
        8.0,
        10.0
      ],
      "on_contact": true,
      "sticks": false,
      "handling": {
        "between_s": 0.5,
        "draw_s": 0.5,
        "throw_speed_ms": 13.0
      },
      "fire": {
        "burst_heat": 35.0,
        "fireball": {
          "can_merge": false,
          "dps": 8.0,
          "heat_each": 140.0,
          "key": "fireball_small_molotov",
          "life_s": [
            15.0,
            20.0
          ],
          "radius_m": 1.0,
          "tick_s": 0.5,
          "water_to_extinguish": 10
        },
        "fireballs": 5,
        "spread_deg": 120.0,
        "throw_speed_ms": [
          5.0,
          8.0
        ]
      },
      "fire_total": 735,
      "craftable": true,
      "workbench": 2,
      "walls": [
        {
          "grade": "wood",
          "name": "Wood",
          "outside": 4,
          "inside": 4
        },
        {
          "grade": "stone",
          "name": "Stone",
          "outside": null,
          "inside": null
        },
        "…"
      ],
      "url": "https://rust.wiki/item/grenade.molotov",
      "page": "https://rust.wiki/explosives#grenade-molotov"
    },
    {
      "shortname": "ammo.rocket.fire",
      "name": "Incendiary Rocket",
      "group": "fire",
      "damage": {
        "Heat": 50.0
      },
      "radius_m": 5.0,
      "min_radius_m": 5.0,
      "splash": "radius",
      "splash_text": "Damages everything in its radius with line of sight, falling off with distance to each target's nearest point.",
      "fuse_s": [
        8.0,
        10.0
      ],
      "on_contact": false,
      "sticks": false,
      "launcher": {
        "between_s": 2.0,
        "draw_s": 3.0,
        "name": "Rocket Launcher",
        "reload_s": 6.162,
        "shortname": "rocket.launcher"
      },
      "flight": {
        "gravity": 0.25,
        "speed_ms": 18.0
      },
      "fire": {
        "burst_heat": 50.0,
        "fireball": {
          "can_merge": false,
          "dps": 5.0,
          "heat_each": 175.0,
          "key": "fireball",
          "life_s": [
            30.0,
            40.0
          ],
          "radius_m": 1.0,
          "spread": {
            "chance_first": 0.9,
            "chance_step": -0.1,
            "expected_total": 3.66,
            "expected_total_if_no_decay": 10.0,
            "to": "fireball"
          },
          "tick_s": 0.5,
          "water_to_extinguish": 15
        },
        "fireballs": 10,
        "spread_deg": 90.0,
        "throw_speed_ms": [
          2.0,
          6.0
        ]
      },
      "fire_total": 1800,
      "fire_total_with_spread": 6455,
      "sulfur": 300.0,
      "craftable": true,
      "workbench": 2,
      "walls": [
        {
          "grade": "wood",
          "name": "Wood",
          "outside": 2,
          "inside": 2
        },
        {
          "grade": "stone",
          "name": "Stone",
          "outside": null,
          "inside": null
        },
        "…"
      ],
      "url": "https://rust.wiki/item/ammo.rocket.fire",
      "page": "https://rust.wiki/explosives#ammo-rocket-fire"
    },
    "…"
  ],
  "rules": {
    "dud": "DudTimedExplosive.Explode: each detonation rolls dudChance; a dud can be relit (rolls again) or picked up (still stuck: 50% it relights on a 2.5-3 s fuse)",
    "falloff": "DamageUtil.RadiusDamage: damage x (1 - clamp01((d - min_radius) / (radius - min_radius))), d = distance to the target's closest point; needs line of sight",
    "fire_spread": "FireBall.TryToSpread: once, at 30-50% of its life, chance 0.9 - 0.1 x generation",
    "fireball_damage": "FireBall.DoRadialDamage: every tickRate s while resting, damagePerSecond x tickRate Heat to everything in radius with line of sight; siege/mounted weapons take 20%",
    "fuse_dud": "DudTimedExplosive.GetRandomTimerTime: fuse x 0.334 with 15% chance, else x 3 with 15% (of the rest), else x 1",
    "melee_condition": "BaseMelee.UpdateItemCondition: each hit costs 1 + 0.2 x the damage the target's protection absorbed",
    "melee_override": "BaseMelee.GetAttackStats: deployableDamageOverrides replace the damage vs deployables that are not doors, building blocks, high walls/frames or loot containers",
    "parent": "TimedExplosive.Explode with onlyDamageParent: full damage to what it is stuck to (no falloff), falloff damage to the single nearest visible building block (only when it is NOT stuck to a building block), and radius damage to deployables/players/NPCs around it (never to other building blocks)",
    "protection": "ProtectionProperties.Scale: each type x (1 - clamp(protection, -1, 1)); a negative value amplifies (-1 = double)",
    "shell": "BaseCombatEntity.Hurt: DirectionProperties.extraProtection when the hit has a start point and the target has no weak spot - always, for doors, hatches, high walls and the TC"
  },
  "page": "https://rust.wiki/explosives"
}

GET/explosives/{shortname}copy URL

One explosive: damage, radius, fuse, duds, fire, walls it breaks

One explosive with every field `/explosives` gives (see there), including `walls`: the number that breaks one wood, stone, sheet metal and armored wall from outside and inside. For a deployable target (turret, box, TC, door...) use `/raid/deployables/{shortname}`.

ParameterInTypeDefaultDescription
shortname requiredpathstringShortname, name or common name (`c4`, `satchel`, `rocket`, `hv`, `beancan`, `f1`, `molotov`, `explo`, `mlrs`...). (min length 2, max length 60)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/explosives/explosive.satchel"

Example response

{
  "build": "26498655",
  "shortname": "explosive.satchel",
  "name": "Satchel Charge",
  "group": "placed",
  "damage": {
    "Blunt": 200.0,
    "Explosion": 75.0,
    "Stab": 200.0
  },
  "player_damage": {
    "Explosion": 400.0
  },
  "radius_m": 4.0,
  "min_radius_m": 0.0,
  "splash": "parent",
  "splash_text": "Sticks. Full damage to what it's stuck to, plus falloff damage to deployables and players around it. It never damages other building pieces.",
  "fuse_s": [
    6.0,
    12.0
  ],
  "fuse_expected_s": 10.4,
  "on_contact": false,
  "sticks": true,
  "dud": {
    "chance": 0.2,
    "dud_in_water": false
  },
  "lit_per_success": 1.25,
  "handling": {
    "between_s": 1.5,
    "draw_s": 0.75,
    "throw_speed_ms": 10.0
  },
  "sulfur": 480.0,
  "craftable": true,
  "workbench": 1,
  "walls": [
    {
      "grade": "wood",
      "name": "Wood",
      "outside": 3,
      "inside": 3
    },
    {
      "grade": "stone",
      "name": "Stone",
      "outside": 10,
      "inside": 10
    },
    "…"
  ],
  "url": "https://rust.wiki/item/explosive.satchel",
  "page": "https://rust.wiki/explosives#explosive-satchel",
  "rules": {
    "dud": "DudTimedExplosive.Explode: each detonation rolls dudChance; a dud can be relit (rolls again) or picked up (still stuck: 50% it relights on a 2.5-3 s fuse)",
    "falloff": "DamageUtil.RadiusDamage: damage x (1 - clamp01((d - min_radius) / (radius - min_radius))), d = distance to the target's closest point; needs line of sight",
    "fire_spread": "FireBall.TryToSpread: once, at 30-50% of its life, chance 0.9 - 0.1 x generation",
    "fireball_damage": "FireBall.DoRadialDamage: every tickRate s while resting, damagePerSecond x tickRate Heat to everything in radius with line of sight; siege/mounted weapons take 20%",
    "fuse_dud": "DudTimedExplosive.GetRandomTimerTime: fuse x 0.334 with 15% chance, else x 3 with 15% (of the rest), else x 1",
    "melee_condition": "BaseMelee.UpdateItemCondition: each hit costs 1 + 0.2 x the damage the target's protection absorbed",
    "melee_override": "BaseMelee.GetAttackStats: deployableDamageOverrides replace the damage vs deployables that are not doors, building blocks, high walls/frames or loot containers",
    "parent": "TimedExplosive.Explode with onlyDamageParent: full damage to what it is stuck to (no falloff), falloff damage to the single nearest visible building block (only when it is NOT stuck to a building block), and radius damage to deployables/players/NPCs around it (never to other building blocks)",
    "protection": "ProtectionProperties.Scale: each type x (1 - clamp(protection, -1, 1)); a negative value amplifies (-1 = double)",
    "shell": "BaseCombatEntity.Hurt: DirectionProperties.extraProtection when the hit has a start point and the target has no weak spot - always, for doors, hatches, high walls and the TC"
  }
}

GET/raid/deployablescopy URL

Health and raid cost of every deployable (turrets, boxes, TC, doors...)

Every damageable deployable from the server files (skins folded into their base item, listed in `variants`): `hp`, `group`, `shell` (true = extra protection against blunt/stab/slash/bullet hits from outside: doors, hatches, high walls, the TC) and `costs` for the raid staples - `c4`, `rocket`, `satchel`, `explo` (explosive 5.56) and `beancan` - each with `count` (direct hits / stuck charges), `damage_per_use` and `sulfur`; satchels and beancans add `expected_lit` for their dud chance. `cheapest` is the staple that costs the least sulfur. For melee, fire, bullets and the rest use `/raid/deployables/{shortname}`. Page: rust.wiki/raid/deployables.

ParameterInTypeDefaultDescription
qquerystringSubstring of the name or shortname.
groupquerystringOne group: `door` (Doors & hatches), `wall` (Walls, gates & windows), `tc` (Tool cupboards), `defence` (Turrets & traps), `storage` (Storage), `crafting` (Crafting, ovens & farming), `electric` (Electrical), `barricade` (Barricades), `siege` (Siege weapons), `other` (Furniture & everything else).
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/raid/deployables"

Example response

{
  "build": "26498655",
  "page": 1,
  "per_page": 50,
  "total": 2,
  "pages": 1,
  "results": [
    {
      "shortname": "autoturret",
      "name": "Auto Turret",
      "group": "defence",
      "group_label": "Turrets & traps",
      "hp": 1000.0,
      "shell": false,
      "variants": [
        {
          "name": "Industrial Auto Turret",
          "shortname": "industrial.autoturret"
        }
      ],
      "costs": {
        "c4": {
          "damage_per_use": 550.0,
          "count": 2,
          "sulfur": 4400
        },
        "rocket": {
          "damage_per_use": 312.5,
          "count": 4,
          "sulfur": 5600
        },
        "satchel": {
          "damage_per_use": 275.0,
          "count": 4,
          "expected_lit": 5.0,
          "sulfur": 1920
        },
        "explo": {
          "damage_per_use": 10.0,
          "count": 100,
          "sulfur": 2500
        },
        "beancan": {
          "damage_per_use": 65.0,
          "count": 16,
          "expected_lit": 18.82,
          "sulfur": 1920
        }
      },
      "cheapest": {
        "method": "satchel",
        "label": "Satchel",
        "count": 4,
        "sulfur": 1920
      },
      "url": "https://rust.wiki/item/autoturret",
      "page": "https://rust.wiki/raid/deployables/autoturret"
    },
    {
      "shortname": "flameturret",
      "name": "Flame Turret",
      "group": "defence",
      "group_label": "Turrets & traps",
      "hp": 300.0,
      "shell": false,
      "costs": {
        "c4": {
          "damage_per_use": 550.0,
          "count": 1,
          "sulfur": 2200
        },
        "rocket": {
          "damage_per_use": 282.5,
          "count": 2,
          "sulfur": 2800
        },
        "satchel": {
          "damage_per_use": 195.0,
          "count": 2,
          "expected_lit": 2.5,
          "sulfur": 960
        },
        "explo": {
          "damage_per_use": 10.0,
          "count": 30,
          "sulfur": 750
        },
        "beancan": {
          "damage_per_use": 45.0,
          "count": 7,
          "expected_lit": 8.24,
          "sulfur": 840
        }
      },
      "cheapest": {
        "method": "explo",
        "label": "Explosive ammo",
        "count": 30,
        "sulfur": 750
      },
      "url": "https://rust.wiki/item/flameturret",
      "page": "https://rust.wiki/raid/deployables/flameturret"
    }
  ],
  "page_url": "https://rust.wiki/raid/deployables"
}

GET/raid/deployables/{shortname}copy URL

One deployable: health, protection and every way to raid it

One deployable: `hp`, `protection` per damage type (fractions; negative = takes extra), `shell`, and `methods` - every raid method with `count`, `damage_per_use`, `sulfur`: C4, rockets, satchels (`expected_lit`, `sulfur_if_duds_lost`), explosive ammo, beancans, HV rockets, F1s, MLRS, 40mm HE, propane bombs, mortar shells, fire (molotovs, incendiary rockets, incendiary ammo - `upper_bound`: every fireball against it), 5.56 ammo and melee (`seconds` of hitting, `tools` worn out). Counts are direct hits or stuck charges.

ParameterInTypeDefaultDescription
shortname requiredpathstringItem shortname, skin shortname or display name. (min length 2, max length 80)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/raid/deployables/autoturret"

Example response

{
  "build": "26498655",
  "shortname": "autoturret",
  "name": "Auto Turret",
  "group": "defence",
  "group_label": "Turrets & traps",
  "hp": 1000.0,
  "shell": false,
  "variants": [
    {
      "name": "Industrial Auto Turret",
      "shortname": "industrial.autoturret"
    }
  ],
  "costs": {
    "c4": {
      "damage_per_use": 550.0,
      "count": 2,
      "sulfur": 4400
    },
    "rocket": {
      "damage_per_use": 312.5,
      "count": 4,
      "sulfur": 5600
    },
    "satchel": {
      "damage_per_use": 275.0,
      "count": 4,
      "expected_lit": 5.0,
      "sulfur": 1920
    },
    "explo": {
      "damage_per_use": 10.0,
      "count": 100,
      "sulfur": 2500
    },
    "beancan": {
      "damage_per_use": 65.0,
      "count": 16,
      "expected_lit": 18.82,
      "sulfur": 1920
    },
    "hv": {
      "damage_per_use": 345.0,
      "count": 3,
      "sulfur": 600
    },
    "f1": {
      "damage_per_use": 107.5,
      "count": 10,
      "sulfur": 600
    },
    "mlrs": {
      "damage_per_use": 462.5,
      "count": 3
    },
    "he40": {
      "damage_per_use": 62.5,
      "count": 16
    },
    "propane": {
      "damage_per_use": 312.5,
      "count": 4,
      "sulfur": 3600
    },
    "mortar": {
      "damage_per_use": 197.5,
      "count": 6,
      "sulfur": 1800
    },
    "molotov": {
      "damage_per_use": 147.0,
      "count": 7
    },
    "incrocket": {
      "damage_per_use": 360.0,
      "count": 3,
      "sulfur": 900
    },
    "incammo": {
      "damage_per_use": 9.95,
      "count": 101,
      "sulfur": 1262
    },
    "bullets": {
      "damage_per_use": 5.0,
      "count": 200,
      "sulfur": 666
    },
    "melee:hammer.salvaged": {
      "damage_per_use": 30.0,
      "count": 34
    },
    "melee:axe.salvaged": {
      "damage_per_use": 20.0,
      "count": 50
    },
    "melee:jackhammer": {
      "damage_per_use": 7.5,
      "count": 134
    }
  },
  "cheapest": {
    "method": "hv",
    "label": "HV rocket",
    "count": 3,
    "sulfur": 600
  },
  "protection": {
    "Blunt": 0.5,
    "Stab": 0.5,
    "Slash": 0.5,
    "Bullet": 0.9,
    "Heat": 0.8,
    "Arrow": 0.9,
    "Generic": 1.0
  },
  "methods": [
    {
      "method": "c4",
      "label": "C4",
      "kind": "explosive",
      "shortname": "explosive.timed",
      "unit": "charges",
      "damage_per_use": 550.0,
      "count": 2,
      "sulfur": 4400
    },
    {
      "method": "rocket",
      "label": "Rocket",
      "kind": "explosive",
      "shortname": "ammo.rocket.basic",
      "unit": "rockets",
      "damage_per_use": 312.5,
      "count": 4,
      "sulfur": 5600
    },
    "…"
  ],
  "notes": [],
  "salvaged_hammer_bonus": {
    "normal": 40.0,
    "vs_deployables": 60.0
  },
  "url": "https://rust.wiki/item/autoturret",
  "page": "https://rust.wiki/raid/deployables/autoturret",
  "how": "damage per use = each damage type x (1 - protection), x (1 - outside protection) when \`shell\`; count = ceil(hp / damage per use)."
}

GET/learncopy URL

Start here: which endpoint/tool answers which Rust question

The map for AI assistants and new API users: `tasks` (kinds of question -> the MCP tools that answer them, each tool named after the endpoint it calls), `concepts` (the concept guides at `/learn/{topic}` - how Rust works, from the core loop to server settings), `tool_groups` (every MCP tool by area), plus `glossary_terms` and the conventions (cents, UTC, vanilla defaults). Read this once, then call the specific tool.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/learn"

Example response

{
  "about": "rust.wiki answers questions about Rust (Facepunch's survival game): game data read from the server files, live skin prices and markets, inventories, the Rust server directory (servers.rustprofit.com), calculators and guides.",
  "conventions": [
    "Money is integer USD cents unless a field says otherwise.",
    "Timestamps are UTC ISO-8601.",
    "…"
  ],
  "game_build": "26498655",
  "tasks": [
    {
      "task": "Not sure where to look: one search across everything",
      "tools": [
        "search"
      ]
    },
    {
      "task": "Learn how a part of the game works / decode slang",
      "tools": [
        "explain_rust",
        "rust_glossary"
      ]
    },
    "…"
  ],
  "concepts": [
    {
      "topic": "core-loop",
      "title": "The core loop and progression",
      "summary": "Gather, craft, build, research, raid - and start again every wipe.",
      "url": "https://rust.wiki/api/v1/learn/core-loop"
    },
    {
      "topic": "building-and-upkeep",
      "title": "Building, upkeep and decay",
      "summary": "Building grades, the tool cupboard, upkeep brackets, decay and base design.",
      "url": "https://rust.wiki/api/v1/learn/building-and-upkeep"
    },
    "…"
  ],
  "tool_groups": {
    "Start here": [
      "rust_overview",
      "search",
      "…"
    ],
    "Items": [
      "get_item_full",
      "search_items",
      "…"
    ],
    "Game reference": [
      "get_monument_full",
      "list_monuments",
      "…"
    ],
    "Skins": [
      "search_skins",
      "browse_skins",
      "…"
    ],
    "Market": [
      "find_skin_deals",
      "get_market_cap",
      "…"
    ],
    "Item store": [
      "get_item_store",
      "get_item_store_history",
      "…"
    ],
    "Calculators": [
      "get_raid_costs",
      "get_upkeep_rules",
      "…"
    ],
    "Updates": [
      "get_rust_updates",
      "get_update",
      "…"
    ],
    "Servers": [
      "search_servers",
      "get_top_servers",
      "…"
    ],
    "Status": [
      "get_data_freshness"
    ],
    "Guides": [
      "search_guides",
      "list_blog_posts",
      "…"
    ],
    "Players": [
      "resolve_steam_profile",
      "get_player_stats",
      "…"
    ],
    "Inventory": [
      "get_inventory_leaderboard",
      "get_inventory",
      "…"
    ],
    "Skin Lab": [
      "skinlab_list_items",
      "skinlab_get_item",
      "…"
    ]
  },
  "glossary_terms": 68,
  "mcp": "https://rust.wiki/mcp",
  "docs": "https://rust.wiki/docs"
}

GET/learn/glossarycopy URL

`results`: `{term, definition, tools, pages}` - what a Rust term means and which tools/pages cover it. An exact term or known alias returns one entry; otherwise every term whose name or definition contains the text.

ParameterInTypeDefaultDescription
termquerystringA term or slang word (BP, TC, soft side, honeycomb, offline raid, 2x...). Omit for the whole glossary.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/learn/glossary"

Example response

{
  "term": "soft side",
  "total": 1,
  "results": [
    {
      "term": "Soft side",
      "definition": "The weak face of a wall or foundation (with the supports showing); takes much more melee damage than the hard side.",
      "tools": [
        "get_building_piece"
      ],
      "pages": [
        "https://rust.wiki/building"
      ]
    }
  ]
}

GET/learn/whats-newcopy URL

What's new in Rust: latest update, game-data changes, item store, wipes

One call for "what changed lately": `updates` (Facepunch's five newest posts with the network's write-up when there is one), `game_data` (the newest build the wiki read from the server files and how many items, recipes, loot rows... it changed - details at `/game-data-changes/{build}`), `item_store` (this week's limited-time items and when the store rotates) and `force_wipe` (the last and next monthly force wipe). Cached for five minutes.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/learn/whats-new"

Example response

{
  "updates": [
    {
      "title": "Printed and Polished",
      "slug": "printed_and_polished",
      "summary": "This month's update brings you a Blueprint Rework, the new Uzi 9mm, and our biggest optimisation focused updates yet! As well as many more bug fixes, refreshes, reworks, and lots of quality of life improvements.",
      "category": "devblog",
      "published_date": "2026-11-05",
      "url": "https://rust.facepunch.com/news/printed_and_polished",
      "has_blog_post": false
    },
    {
      "title": "Halloween 2026",
      "slug": "halloween-2026",
      "summary": "Darkness falls upon the island as monsters re-awaken from their slumber. The rifts open in random locations, leading to who-knows-where. Enter if you dare, but if you do, you'd better prepare!",
      "category": "devblog",
      "published_date": "2026-10-22",
      "url": "https://rust.facepunch.com/news/halloween-2026",
      "has_blog_post": false
    },
    "…"
  ],
  "game_data": {
    "build": "26498655",
    "date": "2026-11-16",
    "summary": {
      "added": 0,
      "changed": 40,
      "removed": 0
    },
    "url": "https://rust.wiki/game-data-changes/26498655"
  },
  "item_store": {
    "limited_time": [
      {
        "name": "Fused Glass Rock",
        "itemdefid": 71413,
        "store_price": 299
      },
      {
        "name": "Popstar Nailgun",
        "itemdefid": 71405,
        "store_price": 249
      },
      "…"
    ],
    "next_rotation_at": "2026-11-12T18:03:50.428327",
    "url": "https://rust.wiki/store"
  },
  "force_wipe": {
    "last": "2026-11-05T19:00:00",
    "next": "2026-12-03T19:00:00"
  },
  "generated_at": "2026-11-16T04:59:19.477594"
}

GET/learn/{topic}copy URL

Concept guide: how a part of Rust works

A short guide to one part of the game (core loop and progression, building and upkeep, raiding, electricity, farming and genetics, fishing, monuments and puzzles, events, vehicles, NPCs, the economy, wipes, game modes and eras, server settings, skins and the item store): `sections` of `{heading, text, fact, tools}` - `fact` is a number-bearing statement read from the current game files or server ConVars (`game_build` cites the build), `tools` the MCP tools/endpoints that give exact values - plus `related_topics`. Fixed text, live numbers.

ParameterInTypeDefaultDescription
topic requiredpathone of `core-loop`, `building-and-upkeep`, `raiding`, `electricity`, `farming-and-genetics`, `fishing`, `monuments-and-puzzles`, `events`, `vehicles`, `npcs`, `economy`, `wipes`, `game-modes`, `server-settings`, `skins-and-store`Which guide: core-loop, building-and-upkeep, raiding, electricity, farming-and-genetics, fishing, monuments-and-puzzles, events, vehicles, npcs, economy, wipes, game-modes, server-settings, skins-and-store.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/learn/raiding"

Example response

{
  "topic": "raiding",
  "title": "Raiding: explosives, sulfur and soft sides",
  "summary": "How bases are broken into and what it costs.",
  "sections": [
    {
      "heading": "Sulfur is the currency of raiding",
      "text": "C4, rockets, satchels, beancan grenades and explosive 5.56 ammo are all crafted with gunpowder (sulfur + charcoal), so raid costs are quoted in sulfur.",
      "fact": null,
      "tools": [
        "calculate_sulfur",
        "calculate_craft_cost"
      ]
    },
    {
      "heading": "What it takes",
      "text": "Each explosive does a fixed amount of damage to each building grade and door type; the cheapest mix depends on the target.",
      "fact": "A stone wall (500 HP) takes 2 C4, or 4 rockets, or 10 satchels to destroy from the hard side (game files, build 26498655). Fire never damages stone or better.",
      "tools": [
        "calculate_raid_cost",
        "get_raid_costs",
        "…"
      ]
    },
    "…"
  ],
  "related_topics": [
    "building-and-upkeep",
    "economy"
  ],
  "game_build": "26498655",
  "note": "Numbers are vanilla defaults from the current Rust server files; servers can change them. Call the listed tools for exact, current values."
}

GET/searchcopy URL

Search everything: items, skins, monuments, NPCs, vehicles, commands, settings, guides, servers

One search box over the whole network. Each result: `type` (page, item, skin, monument, creature, vehicle, command, convar, concept, glossary, blog, server), `title`, `summary`, `key`, `url`, and `next` - the tool (and its arguments) to call for the full record. Grouped by type, best match first within each; the same item/skin/ monument matching as the site's search box. Cached for five minutes per query.

ParameterInTypeDefaultDescription
q requiredquerystringWhat to look for: a name, a term, a question keyword (`ak`, `oil rig`, `bear`, `minicopter`, `decay`, `honeycomb`). (min length 2, max length 80)
typesqueryone of `page`, `item`, `skin`, `monument`, `creature`, `vehicle`, `command`, `convar`, `concept`, `glossary`, `blog`, `server`[]Only these result types (repeatable). Default: all.
limitqueryinteger30Most results to return. (max 60, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/search?q=oil%20rig"

Example response

{
  "q": "oil rig",
  "total": 8,
  "results": [
    {
      "type": "glossary",
      "title": "Oil rig",
      "summary": "Offshore monument (small and large) guarded by heavy scientists, with a locked crate.",
      "key": "Oil rig",
      "url": "https://rust.wiki/monuments",
      "next": {
        "tool": "rust_glossary",
        "arguments": {
          "term": "Oil rig"
        }
      }
    },
    {
      "type": "monument",
      "title": "Oil Rig",
      "summary": "Monument - tier 2/3",
      "key": "oil-rig",
      "url": "https://rust.wiki/monument/oil-rig",
      "next": {
        "tool": "get_monument_full",
        "arguments": {
          "slug": "oil-rig"
        }
      }
    },
    "…"
  ]
}

GET/monuments/{slug}/fullcopy URL

Everything at one monument in one call

The monument (`tier`, safe zone, radiation, recyclers, tunnel entrance...) with `loot_sources` (crates and NPC loot tables), `placements` (recyclers with efficiency, NPC shops, CCTV camera ids, crates and their spawn points), `vending` (each shop's offers - what it sells and for what), `cctv_codes` (the Computer Station codes), `puzzle` (keycard/fuse doors in order, resets, radiation and puzzle loot - null when it has none), `missions` (NPC missions given here with rewards) and `design_notes`. Follow up with `/loot-tables/{id}` for odds.

ParameterInTypeDefaultDescription
slug requiredpathstringMonument slug from `/monuments` (or `/search`). (min length 1, max length 80)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/monuments/launch-site/full"

Example response

{
  "slug": "launch-site",
  "name": "Launch Site",
  "tier": "3",
  "is_safezone": false,
  "has_tunnel_entrance": true,
  "has_chinook_drop_zone": false,
  "allows_patrol_heli_crash": true,
  "no_build_area_sqm": 92205,
  "recyclers": "1",
  "has_radiation": true,
  "radiation_level": "52",
  "loot_sources": [],
  "placements": [
    {
      "layout": "launch_site_1",
      "name": "Launch Site",
      "safe_zone": false,
      "recyclers": [
        {
          "type": "recycler",
          "label": "Monument recycler",
          "count": 1,
          "efficiency_pct": 50,
          "seconds": 5.0
        }
      ],
      "vending": [],
      "cctv": [],
      "crates": [
        {
          "name": "Normal Crate",
          "source_id": 120,
          "kind": "crate",
          "expected": 59.2,
          "fixed": 0,
          "spawn_points": 91
        },
        {
          "name": "Blue Loot Barrel",
          "source_id": 159,
          "kind": "barrel",
          "expected": 26.35,
          "fixed": 0,
          "spawn_points": 104
        },
        "…"
      ]
    }
  ],
  "vending": [],
  "cctv_codes": null,
  "puzzle": {
    "slug": "launch-site",
    "name": "Launch Site",
    "build": "26498655",
    "cards": [
      "green",
      "red"
    ],
    "fuse_boxes": 2,
    "doors": [
      {
        "door": "green security door",
        "area": "",
        "card": "green",
        "cards": [
          "green"
        ],
        "needs_fuse": false,
        "switches": 0,
        "timer_s": null,
        "ways": [
          {
            "steps": [
              {
                "where": "",
                "t": "card",
                "level": 1,
                "colour": "green",
                "text": "Swipe a Green Keycard"
              }
            ],
            "text": "swipe a Green Keycard",
            "stays_open": "open until the puzzle resets"
          }
        ],
        "exit_button": true,
        "stays_open": "open until the puzzle resets",
        "resets": [
          9
        ],
        "count": 1,
        "reset_nos": [
          10
        ]
      },
      {
        "door": "red security door",
        "area": "",
        "card": "red",
        "cards": [
          "red"
        ],
        "needs_fuse": true,
        "switches": 2,
        "timer_s": null,
        "ways": [
          {
            "steps": [
              {
                "where": "",
                "t": "fuse",
                "seconds": 200,
                "text": "Insert an Electric Fuse in the fuse box - it lasts 3 min 20 s"
              },
              {
                "where": "",
                "t": "switch",
                "text": "Flip the switch"
              },
              "…"
            ],
            "text": "insert an Electric Fuse in the fuse box; flip the switch; insert an Electric Fuse in the fuse box; flip the switch; swipe a Red Keycard",
            "stays_open": "open while the fuse lasts (3 min 20 s)"
          }
        ],
        "exit_button": true,
        "stays_open": "open while the fuse lasts (3 min 20 s)",
        "resets": [
          7,
          8,
          "…"
        ],
        "count": 4,
        "reset_nos": [
          8,
          9,
          "…"
        ]
      },
      "…"
    ],
    "resets": [
      {
        "area": "power-grid loot room",
        "ai_zone": false,
        "seconds": 1800.0,
        "players_block": false,
        "radius": 5.0,
        "scale_with_pop": false,
        "pause_until_looted": false,
        "radiation_push": false,
        "broadcast": false,
        "loot": [],
        "n": 1,
        "time": "30 min"
      },
      {
        "area": "power-grid loot room",
        "ai_zone": false,
        "seconds": 1800.0,
        "players_block": false,
        "radius": 5.0,
        "scale_with_pop": false,
        "pause_until_looted": false,
        "radiation_push": false,
        "broadcast": false,
        "loot": [],
        "n": 2,
        "time": "30 min"
      },
      "…"
    ],
    "radiation": {
      "max_rads": 51.0,
      "tiers": [
        {
          "tier": "Low",
          "rads": 10.0,
          "zones": 2
        },
        {
          "tier": "Medium",
          "rads": 25.0,
          "zones": 1
        },
        "…"
      ],
      "custom": []
    },
    "rad_text": "51 rad",
    "rad_protection": 51.0,
    "amenities": {
      "research_table": 1,
      "repair_bench": 1,
      "recycler": 1
    },
    "puzzle_loot": [
      {
        "name": "Blueprint Book (pickup)",
        "loot_table": null,
        "item": "blueprintbook",
        "max": 1.0,
        "source_id": null,
        "url": "/item/blueprintbook"
      },
      {
        "name": "Elite Crate",
        "loot_table": "Elite Crate",
        "item": null,
        "max": 3.0,
        "source_id": 116,
        "url": "/loot-table/116"
      },
      "…"
    ],
    "has_puzzle": true,
    "missions": []
  },
  "missions": [],
  "design_notes": [],
  "page": "https://rust.wiki/monument/launch-site"
}

Player stats

category players · 2,000 requests/day

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.

GET/players/resolvecopy URL

Resolve a profile URL or vanity name to a SteamID64

Turns any of the accepted identifier forms into a 17-digit SteamID64. Does not fetch the profile.

ParameterInTypeDefaultDescription
q requiredquerystringA steamcommunity.com profile URL, a custom URL name, or a SteamID64. (min length 1, max length 200)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/players/resolve?q=https://steamcommunity.com/id/willjum"

Example response

{
  "query": "https://steamcommunity.com/id/willjum",
  "steamid": "76561199126382502"
}

GET/players/leaderboardcopy URL

Rust player leaderboard: most kills, best K/D, hours and more

The leaderboard on https://rust.wiki/players: Rust players ranked by their official Steam stats. Boards: `kills`, `kd` (min 1,000 kills), `headshots` (headshots on anything), `hours` (public playtime only), `accuracy` (bullets that hit a player / fired, min 20,000 fired), `scientists`, `animals`, `gathered` (wood + stone + metal ore + sulfur ore), `building` (blocks placed), `rockets`, `fish`, `deaths`. Each result has `rank`, `steamid`, `name`, `avatar`, `country`, `value` / `value_text`, `kills`, `deaths`, `kd`, `hours` and `updated` (the date its stats were last read from Steam). Players are added when looked up on Player Stats or when their inventory is checked on rust.wiki, refreshed about weekly; only public game details are ranked and accounts with VAC or game bans never are. `total` is how many players qualify for the board.

ParameterInTypeDefaultDescription
boardqueryone of `kills`, `kd`, `headshots`, `hours`, `accuracy`, `scientists`, `animals`, `gathered`, `building`, `rockets`, `fish`, `deaths`killsWhich leaderboard.
countryquerystringTwo-letter country code (Steam profile country).
pagequeryinteger1(max 100, min 1)
per_pagequeryinteger20(max 100, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/players/leaderboard"

GET/players/{steamid}copy URL

Player profile, Rust stats and achievements

Profile summary (name, avatar, country, Steam level, account age), VAC/game bans, Rust playtime, every Rust stat Steam exposes grouped into Combat / Animals & NPCs / How you died / Gathering & loot / Building / Travel / Life on the island / Fishing / Music / Everything else, six headline figures (kills, deaths, K/D, headshots, bullet and arrow accuracy), and all 116 achievements with unlock dates. `stats_private` is true when the profile hides game details, in which case `groups` and `achievements` are empty.

ParameterInTypeDefaultDescription
steamid requiredpathstring17-digit SteamID64. Use /players/resolve for URLs and vanity names.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/players/76561199126382502"

Example response

{
  "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"
}

Inventories

category inventory · 1,000 requests/day

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. Also: a Rust Premium Access estimate - whether an account's skins clear the $15 minimum Premium servers require, and the cheapest skins that would close the gap.

GET/inventory/leaderboardcopy URL

Most valuable inventories ever checked

The rust.wiki/inventory leaderboard: every inventory anyone has looked up, ranked by total value at its last check (values are re-priced each time an inventory is viewed or by the daily warmer for the top 20). Includes the network-wide totals. 20 per page.

ParameterInTypeDefaultDescription
pagequeryinteger11-based page; 20 inventories per page. (min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/inventory/leaderboard"

Example response

{
  "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"
  ]
}

GET/inventory/{steamid}copy URL

Value a Steam account's Rust skins

Every Rust skin the account holds with `quantity`, unit `price` and `value` (cents), sorted by value, and the same attributes /skins filters on (`collection`, `creator`, `item_shortname`, `item_name`, `est_supply`, `released_year`, `colors`, and `flags`: limited_time, permanent, marketable, tradable, breakable, glows, commodity, drop), plus `total_value`, `item_count`, `distinct_skins`, a `categories` breakdown with share percentages, the owner's display name and avatar, and `value_history` (the current holdings re-priced at each of the last 365 days, in USD DOLLARS, not cents, at each day's Steam sale price - so its latest point can be below `total_value`, which is at current asking prices). `found` is false for private or empty inventories; `stale` is true when Steam was unreachable and the last stored snapshot was re-priced instead.

ParameterInTypeDefaultDescription
steamid requiredpathstring17-digit SteamID64 (resolve URLs and vanity names with /players/resolve).
refreshquerybooleanFalseForce a live Steam read instead of the stored snapshot (max 100 per key per day).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/inventory/76561198869732295"

Example response

{
  "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"
}

GET/inventory/{steamid}/historycopy URL

The inventory's value over time: the account's current holdings re-priced at each day's Steam SALE price (median sale), `values` in USD cents, oldest first - the line on the rust.wiki inventory chart. It shows how the market moved, not when items were bought. `headline_total_value` is the total at current Steam ASKING prices (lowest sell order) as of `headline_checked_at`, the number shown at the top of the inventory page; for thinly traded skins it can sit well above the latest point here. Only inventories that have been looked up have a series. Read from stored data: never a live Steam call.

ParameterInTypeDefaultDescription
steamid requiredpathstring17-digit SteamID64.
rangequerystring1y7d, 30d, 90d, 1y, 2y, 3y, 4y, 5y, all, or custom (with start_date/end_date).
start_datequerystringYYYY-MM-DD, with range=custom.
end_datequerystringYYYY-MM-DD, with range=custom.
intervalquerystringautodaily, weekly, monthly, or auto (daily up to 400 points, then weekly, then monthly past 400 weeks).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/inventory/76561198869732295/history"

GET/inventory/{steamid}/valuationcopy URL

What an inventory is realistically worth

The inventory valued three ways, plus what selling would actually raise. `at_asks` is the headline number (each skin at its cheapest Steam listing, falling back to the best buy order); `at_bids` is every skin at its best buy order; `at_recent_sales` is every skin at its latest Steam median sale price (the inventory chart's basis). `sell_now` walks each skin's real buy-order ladder for the quantity held: `units_sellable` of `units_held` could be sold instantly for `gross` (what buyers pay) and `net_after_fees` (after Steam's 15%). `biggest_ask_gaps` lists the skins whose cheapest listing sits furthest above their recent sales - thin order books where the headline is least reliable. All cents. Uses the stored holdings (the last lookup) and current order books: never a live Steam call; look the inventory up first if `found` is false.

ParameterInTypeDefaultDescription
steamid requiredpathstring17-digit SteamID64.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/inventory/76561198869732295/valuation"

GET/inventory/{steamid}/snapshotscopy URL

Dates with a saved daily snapshot

Every date (newest first, up to 400) on which a daily snapshot of this inventory was stored, plus `totals`: each of those days' total value in cents (that day's holdings at that day's prices). Snapshots are written when an inventory is looked up; fetch one with /inventory/{steamid}/snapshots/{date}.

ParameterInTypeDefaultDescription
steamid requiredpathstring17-digit SteamID64.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/inventory/76561198869732295/snapshots"

Example response

{
  "steamid": "76561198869732295",
  "count": 21,
  "dates": [
    "2026-10-03",
    "2026-10-02",
    "2026-10-01",
    "… 18 more"
  ]
}

GET/inventory/{steamid}/snapshots/{date}copy URL

One saved daily snapshot

The inventory exactly as it was priced on that day: items with quantity and that day's price, total value and item count. Useful for 'what was this worth last month' comparisons.

ParameterInTypeDefaultDescription
steamid requiredpathstring17-digit SteamID64.
date requiredpathstringISO date (YYYY-MM-DD) from /inventory/{steamid}/snapshots.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/inventory/76561198869732295/snapshots/2026-09-30"

Example response

{
  "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"
  ]
}

GET/inventory/{steamid}/premium-accesscopy URL

Does this account likely have Rust Premium Access? (estimate)

Premium servers (`server.premium true`) only admit accounts Facepunch marks premium: an inventory worth at least `required_value` (1500 = $15, the game's own text). This values the account's Rust skins at the wiki price (Steam lowest sell order) and compares. `qualifies_estimate` is true/false (null when the inventory is private or empty); `status` is likely, borderline_above, borderline_below, unlikely or unknown - values within $12-$18 are borderline because Facepunch's prices are unknown. `shortfall` is the cents still needed; `suggestions.one_skin` are the cheapest liquid skins that close it alone, `suggestions.cheapest` the cheapest liquid skins overall (`suggestions.updating` true: the hourly list is being rebuilt, both lists empty - ask again later). An ESTIMATE: Facepunch doesn't publish its valuation. Same lookup and caching as /inventory/{steamid} (stored copy for 24 h).

ParameterInTypeDefaultDescription
steamid requiredpathstring17-digit SteamID64 (resolve URLs and vanity names with /players/resolve).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/inventory/76561198869732295/premium-access"

GET/inventory/{steamid}/performancecopy URL

How each skin in an inventory moved: then vs now

The Performance tab of rust.wiki/inventory/{steamid}: for every skin in the STORED inventory (look it up with `/inventory/{steamid}` first if it was never checked), its Steam price `then` (that day's average sale, or the store price for `all`) and `now`, with `change` and `change_pct` for the whole stack (`quantity`), plus totals: `value_then`, `value_now`, `change`, `change_pct`, `winners`, `losers`. `no_history` counts skins with no price for that date. Cents. No Steam call - stored price history only; cached 10 minutes.

ParameterInTypeDefaultDescription
steamid requiredpathstring17-digit SteamID64. (pattern ^7656119\d{10}$)
rangequeryone of `1d`, `1w`, `1m`, `3m`, `6m`, `1y`, `2y`, `5y`, `all`1mCompare against one day, week, month, 3/6 months, 1/2/5 years ago, or `all` (each skin's original store price, else its first Steam sale).
sortqueryone of `gain`, `loss`, `pct_gain`, `pct_loss`, `value`gain`gain`/`loss` = biggest change in cents for the whole stack; `pct_gain`/`pct_loss` = biggest % change; `value` = most valuable now.
limitqueryinteger50Most skins to return. (max 500, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/inventory/76561197972745245/performance"

Example response

{
  "steamid": "76561197972745245",
  "range": "1m",
  "days": 30,
  "skins": 221,
  "no_history": 7,
  "value_then": 4920707,
  "value_now": 5382573,
  "change": 461866,
  "change_pct": 9.4,
  "winners": 145,
  "losers": 66,
  "items": [
    {
      "name": "Creepy Clown Bandana",
      "itemdefid": 10104,
      "quantity": 23,
      "now": 90352,
      "then": 64642,
      "then_day": "2026-10-17",
      "sales_then": 1,
      "basis": "day_avg",
      "value_then": 1486766,
      "value_now": 2078096,
      "change": 591330,
      "change_pct": 39.8,
      "skin_url": "https://rust.wiki/skin/10104"
    },
    {
      "name": "Banana Eoka",
      "itemdefid": 21012,
      "quantity": 12,
      "now": 14969,
      "then": 10354,
      "then_day": "2026-10-16",
      "sales_then": 1,
      "basis": "day_avg",
      "value_then": 124248,
      "value_now": 179628,
      "change": 55380,
      "change_pct": 44.6,
      "skin_url": "https://rust.wiki/skin/21012"
    },
    "…"
  ],
  "page": "https://rust.wiki/inventory/76561197972745245"
}

Casino games

category games · 10,000 requests/day

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.

GET/gamescopy URL

Every game on rustprofit.com with a one-line description, whether its finished rounds are public here (`public_rounds`: roulette, coinflip, jackpot and crash have GET /games/{game}/rounds; mines, tower and upgrade are single-player and only appear in the key owner's own GET /games/me/history), its house edge as a fraction, and `live_wagered_cents` - the value currently sitting in that game's open round(s), from the same cache the site's header pot display reads (null if the cache is cold). All money is integer USD cents.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/games"

Example response

{
  "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"
}

GET/games/fairnesscopy URL

How the provably-fair system works, as data

The commit-then-reveal scheme behind every game, written out so a program (or a reader) can re-implement the verification: per game the inputs, the exact HMAC-SHA256 message, the modulo, how the roll maps to an outcome (roulette colours, coinflip/jackpot ticket ranges, mines and tower Fisher-Yates position draws, the crash-point and upgrade formulas), which id goes into the message (the round `id` for roulette/coinflip/ jackpot, the shared `game_id` for mines/tower/crash/upgrade), how EOS block hashes and the player's client seed keep the house from choosing the message, when each server seed is revealed, and the house edge. Static - mirrors app code, and GET /games/verify applies it.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/games/fairness"

Example response

{
  "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"
    }
  }
}

GET/games/verifycopy URL

Recompute a round's outcome from its revealed seeds

A pure function - no database, nothing stored. Applies the exact formulas in GET /games/fairness and returns `server_seed_hash` (sha256 of the seed, to match against the hash the site published before the round) plus the recomputed outcome: roulette `roll` and `colour`; coinflip/jackpot `ticket` (compare with the round's `ticket_range`s); mines `roll` and `mine_positions`; tower `bad_positions` per row; crash `roll` and `crash_point`; upgrade `roll` (and `win` when `chance` is given). Missing per-game inputs return 422.

ParameterInTypeDefaultDescription
game requiredquerystringWhich game's formula to apply.
server_seed requiredquerystringThe revealed server seed (`server_seed` on a finished round or seeds page). (min length 1, max length 512)
public_seedquerystringRoulette only: the day's public seed shown next to the hash (five random numbers 1-39 run together).
eos_block_hashquerystringCoinflip/jackpot only: the irreversible EOS block id (`eos_block_hash` on the round).
roundqueryintegerRoulette/coinflip/jackpot only: the round id (`id` of the round, `round` in its `fair` block).
client_seedquerystringMines/tower/crash/upgrade only: the player's client seed shown on the round.
game_idqueryintegerMines/tower/crash/upgrade only: the SHARED game id (`game_id` on the round / history row), not the round id.
mine_countqueryintegerMines only: how many mines the round was played with.
cols_per_rowqueryintegerTower only: tiles per row (2-4).
difficultyquerystringTower only: easy, medium or hard (derives bad_count); or pass bad_count directly.
bad_countqueryintegerTower only: bad tiles per row, if you have it instead of difficulty.
rowsqueryinteger8Tower only: rows to draw (the site plays 8). (max 64, min 1)
chancequerynumberUpgrade only (optional): the win chance as a fraction, e.g. 0.45, to also evaluate the win.
offsetquerynumberUpgrade only (optional): the win-zone offset committed at start (0 for 'under').
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/games/verify?game=mines&server_seed=3f1c9a8e5b7d2c4a6e8f0b1d3c5a7e9f"

Example response

{
  "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
  }
}

GET/games/me/historycopy URL

Your own game history

The API key owner's own finished rounds across the seven games, one row per round played (the same source as the site's History page), newest first by default: `type` (the game), `game_id` (the shared id used in the fairness message for mines/tower/crash/upgrade), `round_id` (the per-game round id - the `id` of GET /games/{game}/rounds/{round_id} for roulette/coinflip/jackpot/crash and of the seeds pages), `amount_cents` (bet), `payout_cents`, `win`, `completed_at` and `details` (per-game facts such as multiplier, mines count, crash point, revealed server seed, the skins involved as `{name, classid, price}`). Trade-offer, bot and asset identifiers are removed. Only the key owner's own account is ever returned.

ParameterInTypeDefaultDescription
gamequerystringOnly this game; omit for all seven.
winquerybooleantrue = only wins, false = only losses, omit for both.
sortquerystringnewestnewest (default), amount_desc or amount_asc (by bet amount).
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/games/me/history"

Example response

{
  "page": 1,
  "per_page": 50,
  "total": 0,
  "pages": 1,
  "results": []
}

GET/games/me/statscopy URL

The API key owner's lifetime totals as the site's profile shows them: `total_wagered`, `total_won`, `total_lost`, `profit`, `played`, `wins`, `losses`, `win_loss_ratio`, biggest win/loss with the game and round id, and the same six counters per game (`roulette`, `coinflip`, `jackpot`, `mines`, `crash`, `upgrade`, `tower`). Amounts are USD cents. 404 until the account has played a round.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/games/me/stats"

Example response

{
  "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"
}

GET/games/me/client-seedcopy URL

The client seed the key owner's next mines/tower/crash/upgrade round will be created with (it is fixed on the round at creation, so later changes never affect a round in play). Read-only here - change it on the site's fairness page. `null` means the account has not played a seed-pair game yet; the site generates one the first time.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/games/me/client-seed"

Example response

{
  "client_seed": "free",
  "used_by": [
    "mines",
    "tower",
    "crash",
    "… 1 more"
  ],
  "message_format": "{client_seed}-{game_id}",
  "change_at": "https://rustprofit.com/fairness"
}

GET/games/{game}/roundscopy URL

Finished rounds of a public game, newest first

Completed rounds only, newest first. Every row has `id`, `started_at`/`ended_at`, `result`, the pot and tax in cents, the participants as the site's own round page shows them (public `user_id`, `username`, `avatar`, `badge`, `level`, bet in cents - never SteamIDs) and a `fair` block: `server_seed_hash`, `server_seed` (null with `seed_revealed: false` for roulette rounds under the still-active daily seed; `seed_id` is that day's row on /games/roulette/seeds), the public input (roulette `public_seed`, coinflip/jackpot `eos_block` + `eos_block_hash`, crash `client_seed`), the id the HMAC uses and the exact `message`. Per game: roulette `result.colour`/`number` and `bets_cents` per colour; coinflip `creator`/`opponent` with `side`, `ticket_range`, `win_chance_pct`, `is_house_bot`; jackpot `participants` with `ticket_range`/`win_chance_pct` and `result.winner`; crash `result.crash_point`/ `cashed_out_at`/`win` with the single `player`. Item lists are on GET /games/{game}/rounds/{round_id}.

ParameterInTypeDefaultDescription
game requiredpathstringroulette, coinflip, jackpot or crash. mines/tower/upgrade return 404 (single-player; see /games/me/history).
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/games/roulette/rounds"

Example response

{
  "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"
  ]
}

GET/games/{game}/rounds/{round_id}copy URL

One finished round with every bet

The same shape as the rounds list plus the full bet detail: roulette participants carry `bets` (per colour, with each skin as `{name, classid, price, amount}`) and `payout_items`; coinflip `creator`/ `opponent` carry `items`; jackpot `participants` carry `items`; crash has `bet_items` and `payout_items`. 404 for an unknown id or a round that has not finished (nothing about a round in progress is served).

ParameterInTypeDefaultDescription
game requiredpathstringroulette, coinflip, jackpot or crash.
round_id requiredpathintegerThe round id (`id` in the rounds list; also `round_id` in /games/me/history). (min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/games/roulette/rounds/196855"

Example response

{
  "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
  }
}

GET/games/{game}/seedscopy URL

Revealed seeds of finished rounds, as the site's fairness page lists them

Exactly what each game's own public seeds page returns, 15 per page, newest first - nothing added. Field names are the site's: `server_random` is the revealed server seed, `server_random_hashed` its SHA-256 commitment. Roulette lists the daily seed pairs (`public_seed`, `start_roll`/`end_roll` = the round ids the seed covered, `active`; the active day's `server_random` is withheld). Coinflip/jackpot rows carry `target_eos_block_hash` and the drawn `ticket`; mines/tower/crash/upgrade rows carry `client_seed` and the round's parameters (`mine_count`; `cols_per_row`/`difficulty`; `crash_point`/`cashed_out_at_multiplier`; `chance`/`multiplier`/`direction`/`offset`/`roll`) with `win`. `id_` is the round id. Feed a row into GET /games/verify (for the seed-pair games use the round's `game_id` from /games/me/history or /games/crash/rounds, not `id_`).

ParameterInTypeDefaultDescription
game requiredpathstringAny of the seven games.
pagequeryinteger11-based page; 15 rows per page (the site's own page size). (min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/games/mines/seeds"

Example response

{
  "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"
  ]
}

Rust servers

category servers · 10,000 requests/day

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. `hidden_in_game` is true when the server's address is on Facepunch's public list of servers that Rust's in-game server browser doesn't show (checked hourly; no reason is published). Those servers are left out of the ranked answers (`/servers/top`, `/servers/leaderboard` and `/servers` unless `include_hidden` or a `search` is given) and stay reachable by id. Maps: every server's map drawn by rust.wiki/RustProfit from the server's own map file (or generated from its world seed and size) - text-labelled and plain images, the monument list with coordinates, biome and land percentages (/servers/{id}/map, /maps/lookup). POST /maps asks for any public.map URL or procedural seed + size to be drawn; drawing is asynchronous (poll /maps/jobs/{job_id}). Plus server networks (brands: servers grouped by the website, Discord, logo or connect address they publish), the "Is this server vanilla?" check (status, detected differences from Rust's defaults, the owner's claims), each server's predicted wipe schedule, the site-wide upcoming-wipes list, the monthly force-wipe countdown and a player graph up to 90 days. Also the server config builder (servers.rustprofit.com/config-builder): every Rust server ConVar with its default, help text, type and range, the presets and game modes, and a builder that turns settings into a server.cfg, the start command and the same warnings the page gives.

GET/servers/brandscopy URL

Rust server networks (brands) and their player counts

Networks running two or more Rust servers - the list on servers.rustprofit.com/brands. Servers are grouped when they publish the same website, Discord invite, logo or connect address in their A2S server rules, so a network's new servers join on their own. Each brand: `slug`, `name`, `domain`, `website_url`, `discord_url`, `socials`, `logo_url`, `servers` (in the network), `online` (servers online now), `players` (online now) and its page `url`. Recomputed every 10 minutes; use `/servers/brands/{slug}` for the member servers.

ParameterInTypeDefaultDescription
qquerystringCase-insensitive substring of the network's name or domain.
min_onlinequeryinteger1Only networks with at least this many servers online now (the site's /brands page uses 1). (max 1000, min 0)
sortqueryone of `players`, `servers`, `name`players`players` online now (default, the site's order), `servers` in the network, or `name`.
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/brands"

Example response

{
  "page": 1,
  "per_page": 3,
  "total": 630,
  "pages": 210,
  "results": [
    {
      "slug": "rustafied-com",
      "name": "Rustafied.com",
      "domain": "rustafied.com",
      "website_url": "https://rustafied.com",
      "discord_url": null,
      "socials": [
        {
          "platform": "Discord",
          "handle": "rustafied",
          "url": "https://discord.gg/rustafied"
        }
      ],
      "logo_url": null,
      "servers": 42,
      "online": 42,
      "players": 7605,
      "url": "https://servers.rustprofit.com/brand/rustafied-com"
    },
    {
      "slug": "rustoria-co",
      "name": "Rustoria.co",
      "domain": "rustoria.co",
      "website_url": "http://rustoria.co",
      "discord_url": null,
      "socials": [],
      "logo_url": null,
      "servers": 26,
      "online": 25,
      "players": 7383,
      "url": "https://servers.rustprofit.com/brand/rustoria-co"
    },
    "…"
  ],
  "page_url": "https://servers.rustprofit.com/brands"
}

GET/servers/brands/{slug}copy URL

One server network and its servers

The network's summary (as in `/servers/brands`) plus `server_list`: every member server, online ones first and busiest first, as `{id, name, country, players, max_players, is_online, connect, vanilla, url}`. Use `/servers/{id}` for one server in full. Member list cached for five minutes.

ParameterInTypeDefaultDescription
slug requiredpathstringThe brand's slug from `/servers/brands` (the part after /brand/ in its servers.rustprofit.com URL). (min length 1, max length 80, pattern ^[a-z0-9-]+$)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/brands/rustoria"

Example response

{
  "slug": "rustafied-com",
  "name": "Rustafied.com",
  "domain": "rustafied.com",
  "website_url": "https://rustafied.com",
  "discord_url": null,
  "socials": [
    {
      "platform": "Discord",
      "handle": "rustafied",
      "url": "https://discord.gg/rustafied"
    }
  ],
  "logo_url": null,
  "servers": 42,
  "online": 42,
  "players": 7605,
  "url": "https://servers.rustprofit.com/brand/rustafied-com",
  "server_list": [
    {
      "id": 9198,
      "name": "Rustafied.com - US Friday",
      "country": "US",
      "players": 393,
      "max_players": 450,
      "is_online": true,
      "connect": "steam://connect/104.143.2.124:28015",
      "vanilla": "Vanilla · plugins",
      "url": "https://servers.rustprofit.com/server/9198"
    },
    {
      "id": 9511,
      "name": "Rustafied.com - US Long - Large",
      "country": "US",
      "players": 226,
      "max_players": 275,
      "is_online": true,
      "connect": "steam://connect/104.143.2.103:28015",
      "vanilla": "Vanilla · plugins",
      "url": "https://servers.rustprofit.com/server/9511"
    },
    "…"
  ]
}

GET/servers/wipe-schedulecopy URL

Servers predicted to wipe in the next 48 hours

The "wiping in the next 48 hours" list from servers.rustprofit.com/wipes: the busiest servers whose own wipe pattern (learned from their detected wipes: weekday + hour for weekly servers, every N days, fortnightly...) puts their next wipe inside the window, soonest first. Each entry: `next_wipe_at` (UTC, an estimate), `schedule` (e.g. "weekly, Fridays ~21:30 UTC"), `on_schedule` of `considered` past wipes that fit it, `reason` and the server (`id`, `name`, `country`, `players`, `connect`, `vanilla`, `url`). The monthly force wipe is not listed per server - every server wipes then; see `force_wipe` here and `/servers/force-wipe`. `total` counts every server predicted in the 48-hour window, `results` only the busiest 100 of them. Rebuilt after every poll cycle.

ParameterInTypeDefaultDescription
hoursqueryinteger48Look-ahead window in hours (1-48). (max 48, min 1)
countryquerystringOnly servers hosted in this ISO 3166-1 alpha-2 country.
limitqueryinteger50Most servers to return (1-100). (max 100, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/wipe-schedule"

Example response

{
  "hours": 24,
  "country": null,
  "total_predicted_48h": 139,
  "count": 3,
  "results": [
    {
      "next_wipe_at": "2026-11-16T04:57:00",
      "due_in_hours": -0.1,
      "schedule": "weekly, Mondays ~05:00 UTC",
      "on_schedule": 9,
      "considered": 11,
      "reason": "weekly, Mondays ~05:00 UTC (9 of 11 on schedule)",
      "avg_cycle_hours": 168.0,
      "server": {
        "id": 8151,
        "name": "[SEA] Redux 3x • Solo Only • Modded",
        "country": "US",
        "players": 2,
        "max_players": 120,
        "is_online": null,
        "connect": "steam://connect/170.23.98.133:25596",
        "vanilla": "Modded · Carbon",
        "url": "https://servers.rustprofit.com/server/8151"
      }
    },
    {
      "next_wipe_at": "2026-11-16T05:21:00",
      "due_in_hours": 0.3,
      "schedule": "weekly, Mondays ~05:30 UTC",
      "on_schedule": 8,
      "considered": 9,
      "reason": "weekly, Mondays ~05:30 UTC (8 of 9 on schedule)",
      "avg_cycle_hours": 168.0,
      "server": {
        "id": 40438,
        "name": "Rustafied.com - AU Monday",
        "country": "AU",
        "players": 22,
        "max_players": 100,
        "is_online": null,
        "connect": "steam://connect/103.193.80.196:28015",
        "vanilla": "Vanilla · plugins",
        "url": "https://servers.rustprofit.com/server/40438"
      }
    },
    "…"
  ],
  "force_wipe": {
    "at": "2026-12-03T19:00:00",
    "in_window": false
  },
  "page": "https://servers.rustprofit.com/wipes",
  "generated_at": "2026-11-16T05:01:16.781531"
}

GET/servers/force-wipecopy URL

Rust's monthly force wipe: countdown, next dates and past wipes

Everything on servers.rustprofit.com/force-wipe: `next` (UTC ISO time, `seconds_until`, London wall-clock time and zone, US Eastern time), `zones` (the same moment in eight big cities), `upcoming` (the next six force wipes), `history` (the last twelve, each with the Facepunch devblog that shipped it and our explainer post when there is one), `rule`, `blueprints` and `faq`. Rust force wipes on the first Thursday of every month at 19:00 London time (18:00 UTC in UK summer time, 19:00 UTC in winter), when the monthly update ships. Devblog matches cached an hour.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/force-wipe"

Example response

{
  "next": {
    "at": "2026-12-03T19:00:00Z",
    "uk_time": "19:00",
    "uk_zone": "GMT",
    "us_eastern_time": "2:00 PM EST",
    "seconds_until": 1519123
  },
  "zones": [
    {
      "city": "Los Angeles",
      "tz": "America/Los_Angeles",
      "local": "Thu 3 Dec, 11:00"
    },
    {
      "city": "New York",
      "tz": "America/New_York",
      "local": "Thu 3 Dec, 14:00"
    },
    "…"
  ],
  "upcoming": [
    {
      "at": "2026-12-03T19:00:00Z",
      "uk_time": "19:00",
      "uk_zone": "GMT",
      "us_eastern_time": "2:00 PM EST"
    },
    {
      "at": "2027-01-07T19:00:00Z",
      "uk_time": "19:00",
      "uk_zone": "GMT",
      "us_eastern_time": "2:00 PM EST"
    },
    "…"
  ],
  "history": [
    {
      "at": "2026-11-05T19:00:00Z",
      "uk_time": "19:00",
      "uk_zone": "GMT",
      "us_eastern_time": "2:00 PM EST",
      "release": {
        "title": "Printed and Polished",
        "devblog_url": "https://rust.facepunch.com/news/printed_and_polished",
        "post_url": null
      }
    },
    {
      "at": "2026-10-01T18:00:00Z",
      "uk_time": "19:00",
      "uk_zone": "BST",
      "us_eastern_time": "2:00 PM EDT",
      "release": {
        "title": "Livestock Update",
        "devblog_url": "https://rust.facepunch.com/news/livestock",
        "post_url": "https://blog.rustprofit.com/rust-update-livestock-update-explained"
      }
    },
    "…"
  ],
  "rule": "Rust force wipes on the first Thursday of every month at 19:00 London time, when Facepunch releases the monthly update ( Facepunch ). Dates follow Facepunch's first-Thursday rule. When December 2025's update content was delayed, Facepunch still shipped “a straightforward wipe only” at “the regular time of 19:00 GMT” ( Getting It Right ); any change to a date is announced in the Rust news .",
  "blueprints": "Every force wipe resets the map : bases, deployables and everything built or stored on the server are gone, and everyone starts the new map from scratch. Blueprints usually stay. Facepunch wrote in November 2025 that “the majority of servers don’t Blueprint wipe, including our Facepunch servers”, and it forces a blueprint wipe only with particular updates, announced in that month’s devblog — that …",
  "faq": [
    {
      "q": "When is the next Rust force wipe?",
      "a": "Thursday 3 December 2026 at 19:00 UK time (GMT) - 19:00 UTC, 2:00 PM EST."
    },
    {
      "q": "What time does Rust force wipe?",
      "a": "19:00 London time on the first Thursday of the month, when the monthly update releases. That's 18:00 UTC while the UK is on summer time and 19:00 UTC in winter - usually 2 PM US Eastern."
    },
    "…"
  ],
  "page": "https://servers.rustprofit.com/force-wipe",
  "generated_at": "2026-11-16T05:01:16.792586"
}

GET/servers/{server_id}/wipe-schedulecopy URL

One server's wipe history and predicted next wipe

The server's last 12 detected wipes (`wipes`, newest first: `detected_at`, map seed/size before and after), `avg_cycle_hours` (mean gap, as on the server page), `prediction` - the same pattern-based estimate the /wipes page uses (`next_wipe_at`, `schedule` like "weekly, Thursdays ~18:00 UTC", `on_schedule` of `considered`, `reason`), or null when the history shows no confident pattern (too few wipes, irregular, or noise from restarts) - and `next_force_wipe_at`, when every server wipes. Cached for five minutes.

ParameterInTypeDefaultDescription
server_id requiredpathintegerThe server's numeric id (from `/servers`). (min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/1/wipe-schedule"

Example response

{
  "server": {
    "id": 1446105,
    "name": "Rustoria.co - BR Long",
    "country": "BR",
    "players": 288,
    "max_players": 325,
    "is_online": true,
    "connect": "steam://connect/104.234.189.153:28010",
    "vanilla": "Vanilla · plugins",
    "url": "https://servers.rustprofit.com/server/1446105"
  },
  "wipe_count": 2,
  "last_wipe_at": "2026-11-05T18:58:38.147558",
  "avg_cycle_hours": 840.9,
  "prediction": null,
  "wipes": [
    {
      "detected_at": "2026-11-05T18:58:38.147558",
      "previous_seed": "1337",
      "new_seed": "1337",
      "previous_size": 4000,
      "new_size": 4000
    },
    {
      "detected_at": "2026-10-01T18:06:06.695429",
      "previous_seed": "1337",
      "new_seed": "1337",
      "previous_size": 4000,
      "new_size": 4000
    }
  ],
  "next_force_wipe_at": "2026-12-03T19:00:00"
}

GET/servers/{server_id}/vanillacopy URL

Is this server vanilla? Status, differences, claims and published settings

The "Is this server vanilla?" card from the server's page, built from what the server itself publishes (its Steam tags and A2S rules) compared with Rust's own defaults: `status` (`vanilla` = no modded tag, `modded` = tagged modded, which puts it in the in-game browser's Modded tab, `unknown` = tags not read yet), `label` (e.g. "Vanilla · Oxide"), `framework` (oxide/carbon when installed), `summary` (one paragraph), `differences` (settings that differ from the defaults: game mode, PvE, team size, hidden map, custom map, premium, plugin tags - each with `value`, `default`, `source` tags/rules and a `note`), `evidence` (positive signs: no modded tag, unmodified game code checksum), `claims` (what the NAME or owner tags claim - "2x", "vanilla", "no decay" - with `conflict` true when the settings contradict it), `choices` (map size), `not_checkable` (settings servers never publish, e.g. gather rate, decay, upkeep - nobody outside can verify them), plus `published` (game mode, PvE, custom map, connect address, game build, website/Discord/socials, logo and banner, description) and the server's `brand` (network) when it has one. Cached for five minutes.

ParameterInTypeDefaultDescription
server_id requiredpathintegerThe server's numeric id (from `/servers`). (min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/1/vanilla"

Example response

{
  "server": {
    "id": 1446105,
    "name": "Rustoria.co - BR Long",
    "country": "BR",
    "players": 288,
    "max_players": 325,
    "is_online": true,
    "connect": "steam://connect/104.234.189.153:28010",
    "vanilla": "Vanilla · plugins",
    "url": "https://servers.rustprofit.com/server/1446105"
  },
  "status": "vanilla",
  "label": "Vanilla · plugins",
  "framework": null,
  "summary": "No modded tag and no plugin framework: as far as the server's own settings show, this is vanilla Rust. Settings that differ from the defaults: team size limit, custom map.",
  "chips": [
    "Team max 12",
    "Custom map"
  ],
  "differences": [
    {
      "setting": null,
      "label": "Extra tags from plugins",
      "value": "rustmaps",
      "default": "none",
      "source": "tags",
      "kind": "mod",
      "note": "Rust itself never writes these tags (game version 2636), so a plugin or server mod added them."
    },
    {
      "setting": "relationshipmanager.maxteamsize",
      "label": "Team size limit",
      "value": "12",
      "default": "8",
      "source": "tags",
      "kind": "setting",
      "note": "The largest team the in-game team system allows."
    },
    "…"
  ],
  "plugin_tags": [
    "rustmaps"
  ],
  "evidence": [
    {
      "label": "No modded tag",
      "source": "tags",
      "note": "It would be listed under Community, not Modded, in the in-game browser."
    },
    {
      "label": "No Oxide or Carbon tag",
      "source": "tags",
      "note": "Both frameworks announce themselves in the tags."
    }
  ],
  "claims": [
    {
      "label": "Vanilla",
      "source": "owner tag",
      "conflict": false,
      "note": "Set by the owner in server.tags. "
    },
    {
      "label": "Wipes: Monthly",
      "source": "owner tag",
      "conflict": false,
      "note": null
    },
    "…"
  ],
  "choices": [
    {
      "label": "Map size",
      "value": "4000",
      "default": "4500"
    }
  ],
  "not_checkable": [
    {
      "setting": "decay.scale",
      "default": "1"
    },
    {
      "setting": "decay.upkeep",
      "default": "true"
    },
    "…"
  ],
  "has_tags": true,
  "has_rules": true,
  "game_build_checked_against": "26498655",
  "published": {
    "game_mode": null,
    "pve": false,
    "custom_map_url": "https://maps.rustmaps.com/289/848721e4f6554ac0b19e11a279a4760c/procedural__4000__BhEeL_rPkSfpBsmOWvViQ.map",
    "connect_alias": "long.rustoria.lat",
    "facts": [
      {
        "label": "Game mode",
        "value": "Survival"
      },
      {
        "label": "PvE",
        "value": "No"
      },
      "…"
    ],
    "website_url": "http://rustoria.co",
    "discord_url": null,
    "socials": [],
    "logo_url": "https://servers.rustprofit.com/logo/dc71da1912d0c099dd6fbd9b75b16000.webp",
    "header_url": "https://fs.rustoria.co/dylan/dc481905-2269-4452-bd3d-5ea6b88ccdd3.png",
    "description": "Wipe Schedule:\n Map - Monthly @ Force\n BPs - Monthly @ Force\n\nVIP: donate.rustoria.co\n\nRules:\n - No hacking / scripting\n - No intentional bug abuse\n - No EAC / FP banned alts\n - No ban evading\n - No racism\n\nGood performance\nActive non playing admins\nSeeds are carefully picked\n\nDiscord: rustoria.co/discord\nFull rules: rustoria.co/vanilla/rules"
  },
  "brand": {
    "slug": "rustoria-co",
    "name": "Rustoria.co",
    "domain": "rustoria.co",
    "website_url": "http://rustoria.co",
    "discord_url": null,
    "socials": [],
    "logo_url": null,
    "servers": 26,
    "online": 25,
    "players": 7383,
    "url": "https://servers.rustprofit.com/brand/rustoria-co"
  },
  "page": "https://servers.rustprofit.com/server/1446105"
}

GET/servers/{server_id}/player-graphcopy URL

One server's player graph: 24 hours to 90 days

The data behind the range tabs of the server page's player chart: parallel arrays `labels` (UTC ISO-8601), `players` (average in each point) and `peak` (highest reading in it). Unlike `/servers/{id}/history` (raw readings, kept 7 days) the 30- and 90-day ranges come from the per-server hourly rollup, kept 90 days. Also `peak_players` and `avg_players` over the range. Cached for five minutes.

ParameterInTypeDefaultDescription
server_id requiredpathintegerThe server's numeric id (from `/servers`). (min 1)
rangequeryone of `24h`, `7d`, `30d`, `90d`7d`24h` = every poll; `7d` and `30d` = one point per hour; `90d` = one point per day.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/1/player-graph"

Example response

{
  "server_id": 149,
  "range": "30d",
  "labels": [
    "2026-10-29T04:00:00",
    "2026-10-29T05:00:00",
    "…"
  ],
  "players": [
    311,
    333,
    "…"
  ],
  "peak": [
    311,
    333,
    "…"
  ],
  "point_count": 124,
  "peak_players": 3600,
  "avg_players": 1526.1,
  "page": "https://servers.rustprofit.com/server/149"
}

GET/serverscopy URL

Browse, filter and search the server list

One page of servers with the same filters, ordering and five-minute cache as the servers.rustprofit.com list and its hub pages (/country/de, /vanilla, /solo, /gather/2x...). Each result is the full public server record: identity and connect details (`ip`, `game_port`, `query_port`, `connect` as a `steam://` URI), `map`, `world_seed`, `world_size`, `country`/`country_name`, live `current_players`/`max_players`/`queued_players`, the `kind` (official/modded/vanilla) and `is_*` flags, `password_protected`, `vac_enabled`, `gather_rate` with its `gather_bucket`, `group_limit` with its `group` label, `tags`, owner-supplied `description` (first 500 characters), `banner_url`, `website_url`, `discord_url`, `first_seen_at`/`last_seen_at`/`last_polled_at`, the aggregates `votes`, `rating` (1-5 average, null when unrated) and `last_wipe_at`, and the server's page `url` plus embeddable `widget_url`/`badge_url`. Ties in every sort are broken by `id` so pages never overlap.

ParameterInTypeDefaultDescription
searchquerystringCase-insensitive substring match on the server name.
countryquerystringISO 3166-1 alpha-2 country the server is hosted in (GeoIP of its address); `/servers/countries` lists the values in use.
kindqueryone of `vanilla`, `modded`, `official`, `pure``vanilla` = not modded; `modded` = reports a modded flag over A2S; `official` = a Facepunch-run public server (by name convention).
groupqueryone of `solo`, `duo`, `trio`Team-size cap: `solo` (1), `duo` (2) or `trio` (3). Only servers whose cap is known match.
gatherqueryone of `2x`, `3x`, `5x`, `10x`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.
monumentquerystring[]Only servers whose current map (once drawn) has this monument - a name or a family (`Oil Rig` = large or small, `Military Base`), as `/servers/monument-types` lists them. Repeat for AND (up to 5): `monument=Launch Site&monument=Oil Rig`.
biomequeryone of `snow`, `desert`, `forest`, `tundra`, `jungle`Only servers whose drawn map is mostly this biome (its share is the highest of the five).
count_ofquerystringWith `count_min`/`count_max`: how many of this monument (name or family) the map has, e.g. `Oil Rig` with `count_min=2`.
count_minqueryintegerAt least this many `count_of` (default 1).
count_maxqueryintegerAt most this many `count_of`.
size_minqueryintegerMap size at least this many metres.
size_maxqueryintegerMap size at most this many metres.
share_biomequeryone of `snow`, `desert`, `forest`, `tundra`, `jungle`With `share_min`: a biome that must cover at least `share_min`% of the land.
share_minqueryintegerMinimum % of land in `share_biome`.
land_minqueryintegerLand at least this % of the map.
land_maxqueryintegerLand at most this % of the map.
map_kindqueryone of `procedural`, `custom``procedural` (generated from seed + size) or `custom` maps.
min_playersqueryintegerOnly servers with at least this many players online right now.
min_ratingquerynumberOnly servers whose average community rating (1-5) is at least this.
onlinequerybooleanTrue`true` (default) = only servers that were online at their last poll; `false` = only servers currently marked offline.
sortqueryone of `players`, `votes`, `rating`, `wiped`, `name`players`players` = most players online first (default); `votes` = most community votes; `rating` = highest average rating; `wiped` = most recently wiped; `name` = alphabetical.
include_hiddenquerybooleanInclude servers that Rust's in-game server browser doesn't show (`hidden_in_game: true`). Default: left out, except when `search` is given (a name lookup finds them).
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers"

Example response

{
  "page": 1,
  "per_page": 50,
  "total": 0,
  "pages": 1,
  "results": []
}

GET/servers/topcopy URL

Most populated servers right now

The online servers with the most players right now - the same query behind the rust.wiki Discord bot's `/servers` command - as a compact list: `id`, `name`, `players`, `max_players`, `country` and the server's page `url`. Use `/servers?sort=players` for the full records. Cached for 60 seconds.

ParameterInTypeDefaultDescription
countryquerystringRestrict to one ISO 3166-1 alpha-2 country.
limitqueryinteger10How many servers to return (1-50). (max 50, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/top"

Example response

{
  "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"
  ]
}

GET/servers/leaderboardcopy URL

Community leaderboard by votes or rating

Online servers ranked by Steam-authenticated community votes (one per user per server per day) or by average 1-5 rating - the ranking behind servers.rustprofit.com/best-rust-servers and /leaderboard?by=rating. Only servers with at least one vote (or rating) appear. Each entry is the full server record plus `rank`, `votes`, `rating` and `last_wipe_at`. Cached for five minutes.

ParameterInTypeDefaultDescription
byqueryone of `votes`, `rating`votes`votes` = most community votes (the site's Best Rust Servers page); `rating` = highest average rating, votes as tiebreaker.
limitqueryinteger50How many servers to return (1-100); the site shows 50. (max 100, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/leaderboard"

Example response

{
  "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"
  ]
}

GET/servers/wipescopy URL

Recently wiped servers

Wipes detected across every online server in the window, newest first - the feed behind servers.rustprofit.com/wipes. A wipe is detected when a server's `world_seed` or `world_size` changes between two polls, or when the last-wipe time it advertises moves past our previous poll (for servers with A2S rules disabled). Each entry has `detected_at`, the old and new seed/size, and the full server record. Expect thousands of entries in the 24 hours after Rust's monthly forced wipe (first Thursday). Cached for five minutes.

ParameterInTypeDefaultDescription
hoursqueryinteger24Look-back window in hours (1-168). The site's /wipes page shows 24. (max 168, min 1)
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/wipes"

Example response

{
  "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"
  ]
}

GET/servers/statscopy URL

The headline numbers from the servers.rustprofit.com homepage: `online_servers`, `total_players` and `queued_players` summed across every online server, `tracked_servers` (every row ever discovered, offline included), `steam_global_players` (Rust's concurrent player count from Steam, null if Steam did not answer), `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 configuration (`poll_interval_seconds` between cycles, `offline_after_seconds` before an unanswering server is marked offline, `snapshot_retention_days` of per-server history kept) and `workers` - the live heartbeat status of the discovery, polling and map-generation jobs, so you can tell how fresh the data is.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/stats"

Example response

{
  "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"
}

GET/servers/stats/historycopy URL

Site-wide player and server counts over time

The homepage chart's data: parallel arrays `labels` (UTC ISO-8601 bucket start), `players` (players online across all tracked servers), `queued` (players in queues) and `servers` (servers online). Each hourly point is the reading from the poll cycle that landed last in that hour; daily points average the hours. Cached for 15 minutes.

ParameterInTypeDefaultDescription
rangequeryone of `24h`, `7d`, `31d`, `1y`24h`24h` and `7d` return one point per hour; `31d` and `1y` return one averaged point per day.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/stats/history"

Example response

{
  "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"
  ]
}

GET/servers/countriescopy URL

Countries with online servers, with counts

Every country (ISO 3166-1 alpha-2) that currently hosts at least one online server - the values accepted by the `country` filter of `/servers` and `/servers/top` - with `name`, the number of online `servers` and their summed `players`, most servers first, and the country hub page `url`. Cached for five minutes.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/countries"

Example response

{
  "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"
  ]
}

GET/servers/monument-typescopy URL

Monument names and families on the servers' drawn maps

Every monument name (e.g. `Launch Site`, `Large Oilrig`, `Military Base A`) and family (`Oil Rig`, `Military Base`) found on the maps the online servers run now - drawn from each server's own map file - alphabetical: the values accepted by the `monument` / `count_of` filters of `/servers` and `/maps/servers`. Grows on its own as more maps are drawn. Cached for 15 minutes.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/monument-types"

Example response

{
  "total": 101,
  "results": [
    "3 Wall Rock",
    "Airfield",
    "Anvil Rock",
    "… 98 more"
  ]
}

GET/servers/{server_id}copy URL

One server in full

Everything the server's page shows except the live player names: the full public record (see `/servers`) read fresh, plus `votes`, `rating` (1-5 average) and `rating_count`, the last ten detected `wipes` (newest first, with the seed/size before and after), `last_wipe_at`, `avg_wipe_cycle_hours` across those wipes, `next_wipe_estimate_at` (last wipe + average cycle; a guess, not a schedule), `next_force_wipe_at` (Rust's monthly forced wipe) and `map_preview` - the server's map drawn from the server's own map file (or generated from its seed + size), null until one is drawn: `image_url` (labelled, 1440 px), `thumbnail_url` (480 px), `images`, `total_monuments`, `monuments` (`{type, x, y}`), `monument_types`, `land_percentage`, the five `biome_*` percentages, `source_note`, `generated_at` and `is_previous_wipe` (true while a wiped server's new map is still being drawn - see `/servers/{id}/map`). Offline servers still resolve; unknown ids are 404. Player-count history is at `/servers/{id}/history`. Aggregates are cached for five minutes.

ParameterInTypeDefaultDescription
server_id requiredpathintegerThe server's numeric id (from `/servers`, or the number in its servers.rustprofit.com/server/{id} URL). (min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/1"

Example response

{
  "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"
}

GET/servers/{server_id}/historycopy URL

Player-count history for one server

The per-poll `player_count`/`queued_count` readings behind the server page's 24-hour chart, oldest first, as `points` of `{t, players, queued}`. One reading lands per poll cycle (roughly hourly); when the window holds more than 500 readings they are averaged into equal time buckets (`resolution_seconds`, null when the points are raw) so a response never exceeds 500 points. Also `peak_players`, `avg_players` and `point_count`. A server that has never answered a poll has an empty series. Cached for five minutes.

ParameterInTypeDefaultDescription
server_id requiredpathintegerThe server's numeric id. (min 1)
daysqueryinteger1How 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. (max 30, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/1/history"

Example response

{
  "server_id": 1,
  "days": 7,
  "resolution_seconds": null,
  "point_count": 0,
  "sample_count": 0,
  "peak_players": null,
  "avg_players": null,
  "points": []
}

GET/servers/{server_id}/votescopy URL

Community vote counts per day for one server

How many Steam-authenticated votes the server received on each UTC day (`daily` as `{date, votes}`, oldest first, days with no votes included as zero), plus `votes_in_range` and the all-time `total_votes`. Votes are one per user per server per day; who cast them is never exposed. Ratings are a separate 1-5 score, see `rating`/`rating_count` on `/servers/{id}`. Cached for five minutes.

ParameterInTypeDefaultDescription
server_id requiredpathintegerThe server's numeric id. (min 1)
daysqueryinteger30How many UTC days back to return (1-365), today included. (max 365, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/1/votes"

Example response

{
  "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"
  ]
}

GET/servers/{server_id}/mapcopy URL

A server's map: images, monuments, biomes

The map the server runs, drawn from the server's own map file (or generated from its seed + size): `current` = `{map_key, source, source_note, map_file_url, world_seed, world_size, map_size, image_url, images: {labelled: {480, 960, 1440}, plain: {2000}}, total_monuments, monuments: [{name, type, x, y}], monument_types, land_percentage, biomes: {snow, desert, forest, tundra, jungle}, drawn_at}`. Monument coordinates are world metres with the map centre at 0,0 (+y = north); `type` is `major` or a minor kind (cave, tunnel, power, rock, ice, well, nature). After a wipe `current` is null until the new map is drawn (`current_job` says how far it is) and `previous` holds the last drawn map; `status` is `drawn`, `pending`, `failed` or `none` (nothing to draw from: no map file and no seed). Cached for a minute.

ParameterInTypeDefaultDescription
server_id requiredpathintegerThe server's numeric id (from `/servers`). (min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/1/map"

Example response

{
  "server_id": 308,
  "server_name": "Bestrust Solo/Duo 2x | JUST FULLWIPED 15.11 11/15",
  "status": "drawn",
  "map_file_url": "https://files.facepunch.com/rust/maps/3d8e6e03482933b2e0382f785bfc4b028127f8f3845d800c0f879603d376cefc/4e6c191h0b5v6p3x6q.4101.1788604020096.290_3d8e6e03482933b…",
  "current": {
    "map_key": "b3e0ff62c85fffca84c7d88998585ec1",
    "source": "map_file",
    "source_note": "Map drawn from the server's own map file",
    "…": "13 more keys"
  },
  "current_job": null,
  "previous": null,
  "showing": "current"
}

GET/maps/serverscopy URL

Find servers by their map: monuments, counts, size, biomes, land

Online servers whose CURRENT map (drawn from the server's own map file) matches every filter given - e.g. `monument=Launch Site&monument=Oil Rig&share_biome=snow&share_min=25&size_max=4000`. Each result: `id`, `name`, `url` (the server page), `connect`, `players`, `max_players`, `country`, and `map` (`map_key`, `map_size`, `image_url` 480 px, `land_percentage`, `biomes`, `monument_counts`). Servers whose map isn't drawn yet never match. Same filters as `/servers` and the servers.rustprofit.com list. Cached for five minutes.

ParameterInTypeDefaultDescription
monumentquerystring[]Monument name or family the map must have (`Launch Site`, `Oil Rig`, `Military Base` - see `/servers/monument-types`). Repeat for AND, up to 5.
count_ofquerystringWith count_min/count_max: how many of this monument (name or family).
count_minqueryintegerAt least this many `count_of` (default 1).
count_maxqueryintegerAt most this many `count_of`.
size_minqueryintegerMap size at least (metres).
size_maxqueryintegerMap size at most (metres).
biomequeryone of `snow`, `desert`, `forest`, `tundra`, `jungle`The map's dominant biome.
share_biomequeryone of `snow`, `desert`, `forest`, `tundra`, `jungle`With share_min: this biome covers at least share_min% of the land.
share_minqueryintegerMinimum % of land in share_biome.
land_minqueryintegerLand at least this % of the map.
land_maxqueryintegerLand at most this % of the map.
map_kindqueryone of `procedural`, `custom``procedural` or `custom` maps.
countryquerystringISO country code of the server.
min_playersqueryintegerAt least this many players online now.
sortqueryone of `players`, `size`, `land`players`players` (default), `size` (largest map first) or `land`.
include_hiddenquerybooleanFalseInclude servers that Rust's in-game server browser doesn't show (`hidden_in_game: true`); left out by default, like the site's list.
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/maps/servers"

Example response

{
  "page": 1,
  "per_page": 50,
  "total": 148,
  "pages": 3,
  "results": [
    {
      "id": 483,
      "name": "Rusty Moose |EU Monthly|",
      "url": "https://servers.rustprofit.com/server/483",
      "connect": "steam://connect/205.178.168.205:28010",
      "players": 972,
      "max_players": 1000,
      "country": "GB",
      "map": {
        "map_key": "e728ce6e176b6bb172110cb4bf173365",
        "map_size": 4500,
        "image_url": "https://servers.rustprofit.com/mapimg/e7/e728ce6e176b6bb172110cb4bf173365/26845e3d14ea/labels_480.webp",
        "land_percentage": 58.7,
        "biomes": {
          "snow": 25.14,
          "desert": 27.13,
          "forest": 22.86,
          "tundra": 14.15,
          "jungle": 10.72
        },
        "monument_counts": {
          "Cave": 10,
          "Lake": 2,
          "Ruin": 5,
          "…": "98 more keys"
        }
      }
    },
    {
      "id": 8748,
      "name": "WARBANDITS.GG 2X |Solo/Duo/Trio|X2 JUST FULLWIPED",
      "url": "https://servers.rustprofit.com/server/8748",
      "connect": "steam://connect/216.39.240.4:28010",
      "players": 648,
      "max_players": 675,
      "country": "US",
      "map": {
        "map_key": "b27d39837af425ef199444548cd4ce51",
        "map_size": 4500,
        "image_url": "https://servers.rustprofit.com/mapimg/b2/b27d39837af425ef199444548cd4ce51/fa4a59a9fc60/labels_480.webp",
        "land_percentage": 60.2,
        "biomes": {
          "snow": 30.16,
          "desert": 16.39,
          "forest": 25.74,
          "tundra": 15.09,
          "jungle": 12.62
        },
        "monument_counts": {
          "Cave": 9,
          "Lake": 2,
          "Ruin": 4,
          "…": "94 more keys"
        }
      }
    },
    "… 47 more"
  ]
}

GET/maps/lookupcopy URL

Find a drawn map by seed + size, map-file URL, map key or server address

Returns the job view `{job_id, status, source, url, seed, size, requested_at, error, map}` where `map` is the full map (as in `/servers/{id}/map`, with monuments) once drawn. A seed + size lookup also finds a map drawn from a procedural server's own file. 404 when nothing is known yet - ask for it with `POST /maps`. With `address` the answer is the server's view (as `/servers/{id}/map`).

ParameterInTypeDefaultDescription
seedqueryintegerProcedural seed (with `size`).
sizequeryintegerMap size in metres (with `seed`).
urlquerystringA.map file URL exactly as a server publishes it.
keyquerystringA map key / job id (32 hex characters; the URL hash).
addressquerystringA server address `ip:port` (game or query port).
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/maps/lookup"

Example response

{
  "job_id": "2d208e15a2a2ef3ee28ab6b06f3fcbf9",
  "status": "done",
  "source": "generated",
  "url": null,
  "seed": "3500707",
  "size": 3500,
  "requested_at": "2026-11-16T03:43:18.306553",
  "error": null,
  "next_attempt_at": null,
  "map": {
    "map_key": "2d208e15a2a2ef3ee28ab6b06f3fcbf9",
    "source": "generated",
    "source_note": "Map generated from the server's world seed and size",
    "…": "13 more keys"
  }
}

GET/maps/jobs/{job_id}copy URL

Status of a map drawing job

`status` is `queued`, `downloading` (map file), `generating` (our own game server building a procedural map - several minutes), `rendering`, `done` or `failed` (`error` says why; failed downloads are retried after 6 h, 24 h, then weekly - `next_attempt_at`). When done, `map` carries the image URLs and summary.

ParameterInTypeDefaultDescription
job_id requiredpathstringThe job id `POST /maps` returned (the map key). (min length 32, max length 32)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/maps/jobs/JOB_ID"

Example response

{
  "job_id": "b3e0ff62c85fffca84c7d88998585ec1",
  "status": "done",
  "source": "map_file",
  "url": "https://files.facepunch.com/rust/maps/3d8e6e03482933b2e0382f785bfc4b028127f8f3845d800c0f879603d376cefc/4e6c191h0b5v6p3x6q.4101.1788604020096.290_3d8e6e03482933b…",
  "seed": null,
  "size": null,
  "requested_at": "2026-11-16T03:43:18.306553",
  "error": null,
  "next_attempt_at": null,
  "map": {
    "map_key": "b3e0ff62c85fffca84c7d88998585ec1",
    "source": "map_file",
    "source_note": "Map drawn from the server's own map file",
    "…": "12 more keys"
  }
}

POST/mapscopy URL

Ask for a map to be drawn (asynchronous)

Draws a Rust map from a public `.map` file URL, or generates one from a procedural `seed` + `size` with our own Rust server. **Asynchronous**: answers 202 `{job_id, status: "queued",...}` (header `Location` = the job URL) - poll `GET /maps/jobs/{job_id}` every 10-30 s. A file download + drawing usually finishes in under a minute when the queue is quiet; a seed generation takes 6-10 minutes. Requests queue behind the maps the servers site needs. A map that is already drawn answers 200 straight away, and asking again for a map that is still in progress returns the same job - neither uses quota. Quota for new jobs: 50 downloads + 3 generations per key per UTC day (keyless MCP clients: a small shared download budget, no generations). 422 for an invalid request (https only, public hosts only, size 1000-6000, 32-bit seed); the size cap (400 MB) and the map-file check happen while downloading and show up as a `failed` job.

curl -X POST -H "X-API-Key: rw_live_YOUR_KEY" -H "Content-Type: application/json" -d '{"url": "https://files.facepunch.com/rust/maps/example.map"}' "https://rust.wiki/api/v1/maps"

Example response

{
  "job_id": "b3e0ff62c85fffca84c7d88998585ec1",
  "status": "done",
  "source": "map_file",
  "url": "https://files.facepunch.com/rust/maps/3d8e6e03482933b2e0382f785bfc4b028127f8f3845d800c0f879603d376cefc/4e6c191h0b5v6p3x6q.4101.1788604020096.290_3d8e6e03482933b…",
  "seed": null,
  "size": null,
  "requested_at": "2026-11-16T03:43:18.306553",
  "error": null,
  "next_attempt_at": null,
  "map": {
    "map_key": "b3e0ff62c85fffca84c7d88998585ec1",
    "source": "map_file",
    "source_note": "Map drawn from the server's own map file",
    "…": "12 more keys"
  },
  "created": false
}

GET/servers/config/convarscopy URL

Search every Rust server ConVar (config builder)

Every ConVar of the current Rust dedicated server build, as on servers.rustprofit.com/config-builder. Each row: `name`, `type` (bool/int/float/string), `default` (null = set at runtime), `min`/`max` (the range Rust clamps to), `category`, `help` (the game's own help text), `note` (our explanation, essential settings only), `essential`, `published_in` (where the outside world sees it, null when it isn't published), `goes_on` (`command line` or `server.cfg`), `danger` (why changing it can break a public server), `secret` (a credential the builder never writes) and `flags`. Alphabetical; essential settings in page order when `essential=true`.

ParameterInTypeDefaultDescription
qquerystringWords to find in the ConVar name, the game's help text or our note.
categoryquerystringOnly one config-builder category (key from `/servers/config/presets`), e.g. `decay`, `upkeep`, `gather`, `map`.
essentialquerybooleanFalse`true` = only the essential settings the page shows first, with our longer notes.
publishedqueryboolean`true` = only settings the server publishes to the server browser (A2S); `false` = only unpublished ones.
pagequeryinteger11-based page number. (min 1)
per_pagequeryinteger50Results per page (max 200). (max 200, min 1)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/config/convars"

Example response

{
  "page": 1,
  "per_page": 3,
  "total": 91,
  "pages": 31,
  "results": [
    {
      "name": "basesiegeweapon.outsidedecayminutes",
      "type": "float",
      "default": "600",
      "min": null,
      "max": null,
      "category": "vehicles",
      "category_label": "Vehicles & boats",
      "help": "How many minutes before a siege weapon loses all its health while outside",
      "note": null,
      "essential": false,
      "published_in": null,
      "goes_on": "server.cfg",
      "danger": null,
      "secret": false,
      "flags": []
    },
    {
      "name": "basesubmarine.deepwaterdecayminutes",
      "type": "float",
      "default": "120",
      "min": null,
      "max": null,
      "category": "vehicles",
      "category_label": "Vehicles & boats",
      "help": "How long before a submarine loses all its health while in deep water",
      "note": null,
      "essential": false,
      "published_in": null,
      "goes_on": "server.cfg",
      "danger": null,
      "secret": false,
      "flags": []
    },
    "…"
  ],
  "build": "26498655",
  "convar_count": 1686,
  "page_url": "https://servers.rustprofit.com/config-builder"
}

GET/servers/config/convars/{name}copy URL

One Rust server ConVar in full

Everything `/servers/config/convars` returns for one ConVar, plus `game_mode_values` (the value each of Rust's own game modes sets it to at startup, when it does) and `fixed_by_game_mode` (true when any game mode decides it from the mode prefab, so server.cfg can't change it while a mode is set).

ParameterInTypeDefaultDescription
name requiredpathstringThe ConVar, e.g. `decay.scale` or `server.worldsize`. (min length 3, max length 80, pattern ^[A-Za-z0-9_.]+$)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/config/convars/decay.scale"

Example response

{
  "build": "26498655",
  "name": "decay.scale",
  "type": "float",
  "default": "1",
  "min": null,
  "max": null,
  "category": "decay",
  "category_label": "Decay",
  "help": "Multiplier applied to all decay damage per tick; 1.0 = normal, 2.0 = double decay rate, 0.0 = no decay",
  "note": "Multiplies all decay damage: 0 turns decay off, 0.5 halves it, 2 doubles it.",
  "essential": true,
  "published_in": null,
  "goes_on": "server.cfg",
  "danger": null,
  "secret": false,
  "flags": [],
  "game_mode_values": {},
  "fixed_by_game_mode": false,
  "page": "https://servers.rustprofit.com/config-builder"
}

GET/servers/config/presetscopy URL

Config builder presets, game modes, categories and tag rules

The reference data behind the builder: `presets` (`key`, `label`, `about`, `values` - the settings each one applies on top of Rust's defaults), `game_modes` (Rust's own modes: `title`, `team_system`, the ConVars each mode sets at startup in `convars`, and what it `added`/`removed` in words), `categories` (key, label, about), `startup` (settings that belong on the command line - `server.identity` must), `mode_fixed` (settings a game mode decides), `dangerous` (settings that break a public server, with why), `tag_groups` + `tag_limit` (the only server.tags Rust keeps: one per group, at most `tag_limit` groups) and `vanilla_tag_modes` (game modes that keep the vanilla tag).

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/config/presets"

Example response

{
  "build": "26498655",
  "convar_count": 1686,
  "published_count": 20,
  "presets": [
    {
      "key": "vanilla",
      "label": "Vanilla",
      "values": {
        "server.tags": "vanilla"
      },
      "about": "Rust's defaults, tagged vanilla. Nothing that changes gameplay."
    },
    {
      "key": "pve",
      "label": "PvE-friendly",
      "values": {
        "server.pve": "true",
        "decay.scale": "0.5",
        "decay.upkeep_period_minutes": "2880",
        "server.itemdespawn": "600",
        "server.corpsedespawn": "600"
      },
      "about": "Rust's own PvE mode (players can't hurt each other; Rust adds the pve tag), half decay, half upkeep cost, and dropped items and corpses that last 10 minutes instead of 5."
    },
    "…"
  ],
  "game_modes": {
    "deathmatch": {
      "title": "Deathmatch",
      "team_system": true,
      "convars": {},
      "added": [],
      "removed": []
    },
    "hardcore": {
      "title": "Hardcore",
      "team_system": false,
      "convars": {
        "clan.enabled": "0",
        "decay.bracket_0_costfraction": "0.1",
        "decay.bracket_1_costfraction": "0.15",
        "decay.bracket_2_costfraction": "0.25",
        "decay.bracket_3_costfraction": "0.4",
        "server.hardcorefirearmammunitioncraftingmultiplier": "5",
        "server.npcammolootmultiplier": "0.5",
        "server.pvebulletdamagemultiplier": "1.5",
        "server.respawntimeadditionbag": "600",
        "server.respawntimeadditionbed": "480",
        "sleepingbag.useteamlabels": "false"
      },
      "added": [
        "Fog of war on map"
      ],
      "removed": [
        "Crawling when wounded",
        "Team system",
        "…"
      ]
    },
    "koth_solo": {
      "title": "King of the Hill",
      "team_system": true,
      "convars": {},
      "added": [],
      "removed": []
    },
    "koth_team": {
      "title": "Team KOTH",
      "team_system": true,
      "convars": {},
      "added": [],
      "removed": []
    },
    "onedeath": {
      "title": "oNe dEaTh",
      "team_system": true,
      "convars": {},
      "added": [],
      "removed": []
    },
    "primitive": {
      "title": "Primitive",
      "team_system": true,
      "convars": {
        "ai.scientist_spawners_enabled": "false",
        "decay.upgrade_hqm_enabled": "false",
        "decay.upgrade_metal_enabled": "false",
        "npc.vendor_attack_heli_enabled": "false",
        "npc.vendor_minicopter_enabled": "false",
        "npc.vendor_scrap_heli_enabled": "false",
        "ridablehorse.population": "4",
        "server.era": "primitive"
      },
      "added": [
        "Increased Wild Horse Spawns (2x)"
      ],
      "removed": [
        "Restricted To Bows & Melee Weapons",
        "Reduced Sulfur Node Spawns By 50%",
        "…"
      ]
    },
    "softcore": {
      "title": "Softcore",
      "team_system": true,
      "convars": {
        "clan.enabled": "false",
        "decay.use_door_upkeep_brackets": "true",
        "player.dropbackpackondowned": "false",
        "player.keepteaondeath": "true",
        "relationshipmanager.maxteamsize": "4",
        "server.max_tool_cupboards": "6",
        "server.pvpbulletdamagemultiplier": "0.75",
        "storagecontainer.canrequireauthifnolock": "false",
        "storagecontainer.dropcorpseondeath": "false"
      },
      "added": [
        "Can only raid other players within a set time window",
        "Can respawn at Outpost and Bandit Camp"
      ],
      "removed": [
        "Clan system and Clan Tables"
      ]
    },
    "teamdm": {
      "title": "TEAM DM",
      "team_system": true,
      "convars": {},
      "added": [],
      "removed": []
    },
    "vanilla": {
      "title": "Vanilla",
      "team_system": true,
      "convars": {},
      "added": [],
      "removed": []
    },
    "weapontest": {
      "title": "WeaponTest",
      "team_system": true,
      "convars": {},
      "added": [],
      "removed": []
    }
  },
  "categories": [
    {
      "key": "server",
      "label": "Server & listing",
      "about": "Name, description, images, tags and slots: what players see in the server browser."
    },
    {
      "key": "map",
      "label": "World & map",
      "about": "Map generation, custom maps and the in-game map."
    },
    "…"
  ],
  "startup": [
    "server.identity",
    "server.ip",
    "…"
  ],
  "mode_fixed": [
    "server.mapenabled",
    "server.hideplayeronmap",
    "…"
  ],
  "dangerous": {
    "server.encryption": "Lowering encryption exposes player traffic. Keep 2 on a public server.",
    "server.anticheattoken": "Turning this off lets players join without a valid Easy Anti-Cheat token.",
    "server.official": "Marks the server as an official Facepunch server. Only Facepunch sets this.",
    "server.strictauth_eac": "Kicks every player when EAC authentication is unavailable.",
    "server.strictauth_steam": "Kicks every player when Steam authentication is unavailable.",
    "antihack.enforcementlevel": "0 stops the anti-hack from kicking players who break its movement and combat checks.",
    "server.identity": "Changing the identity points the server at a different folder: a fresh map, no bans, no users."
  },
  "tag_groups": [
    [
      "monthly",
      "biweekly",
      "…"
    ],
    [
      "vanilla",
      "hardcore",
      "…"
    ],
    "…"
  ],
  "tag_limit": 4,
  "vanilla_tag_modes": [
    "rust",
    "vanilla"
  ],
  "page": "https://servers.rustprofit.com/config-builder"
}

GET/servers/config/buildcopy URL

Build a Rust server.cfg and start command from settings

What the config builder page produces for the same choices: `server_cfg` (only settings that differ from Rust's defaults, grouped by category, game mode and PvE first), `server_cfg_path` (where it goes), `start_args` plus ready-made `start_sh` / `start_bat` start scripts (identity, ports and world settings - the command line wins over server.cfg), `warnings` (`level` info/warn/danger: tags Rust drops, settings a game mode overrides, values outside Rust's range, settings with no effect...), `changed` (every setting that differs from the default) and `ignored` (names that aren't ConVars, credentials, bad values). Secrets are never written: the RCON password in the start command is the placeholder `changeme`. Pure computation, nothing stored; the same build of Rust as `/servers/config/convars`.

ParameterInTypeDefaultDescription
presetquerystringStart from a preset (key from `/servers/config/presets`: `vanilla`, `pve`, `weekend`, `softcore`, `hardcore`, `primitive`, `trio`). Your `set` values apply on top.
setquerystring[]Settings as `convar=value`, repeatable (up to 100): `set=server.hostname=My Server&set=server.maxplayers=150&set=decay.scale=0.5`. Booleans take true/false.
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/servers/config/build"

Example response

{
  "build": "26498655",
  "preset": "pve",
  "game_mode": null,
  "changed": {
    "decay.scale": "0.5",
    "decay.upkeep_period_minutes": "2880",
    "server.corpsedespawn": "600",
    "server.hostname": "EU Weekly Vanilla",
    "server.itemdespawn": "600",
    "server.maxplayers": "150",
    "server.pve": "true",
    "server.worldsize": "3500"
  },
  "changed_count": 8,
  "ignored": [],
  "server_cfg": "# server.cfg for Rust build 26498655 - servers.rustprofit.com/config-builder\n# Goes in server/my_server_identity/cfg/server.cfg\n# Only settings that differ from Rust's defaults. The start\n# command line wins over anything set here.\n\n# Game mode and PvE (first: the rest depends on them)\nserver.pve true\n\n# Server & listing\nserver.hostname \"EU Weekly Vanilla\"\nserver.maxplayers 150\n\n# Decay\ndecay.scal…",
  "server_cfg_path": "server/my_server_identity/cfg/server.cfg",
  "start_args": [
    "+server.identity \"my_server_identity\"",
    "+server.port 28015",
    "…"
  ],
  "start_sh": "#!/bin/sh\n# Replace changeme with a long random RCON password: Rust keeps RCON off while it is changeme.\n./RustDedicated -batchmode -nographics \\\n  +server.identity \"my_server_identity\" \\\n  +server.port 28015 \\\n  +rcon.web true \\\n  +rcon.password \"changeme\" \\\n  +server.seed 1337 \\\n  +server.worldsize 3500\n",
  "start_bat": "@echo off\nrem Replace changeme with a long random RCON password: Rust keeps RCON off while it is changeme.\nRustDedicated.exe -batchmode -nographics ^\n  +server.identity \"my_server_identity\" ^\n  +server.port 28015 ^\n  +rcon.web true ^\n  +rcon.password \"changeme\" ^\n  +server.seed 1337 ^\n  +server.worldsize 3500\n",
  "warnings": [
    {
      "level": "info",
      "text": "server.seed is the default 1337, the same map as every other server that never changed it."
    }
  ],
  "notes": [
    "The command line wins over server.cfg: each setting goes in only one of them.",
    "rcon.password is read from the command line only; replace changeme - Rust keeps RCON off while it is changeme."
  ],
  "page": "https://servers.rustprofit.com/config-builder"
}

Network status

category status · 10,000 requests/day

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.

GET/status/datacopy URL

When each dataset last changed and how often it refreshes

The quota-saver: for every dataset the API serves, `updated_at` (the newest timestamp actually in the table, UTC) and `refresh_seconds` (how often it can change), with the endpoints it feeds. Poll this cheap endpoint and only re-fetch a heavy payload such as /market/prices or /servers when its dataset's `updated_at` has moved; cache reference data (items, monuments,...) locally since it only changes with Facepunch's monthly patch. Timestamps are read live from the database and cached for 60 seconds.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/status/data"

Example response

{
  "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"
  ]
}

GET/statuscopy URL

Network status: every site and its workers at a glance

One call for the whole network: each site's HTTPS probe (`ok`, HTTP status, latency, cached 60s) and a count of its background workers by health, plus an overall `all_ok`. Use /status/workers for per-worker detail.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/status"

Example response

{
  "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"
  ]
}

GET/status/sitescopy URL

Probes rustprofit.com, rust.wiki, servers.rustprofit.com, rust.wiki/inventory and blog.rustprofit.com from the web tier and reports `ok`, `http_status` and `latency_ms` for each. Results are shared across callers and refreshed at most once a minute.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/status/sites"

Example response

{
  "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"
  ]
}

GET/status/workerscopy URL

Background worker heartbeats, grouped by site

Every public background worker with `status` (ok / stale / unknown), `last_seen` (UTC), `seconds_ago` and its `expected_interval` - the cadence past which it counts as stale. Grouped by the site whose data it keeps fresh: game loops, trade bots and payouts for the casino; price, marketplace, store, workshop and news pollers for the wiki; discovery and polling for the server directory; the inventory backfill and leaderboard warmer.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/status/workers"

Example response

{
  "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": []
    }
  }
}

Paper funds

category funds · 5,000 requests/day

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.

GET/funds/leaderboardcopy URL

Public funds ranked by total value

All public funds that have traded at least once, ranked by current total value (cash + holdings at live wiki prices). `starting_cash` is the $1,000 every fund begins with. Cached for 120 seconds.

curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/funds/leaderboard"

Example response

{
  "starting_cash": 100000,
  "funds": [],
  "rules": {
    "starting_cash": 100000,
    "sell_fee_bps": 500
  }
}

GET/funds/{steamid}copy URL

One public fund with positions and full trade ledger

Cash, holdings value, total value, P&L, every open position with average cost, the complete trade history (newest first) and the daily value series. Private funds return 403.

ParameterInTypeDefaultDescription
steamid requiredpathstringSteamID64 of the fund owner. (pattern ^\d{17}$)
curl -H "X-API-Key: rw_live_YOUR_KEY" "https://rust.wiki/api/v1/funds/76561198869732295"

For AI agents and LLM tools

MCP server: https://rust.wiki/mcp exposes the core of this API as Model Context Protocol tools, so Claude, ChatGPT, Cursor and other assistants can query skins, prices, items, the item store, reference data and servers directly. It needs no key (keyless clients share a quota; send X-API-Key for your own). Setup for each client.

This reference is also published in machine-friendly forms generated from the same source as this page, so they never drift:

  • /llms.txt: a short index of the site and API per the llms.txt convention; /llms-full.txt is the index plus the whole reference in one file.
  • /docs.md: this entire reference as Markdown, including example responses for every endpoint.
  • /openapi.json: OpenAPI 3.1 with parameter schemas, example responses and the quota table under x-quotas. Point any OpenAPI-aware tool or agent framework at it.

Calling the JSON API directly still needs an API key: a human creates one at /api-keys and gives it to the agent. Each key's daily usage per category is shown there. The MCP server is the keyless route.

The rust.wiki API is a free JSON API for Rust game data: every item with recipes and recycle yields, every skin with live Steam prices, sale history and order books, third-party marketplace prices and deals, the market index and market cap, the current and past item store, the Steam Workshop, monuments, loot tables, server commands, CCTV codes, building and world data, the tech tree, calculators, Facepunch updates, the Rust server directory, Rust player stats from the official Steam Web API, Steam inventory valuations, rustprofit.com casino rounds with provably-fair data, PNG charts, network status and the paper-trading funds leaderboard. Sign in with Steam to create a key; it costs nothing and every category has a generous daily quota.

Frequently Asked Questions

What is the base URL of the Rust API?

https://rust.wiki/api/v1 - every endpoint on this page is relative to it, and all responses are JSON except the chart endpoints, which return PNG images.

Is there a rate limit?

Only generous daily quotas per category (for example 25,000 requests a day for skins) and a burst limit of 300 requests a minute per key. GET /me shows what your key has used and has left today, and it is never counted.

Does the API support CORS so I can call it from a browser?

Yes - cross-origin GET requests with the X-API-Key header are allowed, so a static web page can call it directly. Keep in mind that a key embedded in public JavaScript is visible to anyone who views the source.

How fresh are the prices?

Steam order books are polled continuously (about every 12 minutes per skin), third-party marketplaces every few minutes, and the bulk price endpoints are regenerated at most every 5 minutes. Polling faster than that only spends quota.

Is the Rust API free?

Yes. Create a key at rust.wiki/api-keys after signing in with Steam. Every key gets thousands of requests per day in each category, and the only condition is a visible link back to rust.wiki from whatever you build.

Where do the Rust skin prices come from?

Steam Community Market order books (lowest sell order, falling back to highest buy order) polled continuously, plus a dozen third-party marketplaces polled every few minutes. All prices are USD cents.

Can I get Rust player stats through the API?

Yes - /api/v1/players/{steamid} returns profile, bans, playtime, every Rust stat Steam exposes and all achievements, as long as the profile's game details are public.

Is there an OpenAPI schema or something for AI agents?

Yes: rust.wiki/mcp is an MCP server AI assistants can add directly, with no key needed. For agent frameworks, /openapi.json is OpenAPI 3.1 with example responses, /docs.md is the full reference as Markdown and /llms.txt is an llms.txt index. All of them are generated from the same definitions as this page.

What happens when I hit the quota?

You get HTTP 429 with a Retry-After header; the daily quota resets at 00:00 UTC. Every response also carries X-RateLimit-Remaining so you can pace yourself. Ask on the support page if you need more.