Movement

GET /accounts/:account_id/movements

Sample Response

{
  "message": [
    {
      "run_id": "500",
      "movement_timestamp": 1554395972174,
      "movement_id": "ab938734-0aa6-4378-baa1-2cc56aeee757",
      "movement_type": "final_settlement",
      "trade_id": "951806f4-d3ba-42c4-96fe-8083cd3202cf",
      "deposit_reference_id": null,
      "withdrawal_request_id": null,
      "change": "100"
    },
    {
      "run_id": "500",
      "movement_timestamp": 1554395972174,
      "movement_id": "d8f902be-f8c3-4f9c-ac66-67000510900d",
      "movement_type": "final_settlement",
      "trade_id": "3ad29e08-8b4f-435b-89aa-17b7a298b350",
      "deposit_reference_id": null,
      "withdrawal_request_id": null,
      "change": "-200"
    },
    {
      "run_id": "498",
      "movement_timestamp": 1554395972000,
      "movement_id": "c6af3d80-1aca-4280-b96b-a9b8d7ced46a",
      "movement_type": "deposit",
      "trade_id": null,
      "deposit_reference_id": "ebedc42f-85c3-4468-8894-1cb6f49f7a04",
      "withdrawal_request_id": null,
      "change": "10000"
    },
    {
      "run_id": "497",
      "movement_timestamp": 1554395972000,
      "movement_id": "c6af3d80-1aca-4280-b96b-a9b8d7ced46a",
      "movement_type": "withdrawal",
      "trade_id": null,
      "deposit_reference_id": null,
      "withdrawal_request_id": "100",
      "change": "-50"
    }
  ],
  "page": 1,
  "total_pages": 40
}

Returns the history of each itemized movement that has been applied to an account to lead up to its current balance.

Optional query parameters include:

• page for paginating through the movements

• movement_timestamp filters movements based on a given timestamp in milliseconds 1593798130060 or nanoseconds 1593798130060000000 using the following next params for the following filter types:

  • [gt] greater than a given timestamp, e.g. movement_timestamp[gt]=1593798130060

  • [gte] greater than or equal to a given timestamp, e.g. movement_timestamp[gte]=1593798130060

  • [e] equal to a given timestamp, e.g. movement_timestamp[e]=1593798130060

  • [lt] less than a given timestamp, e.g. movement_timestamp[lt]=1593798130060

  • [lte] lower than or equal to a given timestamp, e.g. movement_timestamp[lte]=1593798130060

  • combinations are also possible, e.g. to find a movements between 1593798130555 and 1593798130777 you can use the next combination movement_timestamp[gt]=1593798130555&movement_timestamp[lt]=1593798130777

Parameter	Description	Type
run_id	A unique ID for the particular run	string
movement_timestamp	The timestamp of the specific movement	timestamp
movement_id	A unique ID for the specific account update	string
movement_type	The type of movement	string
trade_id	The unique identifier of the trade or loan that resulted in the movement, if the movement was due to a trade or loan If a trade, this is equal to the trade_id field provided via the /trades	string
deposit_reference_id	This is an external identifier associated with the deposit, if the movement was due to a deposit This is equal to the reference_id field provided via the /deposits endpoint	string
withdrawal_request_id	The withdrawal request ID, if the movement was due to a withdrawal This is equal to the id field provided via the /withdrawals/requests endpoint	string
change	The change due to the specific movement	string

Movement Type

Movement	Description
collateralize_loan	A movement related to an increase in collateral held for any open loan(s)
deposit	A deposit of additional assets into NDAX
execution_fee	A movement due to incurred execution fees related to your trading activity on a NDAX's liquidity venue
final_settlement	A movement due to the full delivery and final settlement of a trade
final_settlement_default	A movement due to a financially-settled trade whose final settlement obligation could not be fully settled due to a default
final_settlement_default_fallback	A movement due to the financial settlement for the portion of a physically-settled trade's final settlement obligation that was not fully delivered due to a default
final_settlement_default_partial	A movement due to the partial physical delivery of a physically-settled trade whose final settlement obligation could not be fully delivered due to a default
initial_margin	A movement related to an increase or decrease in collateral held for any open position(s)
interest_payment	A payment of interest for a loan
loan_collateral_return	A movement related to a decrease in collateral held for any open loan(s)
network_fee	A blockchain network fee incurred due to an on-chain movement related to your wallet
principal_swap	A transfer of principal and collateral assets to open a loan
repayment	A transfer to return principal and collateral for a loan that has terminated
transfer	An internal transfer to or from an account at NDAX
variation_margin	A payment made or collected due to changes in the market value of the position since the trade was executed or since the previous time the position was marked to market
variation_margin_previous	A payment made or collected to settle a previously outstanding variation margin obligation
withdrawal	A processed withdrawal from NDAX
withdrawal_confirmed	Reversal of the temporary hold due to a withdrawal being processed
withdrawal_pending	Temporary hold whilst a withdrawal is being processed