Skip to content
TrueFloat API

Addressing items

(def_index, paint_index) is the canonical key for an item, and the only one that’s guaranteed unique. Slugs and market hash names are aliases that resolve to one or more canonical pairs — never a query key on their own.

Why a slug isn’t enough

Section titled “Why a slug isn’t enough”

A slug can cover several paint indexes. karambit-doppler is Ruby (415), Sapphire (416), Black Pearl (417), and four numbered phases — one slug, seven items, seven independent sets of guides.

Terminal window
curl 'https://truefloat.app/api/v1/resolve?slug=karambit-doppler'
{
  "dataset_version": "e9c25a6",
  "data": {
    "items": [
      {
        "def_index": 507,
        "paint_index": 415,
        "slug": "karambit-doppler",
        "weapon": "Karambit",
        "finish": "Doppler",
        "paint_label": "Ruby"
      },
      {
        "def_index": 507,
        "paint_index": 416,
        "slug": "karambit-doppler",
        "weapon": "Karambit",
        "finish": "Doppler",
        "paint_label": "Sapphire"
      },
      {
        "def_index": 507,
        "paint_index": 417,
        "slug": "karambit-doppler",
        "weapon": "Karambit",
        "finish": "Doppler",
        "paint_label": "Black Pearl"
      },
      {
        "def_index": 507,
        "paint_index": 418,
        "slug": "karambit-doppler",
        "weapon": "Karambit",
        "finish": "Doppler",
        "paint_label": "Phase 1"
      },
      {
        "def_index": 507,
        "paint_index": 419,
        "slug": "karambit-doppler",
        "weapon": "Karambit",
        "finish": "Doppler",
        "paint_label": "Phase 2"
      },
      {
        "def_index": 507,
        "paint_index": 420,
        "slug": "karambit-doppler",
        "weapon": "Karambit",
        "finish": "Doppler",
        "paint_label": "Phase 3"
      },
      {
        "def_index": 507,
        "paint_index": 421,
        "slug": "karambit-doppler",
        "weapon": "Karambit",
        "finish": "Doppler",
        "paint_label": "Phase 4"
      }
    ]
  }
}

Pick the (def_index, paint_index) pair with the paint_label you actually mean, then call /v1/items/{def_index}/{paint_index} with that pair.

GET /v1/resolve

Section titled “GET /v1/resolve”
param in notes
slug query e.g. karambit-doppler
market_hash_name query e.g. ★ Karambit | Doppler (Factory New)

At least one of the two is required; if both are sent, slug wins and market_hash_name is ignored. Each is at most 200 characters (longer is 422). With neither:

Terminal window
curl https://truefloat.app/api/v1/resolve
{
  "dataset_version": "e9c25a6",
  "error": {
    "code": "bad_request",
    "message": "slug or market_hash_name required"
  }
}

An alias that resolves to nothing is 404 not_found.