The House Ledger API

Public, read-only access to every figure on the House Ledger — the live position, the flow ledger, every line item, and the Akaunting books. Two ways in: a plain REST API and a GraphQL endpoint. No key required. CORS: open

Conventions

• Base URL: https://accounting.scarletbeast.com
• All chip figures are integer USD cents (100 = $1.00). Akaunting amounts are whole USD dollars.
• Every response carries an as_of ISO-8601 timestamp. Data is cached ~30 s.
• kind on a line item is income (a credit, amount ≥ 0) or expense (a debit).

REST

Every endpoint returns { "data": …, "as_of": … } as JSON.

Example

# headline position
curl https://accounting.scarletbeast.com/api/position

# → 
{
  "data": {
    "cash_on_hand_cents": 2990255,
    "in_play_cents": 66626697,
    "total_economy_cents": 69616952,
    "rakeback_returned_cents": 479,
    "accounts": 61  },
  "as_of": "2026-06-12T14:58:15+00:00"
}

GraphQL

A single endpoint — POST https://accounting.scarletbeast.com/graphql with { "query": "…" }, or GET /graphql?query=…. Read-only field selection over one root field, ledger. (Arguments, aliases, and fragments are not supported.)

Schema

type Query { ledger: Ledger }

type Ledger {
  as_of: String
  currency: String
  position: Position
  cash_on_hand_sources: [Source]
  flows: [Flow]
  ledger_items: [Item]
  akaunting: Akaunting
}
type Position { cash_on_hand_cents in_play_cents total_economy_cents rakeback_returned_cents accounts }
type Source   { label cents note }
type Flow     { type label description count inflow_cents outflow_cents net_cents }
type Item     { id date type source memo account amount_cents kind }
type Akaunting{ connected income_total expense_total net income_count expense_count entries }
type Entry    { date type category description contact account amount amount_formatted }

Example query

curl -s https://accounting.scarletbeast.com/graphql \
  -H 'Content-Type: application/json' \
  -d '{"query":"{ ledger { position { total_economy_cents } flows { label net_cents } } }"}'

Try it

Edit the query and run it against the live endpoint:

{
  ledger {
    as_of
    position { cash_on_hand_cents in_play_cents total_economy_cents accounts }
    flows { label net_cents count }
    akaunting { income_total expense_total net entries { date category amount } }
  }
}

Run query →

← Back to the ledger