History

GET /accounts/:account_id/run_history

Sample Response

{
  "message": [
    {
      "run_timestamp": 1549577062214,
      "run_type": "settlement",
      "run_id": "500",
      "change": "2000",
      "new_balance": "146645"
    },
    {
      "run_timestamp": 1520134020000,
      "run_type": "deposit",
      "run_id": "480",
      "change": "100000",
      "new_balance": "144645"
    },
    {
      "run_timestamp": 1510101010000,
      "run_type": "withdrawal",
      "run_id": "375",
      "change": "-20000",
      "new_balance": "44645"
    }
  ],
  "page": 1,
  "total_pages": 32
}

Returns the history of grouped settlements, deposits, withdrawals and other changes that have been applied to an account to lead up to its current balance.

Parameter	Description	Type
run_timestamp	The time that the particular run was executed	timestamp
run_type	The type of run	string
run_id	A unique ID for the particular run	string
change	The net change to the account due to all movements within the particular run	string
new_balance	The new account balance post-run	string

Run Type

A run is a group of movements that pertain to the same type of change to an account. They are split into the following buckets:

Run	Description
deposit	deposit represents a new deposit into the particular account, always increasing the total balance of the account
execution_fee	execution_fee represents a run to process fees incurred from trading on a Seed CX liquidity venue
network_fee	network_fee represents any and all blockchain network fees applied to an account, always decreasing the total balance of the account
settlement	settlement is a group of movements due to margining and settling trades, which may increase or decrease the account balance
transfer	transfer represents an internal transfer to or from an account at NDAX
withdrawal	withdrawal represents an approved and processed withdrawal from a particular account, always decreasing the total balance of the account