added
Network Fee Amount Now Included Within /withdraws/requests Response
August 2nd, 2022
Zero Hash New Network Fee Field in Withdrawal Requests Endpoint
Zero Hash has added a new field to the /withdraws/requests endpoint designed to provide users the network fee paid for an on-chain withdrawal.
Withdrawals are considered any movement where the cryptocurrency asset leaves the Zero Hash ecosystem and transferred on network sending assets to a non-custodian wallet.
Example Response
{
"message":[
{
"id":1234567,
"withdrawal_account_id":1111711,
"participant_code":"DEF456",
"account_group":"ABC123",
"account_label":"general",
"requestor_participant_code":"DEF456",
"asset":"USDC",
"requested_amount":"10",
"settled_amount":"10.000000",
"gas_price":null,
"status":"SETTLED",
"on_chain_status":"CONFIRMED",
"client_withdrawal_request_id":null,
"requested_timestamp":1655909427111,
"transaction_id":"0xec54fb77b0b6b45f62...",
"input_data":null,
"fee_amount":"0.003163149641603118", <- New Field
"quoted_fee_amount":null
}
]
}
Optional Query Parameters
- participant_code (optional): Will default to the participant the API key was created for.
- page (optional): For paginating through your list of addresses.
- status (optional): For selecting requests with specific status (APPROVED, REJECTED, etc.).
- gas_price (optional): For selecting requests with specific gas price.
- client_withdrawal_request_id (optional): For selecting requests with specific client withdrawal request id.
- on_chain_status (optional): For selecting on chain with specific status. You can use CONFIRMED or PENDING.
- requested_timestamp: Filters withdrawal requests based on a given timestamp in milliseconds 1593798130060 or nanoseconds 1593798130060000000 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 and 1593798130777 you can use the next combination requested_timestamp[gt]=1593798130555&requested_timestamp[lt]=1593798130777
Please visit our API documentation to begin using this feature today!