reads

Screen coins inside market boundaries (rank band, volume, sectors)

Returns up to limit active coins inside the caller's boundaries: market-cap rank band, minimum 24h USD volume, optional stablecoin exclusion and curated sectors in/out (ids from /api/agent/universe/sectors). Coins flagged market-cap-suspect and coins whose live price is older than 72 h are never included. Sorts that need a change or volume value exclude coins where it is null. Ties break on market-cap rank, then UCID, so equal data gives equal order. A sector both included and excluded is excluded.

Pass ucids to check whether specific coins are inside the same boundaries (membership check, at most 50 ids). Unknown query parameters are ignored. Pure market data on a shared 60 s URL-keyed cache, so priceAgeHours can lag the response time by up to a minute. Requires scope read.

get/api/agent/universe

Request

Base URL: https://api.coinrithm.com
URL: https://api.coinrithm.com/api/agent/universe
Auth: HTTP bearer

Query parameters

rankMininteger

Lowest market-cap rank included (inclusive). Must be <= rankMax.

rankMaxinteger

Highest market-cap rank included (inclusive).

minVolume24hUsdnumber

Minimum 24h volume in USD; a null volume counts as 0.

excludeStablecoins'true' | 'false' | '1' | '0'

Excludes the stablecoins sector (same as listing it in excludeSectors).

includeSectorsstring

Comma-separated sector ids (case-insensitive); a coin must belong to at least one. Unknown ids return 400.

excludeSectorsstring

Comma-separated sector ids to exclude. Unknown ids return 400.

ucidsstring

Optional comma-separated coin UCIDs (1-50 ids, each matching ^[A-Za-z0-9_-]{1,64}$) restricting the screen to these coins.

limitinteger

Response

Example response

{
  "rows": [
    {
      "priceStaleAfterHours": 72
    }
  ],
  "observation": {
    "schema": "coinrithm.agentObservation.v1"
  }
}

Changes

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