Skip to content

Quickstart

The JavaScript and Python examples use this helper. It returns the response’s data and throws on an error. On a 429 it waits Retry-After seconds (60 if missing) and retries, up to three times. The JavaScript version also retries a network error after 10 seconds: in a browser, that is how the edge burst limit arrives.

const API = 'https://truefloat.app/api/v1';
const EDGE_BLOCK_RETRY_MS = 10_000; // the edge burst-limit block lasts 10s
const MAX_RETRIES = 3;
async function get(path) {
for (let attempt = 0; ; attempt++) {
let res;
try {
res = await fetch(API + path);
} catch (err) {
// In a browser, the edge burst-limit block arrives as a network
// error (it has no CORS headers). Retry it like a 429.
if (err instanceof TypeError && attempt < MAX_RETRIES) {
await new Promise((resolve) => setTimeout(resolve, EDGE_BLOCK_RETRY_MS));
continue;
}
throw err;
}
if (res.status === 429 && attempt < MAX_RETRIES) {
const wait = Number(res.headers.get('Retry-After')) || 60;
await new Promise((resolve) => setTimeout(resolve, wait * 1000));
continue;
}
const body = await res.json().catch(() => null);
if (!res.ok) {
const error = body?.error ?? { code: 'http_error', message: res.statusText };
throw new Error(`${res.status} ${error.code}: ${error.message}`);
}
return body.data;
}
}
  1. GET /v1/items/{def_index}/{paint_index} returns the item and a menu of the guides that cover it: authors, titles, and each system’s id, label, alias, topic, side and scale. No seeds.

    curl https://truefloat.app/api/v1/items/7/44
    {
    "dataset_version": "e9c25a6",
    "data": {
    "item": {
    "def_index": 7,
    "paint_index": 44,
    "slug": "ak47-case-hardened",
    "weapon": "AK-47",
    "finish": "Case Hardened",
    "paint_label": "Case Hardened"
    },
    "guides": [
    {
    "steam_id": "2941982575",
    "title": "AK-47 Case Hardened | Blue Gem",
    "authors": ["korenevskiy"],
    "url": "https://steamcommunity.com/sharedfiles/filedetails/?id=2941982575",
    "permission": "unknown",
    "updated": "2026-03-01T13:29:00",
    "systems": [
    {
    "id": "ak47-blue-gem",
    "label": "AK-47 Blue Gem",
    "alias": null,
    "topic": "blue-gem",
    "side": null,
    "kind": "tier",
    "levels": 4,
    "seeds": 97
    }
    ]
    },
    {
    "steam_id": "3313951742",
    "title": "The Complete Gold Gem Patterns Guide",
    "authors": ["korenevskiy"],
    "url": "https://steamcommunity.com/sharedfiles/filedetails/?id=3313951742",
    "permission": "unknown",
    "updated": "2026-06-19T17:01:00",
    "systems": [
    {
    "id": "ak47-gold-gem",
    "label": "Gold Gem Patterns",
    "alias": null,
    "topic": "gold-gem",
    "side": null,
    "kind": "group",
    "levels": 1,
    "seeds": 4
    }
    ]
    }
    ]
    }
    }
  2. GET /v1/items/{def}/{paint}/seeds/{seed} returns every guide’s verdict on one seed. not_listed names the item’s systems that don’t list it.

    curl https://truefloat.app/api/v1/items/7/44/seeds/387

    Show v.guide.authors and v.guide.url next to every verdict you render. See Attribution.

  3. GET /v1/items/{def}/{paint}/patterns returns every graded seed of the item in one response, with guide and system details given once. Look up each listing’s seed in it locally.

    curl https://truefloat.app/api/v1/items/7/44/patterns

    On a listings page, make one /patterns call per item, not one per listing. For a local copy of the whole dataset, use /v1/dump.