public-crypto-data

One coin's price, market data, supply and links

Keyless coin profile: price in USD and in fiat, 24h change, 24h high and low, volume, market cap, all-time high and low, supply, BTC and ETH ratios, links, chains, categories and notices.

Market and supply numerics are decimal STRINGS (numeric columns), not JSON numbers: parse before comparing. currentPriceUsd is always USD. currentPrice, volume24h, marketCap, high24h, low24h, athUsd and atlUsd are converted to fiat (the last two despite their names); percentages and ratios are unitless.

priceUpdatedAt is when the coin's live price was last written. priceStale: true means that is more than priceStaleAfterHours (72) ago: the price is kept as the last known value, never hidden. marketCapSuspect: true flags a market cap CoinRithm does not trust (marketCapSuspectReason, for example stale_dead_pair). A coin without a live price (typically an inactive listing) answers 200 with the price fields, priceUpdatedAt and marketCapSuspect null and priceStale: false.

Query parameters other than fiat and locale are ignored. Unknown slug: 404 {"message": "not_found"}. Also served at /api/v1/coins/{slug} with identical behaviour.

get/api/coins/{slug}

Request

  • Base URL: https://api.coinrithm.com
  • URL: https://api.coinrithm.com/api/coins/{slug}
  • 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.

localestring

Language of notices text (for example de); default en. At most 10 characters, or 400.

Response

Coin profile with price, freshness and links

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).

volumeMissingVenuesinteger nullable

Expected venues missing from volume24h because their fetch failed; 0 none known, null unknown.

websiteUrlstring nullable
infoLinksobject nullable

Link groups such as website, whitepaper, explorers, wallets, source_code and audit.

watchlistCountinteger

CoinRithm users watching the coin.

watchlistRankinteger nullable

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.