Get Withdraws

GET api/v3/liquidity/withdraws

List your withdraws as paginated collection.

Parameters

Name	Type	Mandatory	Description
currency	STRING	NO	Currency code.
blockchain_key	STRING	NO	Blockchain key of the requested withdrawal
state	STRING	NO	Filter withdrawals by states. eg. (rejected, accepted, canceled)
rid	STRING	NO	Wallet address on the Blockchain.
start_date	STRING	NO	Filter withdrawals created after this date.
end_date	STRING	NO	Filter withdrawals created before this date.
limit	INTEGER	NO	Limit the number of returned paginations. Defaults to 100.
page	INTEGER	NO	Specify the page of paginated results.

Responses

• 200 Successful response

Returns a paginated array of withdrawal objects with details about withdrawal requests. Each object can be either an external withdrawal (to a blockchain address) or an internal withdrawal (to another platform user).

Response Fields (for each withdrawal object):

• id: Unique withdrawal request identifier
• currency_id: Currency code
• type: Asset type (coin, fiat)
• blockchain_key: Blockchain network identifier
• total: Total withdrawal amount
• amount: Amount after deducting fees
• fee: Transaction fee amount
• blockchain_txid: Blockchain transaction ID (populated when withdrawal succeeds on blockchain, null for internal transfers or pending external withdrawals)
• rid: Recipient ID or wallet address
• state: Withdrawal state. Possible values: prepared (initial), canceled, accepted, skipped, to_reject, rejected, processing, under_review, succeed, deposited, failed, errored, confirming, locked
• internal_type: Type of internal transfer (address, platform_transfer, etc.) or null for external
• confirmations: Number of blockchain confirmations
• created_at: Request creation timestamp
• updated_at: Last update timestamp
• done_at: Completion timestamp (null if not yet completed)
• error_message: Error details if withdrawal failed
• transaction_type: Either "external" or "internal"

Example

[
    {
        "id": 39,
        "currency_id": "usdt",
        "type": "coin",
        "blockchain_key": "eth-testnet",
        "total": "10.0",
        "amount": "9.0",
        "fee": "1.0",
        "blockchain_txid": "0x82423383d00812c6d59689ce47fe9dbabe8e0f6b8037aeac3ebd298dd5f666f5",
        "rid": "0x76dcd3dafb5f7229542f0580d9c5a1612486a42b",
        "state": "succeed",
        "internal_type": null,
        "confirmations": 0,
        "error_message": null,
        "transaction_type": "external",
        "created_at": "2026-01-12T16:55:43Z",
        "updated_at": "2026-01-12T16:57:22Z",
        "done_at": "2026-01-12T16:57:22Z"
    },
    { "…": "further records, same shape as above" }
]