public-crypto-data

One coin's price snapshot (lightweight)

Keyless price-only subset of /api/coins/{slug} for polling: the same price, change, volume, market-cap, all-time high/low, supply and BTC/ETH ratio fields with the same decimal-string numerics and the same fiat behaviour, without links, chains, categories, notices, volumeMissingVenues or watchlist counts.

priceUpdatedAt here is the write time of the coin's price-summary row, and priceAgeHours/priceStale derive from it. A periodic recompute can rewrite that row without a new price, so priceStale can read false for a price whose feed has stopped. For a staleness decision read /api/coins/{slug} or /api/live-prices, whose priceUpdatedAt is the live-price write time, and check marketCapSuspect.

Query parameters other than fiat are ignored. Unknown slug, or a coin with no price summary: 404 {"message": "not_found"}. Also served at /api/v1/coins/{slug}/price with identical behaviour.

get/api/coins/{slug}/price

Request

  • Base URL: https://api.coinrithm.com
  • URL: https://api.coinrithm.com/api/coins/{slug}/price
  • Auth: none required

Path parameters

slugstring required

Coin slug as on the website, for example bitcoin (the slug of a /api/coins or /api/live-prices row).

Query parameters

fiatstring

Upper-case currency code CoinRithm tracks, for example EUR, GBP or JPY (default USD). Case-sensitive and not validated: an untracked or lower-case code returns USD values with nothing in the body saying so. At most 10 characters, or 400.

Response

Price snapshot with its as-of time

ucidstring required

CoinRithm coin id, the coinId of the agent endpoints.

slugstring required
symbolstring required
namestring required
currentPriceUsdstring nullable

Price in USD.

currentPricestring nullable

Price in fiat.

change24hstring nullable

24h price change in percent.

high24hstring nullable

24h high in fiat.

low24hstring nullable

24h low in fiat.

volume24hstring nullable

24h volume in fiat.

volumeChange24hstring nullable

24h volume change in percent.

marketCapstring nullable

Market cap in fiat.

marketCapChange24hstring nullable

24h market-cap change in percent.

marketCapRankinteger nullable
marketCapSuspectboolean nullable

true when CoinRithm does not trust the market cap; null without a price.

marketCapSuspectReasonstring nullable
athUsdstring nullable

All-time high, converted to fiat despite the name.

athDatestring date-time nullable
atlUsdstring nullable

All-time low, converted to fiat despite the name.

atlDatestring date-time nullable
supplyCirculatingstring nullable
supplyTotalstring nullable
supplyMaxstring nullable

Maximum supply; "-1" means uncapped, null unknown.

supplyPercentstring nullable

Circulating supply as a percent of supplyMax. Not meaningful (negative) when supplyMax is -1.

btcEquivalentstring nullable

Price in BTC.

btcChange24hstring nullable

24h change of the BTC ratio, in percent.

ethEquivalentstring nullable

Price in ETH.

ethChange24hstring nullable

24h change of the ETH ratio, in percent.

priceUpdatedAtstring date-time nullable required

As-of time of the price. On /api/coins/{slug} the live-price write time; on /api/coins/{slug}/price the price-summary row's write time (see that operation). Null when unknown.

priceAgeHoursnumber nullable required

Hours since priceUpdatedAt, one decimal; null when unknown.

priceStaleboolean required

true when priceAgeHours exceeds priceStaleAfterHours; false when the age is unknown.

priceStaleAfterHoursnumber required

Staleness threshold in hours (72).

Example response

{
  "currentPriceUsd": "81915.0561485573",
  "change24h": "1",
  "marketCapSuspectReason": "stale_dead_pair"
}

Changes

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