Skip to content

Addressing items

(def_index, paint_index) is an item’s canonical key, and the only unique one. Slugs and market hash names are aliases: GET /v1/resolve turns them into one or more canonical pairs.

A slug can cover several paint indexes. karambit-doppler is Ruby (415), Sapphire (416), Black Pearl (417) and four phases: one slug, seven items, each with its own guides.

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 pair whose paint_label you mean and call /v1/items/{def_index}/{paint_index} with it.

param in notes
slug query e.g. karambit-doppler
market_hash_name query e.g. ★ Karambit | Doppler (Factory New)

One of the two is required; with both, slug wins and market_hash_name is ignored. Each is at most 200 characters (longer is 422). With neither:

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.