Movements History

GET /v1/movements method allows to retrieve paginated list of all the deposit and withdrawal records, sorted by created_at in descending order.

You can also specify a movement ID in the GET /v1/movements/{id} request to retrieve a particular gateway movement record.

GET /v1/movements

This method requires access token. Read more about access token.

GET /v1/movements
Authorization: Bearer {access_token}

Request parameters (optional):

Parameter	Data type	Default Value	Description
limit	uint16	100	[1, 100] valid interval. Sets max number of records in the response
after	string	-	value from the page_info.last_cursor field from the previous page response

Request example:

GET /v1/movements?limit=20&after=0q9nufaownuf09msufi09asmpofikap

Successful response:

Code : 200 OK

Response format (GET /v1/movements):

{
  type: "list",
  page_info: {
    has_next_page: boolean,
    last_cursor: string,
  },
  items: [
    {
      type: "gateway_movement",
      id: string,
      direction: "deposit" | "withdrawal",
      status: "in_progress" | "pending_approval" | "confirmed" | "rejected",
      source_platform_id: string,
      destination_platform_id: string,
      currency_id: string,
      amount: number,   // float64
      fee: number,      // float64
      created_at: Date, // ISO8601
      updated_at: Date, // ISO8601
      recipient_address: string,
      transactions: [
        {
          transaction_id: string,
          platform_id: string,
        }
      ]
    }
  ],
}

Response example (GET /v1/movements):

{
  "type": "list",
  "page_info": {
    "has_next_page": false,
    "last_cursor": "QXh1dVNHYVdnSGMxSHJCclpkWENXVWJ3ZnZrQmRvdVBkVUtmRFdOYUdOS1c="
  },
  "items": [
    {
      "type": "gateway_movement",
      "id": "AxuuSGaWgHc1HrBrZdXCWUbwfvkBdouPdUKfDWNaGNKW",
      "direction": "deposit",
      "status": "in_progress",
      "source_platform_id": "BTC",
      "destination_platform_id": "WAVES",
      "currency_id": "BTC",
      "amount": 0.0128,
      "fee": 0.00001,
      "created_at": "2020-11-03T08:34:02.630Z",
      "updated_at": "2020-11-03T08:34:02.630Z",
      "recipient_address": "3PNMvAqJWYPkwf8fhz46rZiLEWpTmuhD3Uh",
      "transactions": [
        {
          "transaction_id": "1577ce5161a4234fa19752855ab747238fd0ad37a56ec638ab003029d10c9897",
          "platform_id": "BTC"
        },
        {
          "transaction_id": "AxuuSGaWgHc1HrBrZdXCWUbwfvkBdouPdUKfDWNaGNKW",
          "platform_id": "WAVES"
        }
      ]
    }
  ]
}

GET /v1/movements/{id}

This method retrieves the specified gateway movement record by ID.

This method requires access token. Read more about access token.

GET /v1/movements/{id}
Authorization: Bearer {access_token}

Successful response:

Code : 200 OK

Response format (GET /v1/movements/{id}):

{
  type: "gateway_movement",
  id: string,
  direction: "deposit" | "withdrawal",
  status: "in_progress" | "pending_approval" | "confirmed" | "rejected",
  source_platform_id: string,
  destination_platform_id: string,
  currency_id: string,
  amount: number,   // float64
  fee: number,      // float64
  created_at: Date, // ISO8601
  updated_at: Date, // ISO8601
  recipient_address: string,
  transactions: [
    {
      transaction_id: string,
      platform_id: string,
    }
  ]
}

Response example (GET /v1/movements/AxuuSGaWgHc1HrBrZdXCWUbwfvkBdouPdUKfDWNaGNKW):

{
  "type": "gateway_movement",
  "id": "AxuuSGaWgHc1HrBrZdXCWUbwfvkBdouPdUKfDWNaGNKW",
  "direction": "deposit",
  "status": "pending_approval",
  "source_platform_id": "BTC",
  "destination_platform_id": "WAVES",
  "currency_id": "BTC",
  "amount": 0.0128,
  "fee": 0.00001,
  "created_at": "2020-11-03T08:34:02.630Z",
  "updated_at": "2020-11-03T08:34:02.630Z",
  "recipient_address": "3PNMvAqJWYPkwf8fhz46rZiLEWpTmuhD3Uh",
  "transactions": [
    {
      "transaction_id": "1577ce5161a4234fa19752855ab747238fd0ad37a56ec638ab003029d10c9897",
      "platform_id": "BTC"
    },
    {
      "transaction_id": "AxuuSGaWgHc1HrBrZdXCWUbwfvkBdouPdUKfDWNaGNKW",
      "platform_id": "WAVES"
    }
  ]
}