Manual Withdrawals History

Retrieve a paginated list of all withdrawal operations for the current project, with optional date filters.

Withdrawal History

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

Headers

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

Body

Name	Type	Required	Description
date_from	string	false	Start date filter (RFC 3339 format, e.g. 2026-01-01T00:00:00Z).
date_to	string	false	End date filter (RFC 3339 format, e.g. 2026-02-01T00:00:00Z).
page	number	false	Page number (default: 1).
page_size	number	false	Items per page (default: 20, max: 100).

All fields are optional. An empty body {} returns the most recent withdrawals with default pagination.

Response 200

json

{
  "items": [
    {
      "uuid": "b0d1f7f9-1eaa-4c2f-8f9b-2b0d1b0b9f11",
      "status": "paid",
      "from_address": "0xF9e8d7c6b5a43210fedcba9876543210fedcba98",
      "to_address": "0xA1b2C3d4E5f6789012345678901234567890abcd",
      "amount": "100.500000",
      "network": "ETH_MAINNET",
      "coin": "USDT",
      "need_refuel": true,
      "refuel_tx_hash": "0xrefuel123abc456def789...",
      "refuel_status": "done",
      "tx_hash": "0xbbb222ccc333ddd444eee555fff666...",
      "estimated_fee_fiat": "1.20",
      "actual_fee_fiat": "1.18",
      "fee_mode": "service",
      "created_at": "2026-02-10T12:00:00Z",
      "completed_at": "2026-02-10T12:02:30Z"
    },
    {
      "uuid": "c2d3e4f5-6789-0abc-def1-234567890abc",
      "status": "system_fail",
      "from_address": "0xF9e8d7c6b5a43210fedcba9876543210fedcba98",
      "to_address": "0xBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB",
      "amount": "50.000000",
      "network": "BSC_MAINNET",
      "coin": "BNB",
      "need_refuel": false,
      "error_reason": "insufficient balance after gas estimation",
      "estimated_fee_fiat": "0.08",
      "fee_mode": "client",
      "created_at": "2026-02-09T15:00:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "page_size": 20,
    "total": 96,
    "total_pages": 5
  }
}

Response Fields

Each item in the items array has the same structure as the Withdrawal Info response.

The meta object contains pagination details:

Field	Type	Description
page	number	Current page number.
page_size	number	Number of items per page.
total	number	Total number of matching withdrawals.
total_pages	number	Total number of pages.