Quickstart
Helper
Section titled “Helper”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 10sconst 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; }}import time
import requests
API = 'https://truefloat.app/api/v1'
def get(path): for attempt in range(4): res = requests.get(API + path, timeout=30) if res.status_code == 429 and attempt < 3: retry_after = res.headers.get('Retry-After', '') time.sleep(int(retry_after) if retry_after.isdigit() else 60) continue res.raise_for_status() return res.json()['data']-
Fetch an item and its guides
Section titled “Fetch an item and its guides”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/44const data = await get('/items/7/44');console.log(data.item.slug, data.guides.length, 'guides');data = get('/items/7/44')print(data['item']['slug'], len(data['guides']), 'guides'){"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}]}]}} -
Look up one seed
Section titled “Look up one seed”GET /v1/items/{def}/{paint}/seeds/{seed}returns every guide’s verdict on one seed.not_listednames the item’s systems that don’t list it.curl https://truefloat.app/api/v1/items/7/44/seeds/387const data = await get('/items/7/44/seeds/387');for (const v of data.verdicts) {console.log(v.guide.title, '→', v.level.label, `(${v.level.place} of ${v.level.of})`);}data = get('/items/7/44/seeds/387')for v in data['verdicts']:print(v['guide']['title'], '->', v['level']['label'],f"({v['level']['place']} of {v['level']['of']})")Show
v.guide.authorsandv.guide.urlnext to every verdict you render. See Attribution. -
Fetch every graded seed of an item
Section titled “Fetch every graded seed of an item”GET /v1/items/{def}/{paint}/patternsreturns 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/patternsconst data = await get('/items/7/44/patterns');const verdictsFor661 = data.seeds['661'] ?? [];data = get('/items/7/44/patterns')verdicts_for_661 = data['seeds'].get('661', [])On a listings page, make one
/patternscall per item, not one per listing. For a local copy of the whole dataset, use/v1/dump.