---
title: "List movements"
method: GET
path: "/movements"
tags: ["Movements"]
---

# List movements

`GET /movements`

Retrieves the history of each itemized movement that has been applied to all account(s) that the requesting platform has access to. Results are limited to the last 2 months

## Query parameters

- `page` number
- `page_size` number
- `parent_link_id` string
- `movement_type` 'initial_margin' | 'deposit' | 'execution_fee' | 'final_settlement' | 'final_settlement_default' | 'final_settlement_default_fallback' | 'final_settlement_default_partial' | 'final_settlement_outstanding' | 'interest_payment' | 'collateralize_loan' | 'loan_collateral_return' | 'network_fee' | 'otc_final_settlement' | 'principal_swap' | 'repayment' | 'transfer' | 'variation_margin' | 'variation_margin_call' | 'withdrawal' | 'withdrawal_confirmed' | 'withdrawal_pending' | 'commission' | 'bank_fee' | 'transaction_fee' — The type of movement
- `transfer_type` 'trade_allocation' | 'commission_allocation' | 'commission_correction' | 'revenue_capture' | 'fund' | 'pay' | 'prefunded'
- `account_id` string

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Response `200`

Paginated list of movements for the accounts the requesting platform has access to. Results are limited to the last 2 months.

- GetMovementsResponse
  - `message` MovementsEntity[]
    - `movement_timestamp` number — Unix timestamp in milliseconds for the movement.
    - `account_id` string — Unique ID of the specific account
    - `movement_id` string — A unique ID for the specific account update
    - `movement_type` 'initial_margin' | 'deposit' | 'execution_fee' | 'final_settlement' | 'final_settlement_default' | 'final_settlement_default_fallback' | 'final_settlement_default_partial' | 'final_settlement_outstanding' | 'interest_payment' | 'collateralize_loan' | 'loan_collateral_return' | 'network_fee' | 'otc_final_settlement' | 'principal_swap' | 'repayment' | 'transfer' | 'variation_margin' | 'variation_margin_call' | 'withdrawal' | 'withdrawal_confirmed' | 'withdrawal_pending' | 'commission' | 'bank_fee' | 'transaction_fee' — The type of movement
    - `transfer_type` 'trade_allocation' | 'commission_allocation' | 'commission_correction' | 'error_trade_allocation' | 'error_trade_commission' | 'error_trade_loss' | 'error_trade_gain' | 'revenue_capture' | 'error_trade_loss_buy' | 'error_trade_loss_sell' | 'transaction_fee_allocation' | 'fund' | 'pay' | 'unquarantine' | 'prefunded' | 'inventory_loan' | 'stake_submitted' | 'stake_activated_pool' | 'stake_activated_external' | 'unstake_submitted' | 'unstake_completed' | 'loan_repaid' | 'reward_distributed' | 'fund_failure' | 'stake_canceled' | 'unstake_canceled' | 'stake_failed' | 'unstake_failed' | 'staking_reward_deposit' | 'staking_reward_fee_conversion' | 'staking_reward_platform_fee' | 'staking_system_reward' | 'ndo_settlement' | 'pool_stake_initiated' | 'pool_stake_activated' | 'pool_stake_failed' | 'pool_stake_canceled' | 'pool_unstake_initiated' | 'pool_unstake_completed' | 'pool_unstake_failed' | 'pool_unstake_canceled' | 'travel_rule_deposit_info_verified' | 'travel_rule_deposit_failure' | 'travel_rule_deposit_recovered' | 'null', nullable — Transfer type associated with the movement. `null` when the movement is not associated with a transfer.
    - `deposit_reference_id` string, nullable — External identifier associated with the deposit when the movement was due to a deposit. Equal to the `reference_id` field from `/deposits`. `null` otherwise.
    - `withdrawal_request_id` string, nullable — Withdrawal request ID when the movement was due to a withdrawal. Equal to the `id` field from `/withdrawals/requests`. `null` otherwise.
    - `transfer_id` string, nullable — Transfer request ID when the movement was due to a transfer. Equal to the `id` field from `/transfers`. `null` otherwise.
    - `parent_link_id` string, nullable — Unique identifier of the parent transaction that resulted in the movement. For a trade, equal to the `trade_id` from `/trades`. `null` when there is no parent.
    - `trade_id` string, nullable — Unique identifier of the trade or loan that resulted in the movement. For a trade, equal to the `trade_id` from `/trades`. `null` when the movement is not tied to a trade or loan.
    - `change` string — The change due to the specific movement
    - `origin` 'rest_api' | 'sdk' | 'secondary' | 'null', nullable — Method through which the movement was initiated (`rest_api`, `sdk`, or `secondary`). `null` when the movement was not initiated by a client request (e.g. on-chain deposit credit).
  - `page` number
  - `total_pages` number

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/zerohash/apis/zerohash-api.md) · [All operations](https://skmtc.net/zerohash/apis/zerohash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerohash/zerohash-api/revisions/8b647d934363/schema)