SkinGrind

Search and filter Counter-Strike 2 weapon skins by name, weapon, rarity, collection or case. Returns skin names, rarities, wear ranges and the cheapest current listing price in cents. Use get_skin_detail for a single skin with per-wear prices.

{
  "type": "object",
  "properties": {
    "search": {
      "description": "Free-text skin name search, for example \"Redline\". Used alone it also returns matching weapons; combined with any other argument it filters the paginated skin list instead.",
      "type": "string"
    },
    "weapon": {
      "description": "Weapon slug, for example \"ak-47\" or \"desert-eagle\".",
      "type": "string"
    },
    "rarity": {
      "description": "Rarity name, for example \"Covert\", \"Classified\", \"Restricted\", \"Mil-Spec Grade\".",
      "type": "string"
    },
    "collection": {
      "description": "Collection slug.",
      "type": "string"
    },
    "crate": {
      "description": "Case or capsule slug.",
      "type": "string"
    },
    "stattrak": {
      "description": "Only skins available as StatTrak.",
      "type": "boolean"
    },
    "souvenir": {
      "description": "Only skins available as Souvenir.",
      "type": "boolean"
    },
    "sort": {
      "description": "Result ordering. Defaults to name. \"popularity\" ranks by listing quantity.",
      "enum": [
        "name",
        "rarity",
        "price_asc",
        "price_desc",
        "popularity"
      ],
      "type": "string"
    },
    "per_page": {
      "description": "Results per page, 1 to 25. Defaults to 10.",
      "minimum": 1,
      "maximum": 25,
      "type": "integer"
    },
    "page": {
      "description": "Page number.",
      "minimum": 1,
      "maximum": 50,
      "type": "integer"
    }
  }
}

Get one Counter-Strike 2 skin with its float range, per-wear prices, collections and cases. Optionally includes the catalog Trade Up context: which rarity tier the skin sits in and what it can be traded up into.

{
  "type": "object",
  "properties": {
    "weapon_slug": {
      "description": "Weapon slug, for example \"ak-47\".",
      "type": "string"
    },
    "skin_slug": {
      "description": "Skin slug, for example \"redline\".",
      "type": "string"
    },
    "include_tradeup_context": {
      "description": "Include the catalog Trade Up context for this skin. This is contract math derived from the collection, not scanner output.",
      "type": "boolean"
    }
  },
  "required": [
    "weapon_slug",
    "skin_slug"
  ]
}

List Counter-Strike 2 collections, or get one collection with its contents. Optionally includes the collection Trade Up map: which rarity tiers exist in the collection and what each tier can produce. That map is catalog contract math, not scanner output.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Collection slug. When set, returns that collection with its contents instead of the list.",
      "type": "string"
    },
    "search": {
      "description": "Free-text collection name search.",
      "type": "string"
    },
    "type": {
      "description": "Filter the list by what the collection contains.",
      "enum": [
        "skin",
        "sticker",
        "charm",
        "agent"
      ],
      "type": "string"
    },
    "sort": {
      "description": "List ordering: newest, oldest or name. For a single collection the contents order: rarity, name, price_asc or price_desc.",
      "type": "string"
    },
    "per_page": {
      "description": "Results per page, 1 to 25.",
      "minimum": 1,
      "maximum": 25,
      "type": "integer"
    },
    "page": {
      "description": "Page number.",
      "minimum": 1,
      "maximum": 50,
      "type": "integer"
    },
    "include_tradeup_map": {
      "description": "Only with slug. Adds the collection Trade Up map showing each rarity tier and its possible outputs.",
      "type": "boolean"
    }
  }
}

List Counter-Strike 2 cases, capsules and souvenir packages, or get one container with its contents plus its drop odds and expected opening value. Odds use the standard CS2 tier weights and are renormalised over the tiers actually present.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Container slug. When set, returns that container with its contents and opening odds instead of the list.",
      "type": "string"
    },
    "search": {
      "description": "Free-text container name search.",
      "type": "string"
    },
    "type": {
      "description": "Filter the list by container type.",
      "enum": [
        "weapon_case",
        "souvenir_package",
        "autograph_capsule",
        "sticker_capsule",
        "graffiti_box",
        "sticker_collection"
      ],
      "type": "string"
    },
    "sort": {
      "description": "List ordering: newest, oldest or name. For a single container the contents order: rarity, name, price_asc or price_desc.",
      "type": "string"
    },
    "per_page": {
      "description": "Results per page, 1 to 25.",
      "minimum": 1,
      "maximum": 25,
      "type": "integer"
    },
    "page": {
      "description": "Page number.",
      "minimum": 1,
      "maximum": 50,
      "type": "integer"
    }
  }
}

Rank Counter-Strike 2 cases by expected return on opening. Each entry gives the case price, expected value, return in basis points and the chance of an opening being profitable, all computed from current listing prices plus the key price. Cases whose contents are not sufficiently priced are excluded.

{
  "type": "object",
  "properties": {}
}

List the current Counter-Strike 2 Armory rotation tiles with their credit cost and expected value, or get one tile with every item it can produce and the rarity weighting. Use this to compare what Armory credits are worth across the current rotation.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Armory tile slug. When set, returns that tile with its full item list instead of the rotation overview.",
      "type": "string"
    }
  }
}

Find cheap Counter-Strike 2 skins grouped into price-threshold pages, for example AK-47 skins under 10 dollars or the cheapest knives. Without a slug it lists every available page; with a slug it returns the skins on that page with their current cheapest listing price.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Bargain page slug, for example \"ak-47-skins-under-10-dollars\" or \"cheapest-knives\". Omit to list every available page.",
      "type": "string"
    }
  }
}

Search Counter-Strike 2 cosmetic items that are not weapon skins: stickers, charms, agents, patches, graffiti and music kits. Returns names and cheapest listing prices, or one item with its full detail including per-marketplace prices.

{
  "type": "object",
  "properties": {
    "category": {
      "description": "Which kind of cosmetic item to search.",
      "enum": [
        "stickers",
        "charms",
        "agents",
        "patches",
        "graffiti",
        "music-kits"
      ],
      "type": "string"
    },
    "slug": {
      "description": "Item slug. When set, returns that single item with full detail.",
      "type": "string"
    },
    "search": {
      "description": "Free-text item name search.",
      "type": "string"
    },
    "sort": {
      "description": "Result ordering. Defaults to name.",
      "enum": [
        "name",
        "price_asc",
        "price_desc"
      ],
      "type": "string"
    },
    "per_page": {
      "description": "Results per page, 1 to 25.",
      "minimum": 1,
      "maximum": 25,
      "type": "integer"
    },
    "page": {
      "description": "Page number.",
      "minimum": 1,
      "maximum": 50,
      "type": "integer"
    }
  },
  "required": [
    "category"
  ]
}

Get the free preview of the SkinGrind Trade Up scanner: the featured Trade Ups with their full recipes, the number of contracts currently active, and locked teasers for recent finds showing their economics and when they unlock. Every input has to be bought at or below its target float, and the costs are hourly price estimates, so the response carries execution_notes explaining what to verify before buying. Full recipes for the whole feed need a SkinGrind account and the authenticated server.

{
  "type": "object",
  "properties": {
    "type": {
      "description": "Which Trade Up feed to preview: \"profitable\" for contract Trade Ups, \"knife\" for knife and glove Trade Ups, or \"all\". Defaults to all.",
      "enum": [
        "profitable",
        "knife",
        "all"
      ],
      "type": "string"
    }
  }
}