0xDocs 0x.limo

Docs / Store page

Trending and sorting

How the 0x store ranks games (Trending, Most played, Newest, A–Z), what counts as a play, and the rules for the Trending badge and Featured.

The store ranks games by what players actually play. The figures come from the public GET /v1/catalog/stats (cached 60 s):

bashtested
curl -s https://api.0x.limo/v1/catalog/stats
json
{ "at": 1792234000000, "apps": { "4000009": { "plays_7d": 412, "seconds_7d": 98110, "plays_24h": 57, "seconds_24h": 12020,
  "approved_at": "2026-10-16T12:00:00Z", "updated_at": "2026-10-17T09:30:00Z" } } }

Every listed app appears, with zeros if nobody played it.

#What counts as a play

A play is counted when the launcher (desktop or web) starts your game and sends POST /v1/plays. Heartbeats about once a minute (/v1/plays/<id>/beat, at most 10 minutes per beat) and the end of the play add the time played. Counts are anonymous and kept per hour. plays_7d covers the last 168 hours and plays_24h the last 24. Plays from embeds and shared links count too, tagged with their source.

Opening your site URL directly, outside the launcher, doesn't start a counted play by itself. If your page is also played outside the launcher, report plays with @0xlimo/platform. Games inside the launcher don't need this: the launcher reports the plays it starts.

js
import { createPlatform } from "@0xlimo/platform";
const x1 = createPlatform({ baseUrl: "https://api.0x.limo", appid: 4000019 });
if (!x1.session) await x1.auth.guest();
await x1.plays.auto();        // start now, beat every 60 s, end on pagehide

#Sorts

SortOrder (each step only breaks ties of the one before)
Trending (the default)plays in the last 7 days → plays in the last 24 hours → players right now → play time in the last 7 days → name
Most playedplays in the last 7 days → play time in the last 7 days → players right now → name
Newestfirst approved (newest first) → name
A–Zname

A game with more plays this week always ranks above one with fewer, whatever happened today. "Players right now" comes from GET /v1/catalog/live: plays started or heard from in the last 3 minutes and not ended. The store refreshes the grid every 20 seconds.

#The Trending badge

The ↗ Trending pill ("Among the most played on 0x right now") goes to the top games of the Trending sort, across every listed game, demos included. A game must also meet both of these limits:

  • it has at least 10 plays in the last 7 days;
  • it is among the top 3, and within the top half of the store (rounded down, at least 1).

With 4 listed games, at most 2 can be trending. A game with 9 plays this week never is.

The store's Featured slot shows the top game of the Trending sort. When only demos are listed, it shows the top demo.

#What you can do

  • Share your game's page link with a ?ref= tag (0x.limo/game/<id>?ref=launch-post). Plays from it are counted with that ref.
  • Embed the game in posts and blogs. Embedded plays count.
  • Keep sessions alive: play time breaks ties.