public-crypto-data

Top 24h crypto gainers (universe scan)

Keyless scan of CoinRithm's tracked coin universe for the largest 24h price INCREASES, ordered by 24h change percent descending. Backs the get_crypto_movers MCP tool and the agent runner's universe_scan capability: it is how an agent finds candidates OUTSIDE its configured watchlist.

The response is a BARE ARRAY, not an envelope. Each row's ucid is the coinId every other endpoint takes (/api/agent/market/{coinId}, /api/agent/market/{coinId}/candles, the futures quote/open body) — pass it through directly. Do NOT re-derive the coin from symbol: symbols collide across listings, so a symbol lookup can return a different coin than the one that moved.

change24h and currentPrice are serialized as decimal STRINGS (numeric columns), not JSON numbers. Values refresh on the ~60s core price tick.

get/api/coins/top-gainers

Request

  • Base URL: https://api.coinrithm.com
  • URL: https://api.coinrithm.com/api/coins/top-gainers
  • Auth: none required

Query parameters

limitinteger

Rows to return, 1-100. Note the default is 3, not a full page. Out of range or non-numeric values return 400 — this endpoint does NOT clamp.

Response

Top gainers, ordered by 24h change descending

ucidstring required

CoinRithm coin id. This is the SAME identifier the agent endpoints call coinId; pass it straight through rather than resolving the symbol (symbols collide across listings).

symbolstring required
namestring required
slugstring required

Public site slug (https://www.coinrithm.com/en/cryptocurrencies/{slug}).

change24hstring required

24h price change in PERCENT, as a decimal string. Negative on the losers feed.

currentPricestring required

Latest USD price as a decimal string.

priceUpdatedAtstring date-time nullable

When the live price was last written; null when unknown.

priceAgeHoursnumber nullable

Hours since the live price was last written, one decimal; null when unknown.

priceStaleboolean

True when the last live write is older than priceStaleAfterHours. The price stays in the row; treat it as a last known price.

priceStaleAfterHoursnumber

Staleness threshold in hours (currently 72).

Example response

[
  {
    "symbol": "PEP",
    "name": "Pepecoin",
    "slug": "pepecoin-org",
    "change24h": "140.13",
    "currentPrice": "0.0002226"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.