GET: Withdrawal
GET /withdrawals/requests
GET /withdrawals/requests
Sample Response
Returns an array of all withdrawal requests created by users as part of your participant.
Query parameters include:
participant_code
(optional) will default to the participant the API key was created forpage
(optional) for paginating through your list of addressesstatus
(optional) for selecting requests with specific statusAPPROVED
,REJECTED
etc.gas_price
(optional) for selecting requests with specific gas priceclient_withdrawal_request_id
(optional) for selecting requests with specific client withdrawal request idon_chain_status
(optional) for selecting on chain with specific status. You can useCONFIRMED
orPENDING
.requested_timestamp
filters withdrawal requests based on a given timestamp in milliseconds1593798130060
or nanoseconds1593798130060000000
using the following params for the following filter types:[gt]
greater than a given timestamp, e.g.requested_timestamp[gt]=1593798130060
[gte]
greater than or equal to a given timestamp, e.g.requested_timestamp[gte]=1593798130060
[e]
equal to a given timestamp, e.g.requested_timestamp[e]=1593798130060
[lt]
less than a given timestamp, e.g.requested_timestamp[lt]=1593798130060
[lte]
lower than or equal to a given timestamp, e.g.requested_timestamp[lte]=1593798130060
combinations are also possible, e.g. to find a withdrawal requests between
1593798130555
and1593798130777
you can use the next combinationrequested_timestamp[gt]=1593798130555&requested_timestamp[lt]=1593798130777
Response:
Parameter | Description | Type |
---|---|---|
id | The withdrawal request ID | number |
client_withdrawal_request_id | A unique identifier for the withdrawal, generally produced by the Platform on which the trade was executed Note: this must be unique, per platform, per 24 hour period | string |
withdrawal_account_id | The ID of the withdrawal account the address belongs to | number |
asset | The asset code for the request, e.g. | string |
participant_code | The participant the request belongs to, e.g. | string |
requestor_participant_code | The participant code of the requestor, e.g. | string |
account_group | The account group the request was made against, e.g. | string |
requested_amount | The initially requested amount, e.g. | string |
settled_amount | The settled amount. This can be less than or equal to the requested_amount, e.g. | string or null |
transaction_id | The on-chain transaction id once the withdrawal has been confirmed | string or null |
status | The current status of the withdrawal request | string |
requested_timestamp | The timestamp for when the withdrawal request was requested | timestamp |
gas_price | The transaction fee payable on the Ethereum network If the asset is not an ERC-20 token, this field will always be null | string or null |
on_chain_status | Indicates whether or not the crypto withdrawal has been confirmed on-chain | string or null |
fee_amount | will return the network fee amount | string |
Last updated