Economy

List economy history

Every economy sample ever taken, one every 15 minutes.

GET/v1/economy/history

The raw series behind the economy page, oldest first: money on the baltop, buy order and auction house totals, and 24 hour trading volume. Up to 5,000 samples per page, which is about 52 days.

Authentication

API key with the read scope

Cached for

1 min

Data updates

A new sample every 15 minutes. Kept forever.

curl "https://api.donutstats.io/v1/economy/history?limit=2" \
  -H "x-api-key: $DONUTSTATS_API_KEY"

Response200OK

{
  "limit": 2,
  "next": "MTc5MTUxMjY4MDI5OC4w",
  "entries": [
    {
      "t": 1791512632169,
      "baltop": {
        "players": 67497,
        "total": 181491200000000,
        "top10": 17943000000000,
        "top100": 42931000000000,
        "top1000": 81987200000000
      },
      "orders": {
        "open": 23061,
        "units": 8683768892,
        "value": 1867480553697.27
      },
      "auction": {
        "open": 141684,
        "value": 456549939018.49
      },
      "filled24h": 67915959,
      "paidOut24h": 18890999059.72
    },
    {
      "t": 1791512680298,
      "baltop": {
        "players": 67497,
        "total": 181491200000000,
        "top10": 17943000000000,
        "top100": 42931000000000,
        "top1000": 81987200000000
      },
      "orders": {
        "open": 23061,
        "units": 8683768892,
        "value": 1867480553697.27
      },
      "auction": {
        "open": 141684,
        "value": 456549939018.49
      },
      "filled24h": 67915959,
      "paidOut24h": 18890999059.72
    }
  ]
}

Try itCounts towards your plan

Query parameters

fromtimestampoptional
Only entries at or after this time, in Unix milliseconds.
totimestampoptional
Only entries before this time, in Unix milliseconds.
limitintegeroptionaldefault 1000
Entries per page.
1 to 5,000
cursorstringoptional
The next value from the previous response. Leave it out for the first page. See cursors.

Response

A feed of samples, oldest first. from and to apply to t.

limitinteger
Entries per page.
nextstring | null
Pass this as cursor to get the next page. null on the last page.
entriesEconomySample[]
The entries on this page, oldest first.
ShowHide6 child fields
- ttimestamp
  When the sample was taken.
- baltopobject
  Money on the balance leaderboard at that moment.
  ShowHide5 child fields
  - playersinteger
    Players on the board.
  - totalnumber
    Money held by all of them.
  - top10number
    Money held by the top 10.
  - top100number
    Money held by the top 100.
  - top1000number
    Money held by the top 1000.
- ordersobject
  Open buy orders at that moment.
  ShowHide3 child fields
  - openinteger
    Open orders.
  - unitsinteger
    Items they still wanted.
  - valuenumber
    Money they would still pay out.
- auctionobject
  The auction house at that moment.
  ShowHide2 child fields
  - openinteger
    Open listings.
  - valuenumber
    Total asking price of those listings.
- filled24hinteger | null
  Items delivered to buy orders in the 24 hours before the sample.
- paidOut24hnumber | null
  Money buy orders paid out in the 24 hours before the sample. null when that window has a gap in the data.

Status codes

Status	When
400Bad Request	A malformed window or `cursor`.