Endpoints
All GET, under https://truefloat.app/api. Links open the
interactive reference.
/v1/items/{def_index}/{paint_index}: the item and a menu of the guides covering it (each system’s id, label, alias, topic, side, kind, level count and seed count), without seeds.?topic=narrows the menu to one topic; an unknown topic is a400./v1/resolve: every(def_index, paint_index)aslugormarket_hash_namecovers. See Addressing items.
Guides
Section titled “Guides”/v1/guides/{steam_id}: one whole guide as transcribed: systems, levels, every graded seed with its verbatim quote, and the guide’s recorded contradictions.?system=narrows it to one system. See Reading a guide response.
Seeds & patterns
Section titled “Seeds & patterns”/v1/items/{def_index}/{paint_index}/seeds/{seed}: every guide’s verdict on one seed, side by side, plus the covering systems that don’t list it./v1/items/{def_index}/{paint_index}/patterns: every graded seed of one item in one response, guides and systems given once: one call per item on a listings page.
/v1/dump: every item and every guide in one brotli or gzip response, for a local copy. See Download everything./v1/index: every grade in one compact brotli or gzip response, grouped by system and level, with the topics, for local lookups. See Every grade in one index.
Utilities
Section titled “Utilities”/v1/meta: the currentdataset_version, when it was loaded, and counts of items, guides, systems and gradings./health:200when the API is up with its data loaded,503otherwise. Not rate limited.
Catalogue
Section titled “Catalogue”What every CS2 case, capsule and souvenir package holds, and where each item
comes from. The catalogue has its own version, catalog_version, independent
of dataset_version; it is the ETag of every catalogue response.
/v1/catalog/meta: thecatalog_versionand the catalogue’s counts./v1/catalog/index: the whole catalogue in one compact response: items, containers, collections, pools and metadata./v1/catalog/dump: the six raw data files in one response, for a build that works from the data as stored./v1/catalog/ext: the compact map the TrueFloat extension reads, in positional tuples./v1/catalog/containers: every container in summary;?kind=and?event=narrow the list./v1/catalog/containers/{ref}: one container in full, by id ordef_index./v1/catalog/collectionsand/v1/catalog/collections/{set_id}: every collection in summary, and one in full./v1/catalog/eventsand/v1/catalog/events/{event_id}: the tournament events with souvenir data, and one with its souvenir packages./v1/catalog/items/{key}: one item by key, such asskin:33:354orsticker:231./v1/catalog/skins/{def_index}/{paint_index}: one skin by its indexes.- One item of a kind by its own id:
/v1/catalog/stickers/{identifier},patches,sprays,charms,music,agentsandreels. /v1/catalog/resolve: the item or container amarket_hash_namenames.
Machine-readable: the OpenAPI 3.1 document.