Wallet History

Returns a unified list of transfers for a given wallet within a specified time range. All items follow the Unified Transfer Object format used across the API.

History includes native and token transfers where the wallet address appears as from or to.

Wallet History

POST https://api-processing.crypto-chief.com/v1/wallet/history

Headers

Name	Value
Content-Type	application/json
Signature	Signed request body
Merchant	Merchant ID

Body

Name	Type	Required	Description
uuid	string	true	UUID of the wallet to fetch history for.
direction	string	false	"in", "out", "all" (default: "all").
date_from	string format: YYYY-MM-DD H:mm:ss	false	Creation date, from
date_to	string format: YYYY-MM-DD H:mm:ss	false	Creation date, to
cursor	string	false	Pagination cursor for loading the next chunk.

Response

200

{
  "uuid": "8c1bd3c3-5c7c-4c1c-9af1-0f2127d8c317",
  "items": [
    {
      "chain": "ethereum",
      "contract": null,
      "from": "0xA1b2c3d4E5f678901234567890abcdef12345678",
      "to": "0x12f34a9b8c7e56d0b98bcd00123456789abcdeff",
      "tx_hash": "0x5ec7f4a3c0d5b6f2e8f9ab34c1d9f2b3e4d5c6a7b8c9d0e1f2a3b4c5d6e7f8a",
      "block_number": 21012345,
      "value": "100000000000000000",
      "human_value": "0.1",
      "decimals": 18,
      "type": "native"
    },
    {
      "chain": "ethereum",
      "contract": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "from": "0x12f34a9b8c7e56d0b98bcd00123456789abcdeff",
      "to": "0x9f8E7d6C5b4A3210fedcba098765432112345678",
      "tx_hash": "0x2f4b3a9c8d7e6f5a4b3c2d1e0f9e8d7c6b5a4f3e2d1c0b9a8f7e6d5c4b3a2910",
      "block_number": 21012500,
      "value": "25000000",
      "human_value": "25",
      "decimals": 6,
      "type": "token"
    }
  ],
  "next_cursor": null
}

400