Skip to content
DonutStatsAPI
Sign up
Economy

Get the economy

The whole DonutSMP economy in one response.

GET/v1/economy

Money supply and how it is spread, the biggest balance movers, what buy orders and the auction house are worth, and recent history of all of it. Everything here is computed from the full baltop and the live market.

hourly has every sample from the last 7 days, one every 15 minutes. daily has one sample per day for the last days days. For every sample ever taken, use economy history.

Authentication

API key with the read scope

Cached for

1 min

Data updates

Sampled every 15 minutes. The baltop every 6 hours.

Query parameters

  • daysintegeroptionaldefault 365

    Days of daily history to return.

    1 to 3,650

Response

Economy figures.

  • updatedAttimestamp | null

    When the latest sample was taken.

  • baltopobject

    Money on the baltop.

    Show9 child fields
    • totalnumber

      Money held by everyone on the baltop.

    • playersinteger

      Players on the baltop.

    • top10number

      Money held by the 10 richest.

    • top100number

      Money held by the 100 richest.

    • top1000number

      Money held by the 1,000 richest.

    • mediannumber | null

      Median balance.

    • averagenumber | null

      Mean balance.

    • halfHoldersinteger | null

      How few of the richest players hold half of all the money.

    • updatedAttimestamp | null

      When the baltop was last updated.

  • ordersobject

    Buy order totals.

    Show5 child fields
    • valuenumber

      Money waiting in open orders.

    • openinteger

      Open orders.

    • unitsinteger

      Items those orders still want.

    • filled24hinteger

      Items delivered in the last 24 hours.

    • paidOut24hnumber

      Money paid out in the last 24 hours.

  • auctionobject

    Auction house totals.

    Show2 child fields
    • valuenumber

      Liquid value of the auction house.

    • openinteger

      Open listings.

  • topHoldersobject[]

    The 10 richest players: rank, username, uuid, value.

  • topOrderItemsobject[]

    The 10 products with the most order money: product, value, orders, units.

  • distributionobject[]

    Players and money per balance bracket, richest bracket first.

    Show5 child fields
    • labelstring

      For example $1B to $10B.

    • minnumber

      Lower bound, inclusive.

    • maxnumber | null

      Upper bound, exclusive. null for the top bracket.

    • playersinteger

      Players in the bracket.

    • totalnumber

      Money they hold.

  • insightsobject

    Headline numbers.

    Show7 child fields
    • billionairesinteger

      Players with $1B or more.

    • trillionairesinteger

      Players with $1T or more.

    • gininumber | null

      Gini coefficient of baltop balances, from 0 (equal) to 1 (one player has it all).

    • baltopChange24hnumber | null

      Change in total baltop money over the last 24 hours.

    • priceIndex7dnumber | null

      Median 7 day price change across the 50 most listed items, as a fraction.

    • bountiesobject

      open bounties and their total amount.

    • listingsinteger

      Open auction listings.

  • moversobject

    Biggest balance changes since the previous day's baltop: since, then up to 8 gainers and 8 losers with rank, username, value and change.

  • topAuctionItemsobject[]

    The 10 products with the most liquid value: product, value, units, bid.

  • hourlyobject[]

    Samples from the last 7 days.

    Show6 child fields
    • ttimestamp

      When the sample was taken.

    • baltopTotalnumber

      Money on the baltop.

    • top100number

      Money held by the 100 richest.

    • ordersValuenumber

      Money waiting in buy orders.

    • auctionValuenumber

      Liquid value of the auction house.

    • paidOut24hnumber | null

      Money paid out by orders in the 24 hours before the sample. null when the data for that window has a gap, so the figure would be too low.

  • dailyobject[]

    The last sample of each day, same fields as hourly.