Birthday sats

What was mined on a day: per row counts for the site's birthday page, and the mint-day table behind every date filter.

Counts per day #

GET/api/birthday/counts

Per row, how many tracked sats were mined on a UTC day (date), or on that month-day of every year (md, optionally only years), that the index locates. Cacheable 30 s; a cold day can take a few seconds.

Query parameters #

Example request #

curl 'https://raresats.net/api/birthday/counts?date=2009-01-09'

const response = await fetch('https://raresats.net/api/birthday/counts?date=2009-01-09');
const data = await response.json();

import requests

data = requests.get("https://raresats.net/api/birthday/counts", params={"date": "2009-01-09"}).json()

Response 200 #

{
  "filter": {"years": [], "date": "2009-01-09", "md": null, "luck": null, "sub": null},
  "days": [
    {
      "date": "2009-01-09",
      "from": 470,
      "to": 559,
      "rows": {"vintage_alpha": 3, "vintage_omega": 1}
    }
  ],
  "rows": {"vintage_alpha": 3, "vintage_omega": 1},
  "ms": 749
}

Errors #

{error} (a message, no code):

The mint-day table #

GET/api/days

Which UTC day mined each block, compactly: what the site uses to date sats in the browser. A sat's mint day is the day of its block. Cacheable 30 s.

Example request #

curl 'https://raresats.net/api/days'

const response = await fetch('https://raresats.net/api/days');
const data = await response.json();

import requests

data = requests.get("https://raresats.net/api/days").json()

Response 200 #

Errors #

None of its own.

Decoding it: day first_day + i (UTC days since 1970) starts at height starts[0] + … + starts[i]; a block listed in exceptions belongs to the day given there instead (its timestamp is out of order).