Skip to main content
GET
/
virtual-wallets
/
{walletId}
/
movements
curl -X GET "https://api.cryptomate.me/virtual-wallets/vw_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d/movements?size=20&sort_order=DESC&blockchain=POLYGON" \
  -H "x-api-key: $CRYPTOMATE_API_KEY"

{
  "movements": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "date": "2026-04-19T14:30:00",
      "operation": "DEPOSIT",
      "operation_id": "op_xyz789",
      "status": "COMPLETED",
      "wallet_id": "vw_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
      "blockchain": "POLYGON",
      "transaction_hash": "0x8a3d82e8f6c4e3f1b2d7a9c5e1f3b8d6a4c2e8f1",
      "amount": 100.50,
      "data": {}
    }
  ],
  "paging_state_token": "eyJsYXN0X2lkIjoxMjM0NX0="
}
Retrieves transaction history and movements for a virtual wallet including deposits, withdrawals, user withdrawals, virtual balance overrides, and ramp transfers. Supports pagination. Requires an API key with access level 2 or higher.

​
Path parameters

​
walletId
string
required
Unique identifier of the virtual wallet.

​
Query parameters

​
paging_state_token
string
Pagination state token for fetching the next page.
​
sort_order
string
Sort order for movements. ASC or DESC.
​
size
integer
Number of movements to retrieve per page.
​
blockchain
string
Filter movements by blockchain. One of ETHEREUM, POLYGON, BSC, ARBITRUM, OPTIMISM, BASE, AVALANCHE.

​
Response

​
movements
array
Array of movement records.
​
paging_state_token
string
Token for retrieving the next page of results.
curl -X GET "https://api.cryptomate.me/virtual-wallets/vw_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d/movements?size=20&sort_order=DESC&blockchain=POLYGON" \
  -H "x-api-key: $CRYPTOMATE_API_KEY"

{
  "movements": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "date": "2026-04-19T14:30:00",
      "operation": "DEPOSIT",
      "operation_id": "op_xyz789",
      "status": "COMPLETED",
      "wallet_id": "vw_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
      "blockchain": "POLYGON",
      "transaction_hash": "0x8a3d82e8f6c4e3f1b2d7a9c5e1f3b8d6a4c2e8f1",
      "amount": 100.50,
      "data": {}
    }
  ],
  "paging_state_token": "eyJsYXN0X2lkIjoxMjM0NX0="
}