Balance History

GET /v1/accounts/{id}/balance/history

Returns point-in-time balance snapshots. Every time a transfer touches the account, a snapshot is recorded.

Query parameters

Parameter	Default	Description
limit	20	Max entries (1-100)

Response 200

{
  "data": [
    {
      "debits_posted": 15000,
      "credits_posted": 50000,
      "debits_pending": 0,
      "credits_pending": 0,
      "timestamp": 1712345680000000000
    },
    {
      "debits_posted": 10000,
      "credits_posted": 50000,
      "debits_pending": 0,
      "credits_pending": 0,
      "timestamp": 1712345670000000000
    },
    {
      "debits_posted": 0,
      "credits_posted": 50000,
      "debits_pending": 0,
      "credits_pending": 0,
      "timestamp": 1712345660000000000
    }
  ]
}

Most recent entries first. timestamp is nanoseconds since Unix epoch.

Reading bottom-up tells the account's story. In this example: received 50,000 credit, then 10,000 was debited, then another 5,000.

Use this for account statements, balance charts, or auditing.