PublicCoinPrice

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/coinrithm-com/json-schema/coinrithm-com-public-coin-price-schema.json",
  "title": "PublicCoinPrice",
  "description": "Price snapshot for one coin. Market and supply numerics are decimal\nSTRINGS, null when unknown; parse before comparing. Converted fields\nuse the requested `fiat`; `currentPriceUsd` is always USD.\n",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/coinrithm-com-openapi.yml#/components/schemas/PublicCoinPrice",
  "type": "object",
  "additionalProperties": true,
  "required": [
    "ucid",
    "slug",
    "symbol",
    "name",
    "priceUpdatedAt",
    "priceAgeHours",
    "priceStale",
    "priceStaleAfterHours"
  ],
  "properties": {
    "ucid": {
      "type": "string",
      "description": "CoinRithm coin id, the `coinId` of the agent endpoints."
    },
    "slug": {
      "type": "string"
    },
    "symbol": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "currentPriceUsd": {
      "type": [
        "string",
        "null"
      ],
      "description": "Price in USD."
    },
    "currentPrice": {
      "type": [
        "string",
        "null"
      ],
      "description": "Price in `fiat`."
    },
    "change24h": {
      "type": [
        "string",
        "null"
      ],
      "description": "24h price change in percent."
    },
    "high24h": {
      "type": [
        "string",
        "null"
      ],
      "description": "24h high in `fiat`."
    },
    "low24h": {
      "type": [
        "string",
        "null"
      ],
      "description": "24h low in `fiat`."
    },
    "volume24h": {
      "type": [
        "string",
        "null"
      ],
      "description": "24h volume in `fiat`."
    },
    "volumeChange24h": {
      "type": [
        "string",
        "null"
      ],
      "description": "24h volume change in percent."
    },
    "marketCap": {
      "type": [
        "string",
        "null"
      ],
      "description": "Market cap in `fiat`."
    },
    "marketCapChange24h": {
      "type": [
        "string",
        "null"
      ],
      "description": "24h market-cap change in percent."
    },
    "marketCapRank": {
      "type": [
        "integer",
        "null"
      ]
    },
    "marketCapSuspect": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "true when CoinRithm does not trust the market cap; null without a price."
    },
    "marketCapSuspectReason": {
      "type": [
        "string",
        "null"
      ]
    },
    "athUsd": {
      "type": [
        "string",
        "null"
      ],
      "description": "All-time high, converted to `fiat` despite the name."
    },
    "athDate": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "atlUsd": {
      "type": [
        "string",
        "null"
      ],
      "description": "All-time low, converted to `fiat` despite the name."
    },
    "atlDate": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "supplyCirculating": {
      "type": [
        "string",
        "null"
      ]
    },
    "supplyTotal": {
      "type": [
        "string",
        "null"
      ]
    },
    "supplyMax": {
      "type": [
        "string",
        "null"
      ],
      "description": "Maximum supply; `\"-1\"` means uncapped, null unknown."
    },
    "supplyPercent": {
      "type": [
        "string",
        "null"
      ],
      "description": "Circulating supply as a percent of `supplyMax`. Not meaningful (negative) when `supplyMax` is `-1`."
    },
    "btcEquivalent": {
      "type": [
        "string",
        "null"
      ],
      "description": "Price in BTC."
    },
    "btcChange24h": {
      "type": [
        "string",
        "null"
      ],
      "description": "24h change of the BTC ratio, in percent."
    },
    "ethEquivalent": {
      "type": [
        "string",
        "null"
      ],
      "description": "Price in ETH."
    },
    "ethChange24h": {
      "type": [
        "string",
        "null"
      ],
      "description": "24h change of the ETH ratio, in percent."
    },
    "priceUpdatedAt": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "As-of time of the price. On `/api/coins/{slug}` the live-price\nwrite time; on `/api/coins/{slug}/price` the price-summary row's\nwrite time (see that operation). Null when unknown.\n"
    },
    "priceAgeHours": {
      "type": [
        "number",
        "null"
      ],
      "description": "Hours since `priceUpdatedAt`, one decimal; null when unknown."
    },
    "priceStale": {
      "type": "boolean",
      "description": "true when `priceAgeHours` exceeds `priceStaleAfterHours`; false when the age is unknown."
    },
    "priceStaleAfterHours": {
      "type": "number",
      "description": "Staleness threshold in hours (72)."
    }
  }
}