Get gem finder data
GET /v1/gem-finder/data
Returns the gem finder dataset including coins, available exchanges, and metadata.
Query parameters
Keep only assets whose home chain (
chainSlug: CoinGecko’s primary asset platform, or the chain itself for its own coin) is this chain, e.g. solana, base, arbitrum, bsc. A token only bridged there (listed in chainSlugs) does not match. A chain’s own coin is homed on that chain (SOL under solana, BNB under bsc); a coin or token whose home chain is unsupported (BTC, ICP) matches none. An unknown chain is a 400. Send the same chain with each cursor.Maximum number of coins per page.
1 to 1000. When omitted, the complete cached payload is returned. When provided, the response contains a page array plus a pagination object.Opaque cursor for fetching the next page. It is bound to one cache snapshot and expires after a refresh; restart without a cursor after an expiry error.
Response fields
Array of coin objects containing symbol, name, price, market cap, nullable FDV, 24-hour volume, nullable 24-hour and 7-day price returns (
return24h, return7d), a nullable 24-hour market cap return (marketCapReturn24h), nullable circulating supply, nullable ATH price and date and the price against it (fromAth), nullable ATL price and the price against it (fromAtl), nullable FDV/MCap ratio, exchange coverage, a nullable preferred chain slug, and a nullable lastUpdated quote timestamp. The returns, fromAth and fromAtl are fractions: 0.0532 is +5.32%, and -0.9 is 90% below the ATH. Missing or invalid upstream values stay null — they are never coerced to zero; ambiguous same-ticker assets do not receive exchange attribution from symbol-only venue feeds.List of exchange identifiers that appear across the coin set. Useful for building client-side filters.
Sync completeness and enrichment-coverage metadata when present.
enrichment.platform reports fresh versus preserved chain assignments; enrichment.exchanges lists successful and failed venue sources plus preserved last-good listings. Degraded enrichment is surfaced through X-Sharpe-Data-State: partial; incomplete market pages still preserve the entire last-good cache.limit is supplied, the response is wrapped with a sibling pagination object alongside data:
Opaque, snapshot-bound cursor to pass back as
cursor on the next request. null when there are no more pages.Total number of rows in the unpaginated dataset, when available. Omitted for endpoints that do not compute a count.
X-Sharpe-Data-State: empty. A cache/database read failure returns 503
(service_unavailable, Retry-After: 30) instead of masquerading as an
empty market.
Response

