v1
latestOpenAPI 3.1.02026-07-24590534.0 KBFetch Withdraws
This endpoint will fetch all withdrawals related to the authenticated user.
get/users/{user_id}/withdraws?currency={currency}&state={state}
Path parameters
user_idstring required
The User ID. Use 'me' if fetching wallets of main authenticated user, use the user_id if fetching for Sub-account linked to the authenticated user.
currency'btc' | 'usdt' | 'eth' | 'xaut' | 'usat' | 'xrp' | 'dash' | 'ltc' | 'trx' | 'doge' | 'bnb' | 'pol' | 'usdc' | 'aave' | 'shib' | 'dot' | 'link' | 'cake' | 'xlm' | 'axs' | 'fil' | 'babydoge' | 'ada' | 'one' | 'bch' | 'xtz' | 'sushi' | 'zil' | 'floki' | 'sol' | 'mana' | 'sand' | 'enj' | 'lrc' | 'cfx' | 'ape' | 'wld' | 'meme' | 'ens' | 'arb' | 'myro' | 'magatrump' | 'jup' | 'blur' | 'coq' | 'fet' | 'ai' | 'bob' | 'bome' | 'ton' | 'mog' | 'inj' | 'mnt' | 'beam' | 'mew' | 'gno' | 'waves' | 'trump' | 'pnut' | 'wlfi' | 'zk' | 'lsk' | 'axcnh' | 'qdx' | 'cngn' required
Allowed Currencies values: usd, btc, ltc, eth, xrp, usdt, dash, trx, doge, xrp, bnb, matic, shib, axs, safemoon, cake, xlm, aave, link.
statestring required
Allowed State values: processing, done, rejected.
type'internal' required
Query parameters
order_bystring
Sort in either descending or ascending order, defaults to 'DESC'. options are asc or desc
Response
200
Example response
{
"status": "success",
"message": "Successful",
"data": [
{
"id": "IT-89c82dcb3930420ab09a81572985a4ab",
"reference": "ffff",
"type": "internal_transfer",
"currency": "usdt",
"amount": "1.0000000000000000",
"fee": "0.0000000000000000",
"total": "1.0000000000000000",
"narration": "We love you.",
"status": "done",
"wallet": {
"currency": "usdt",
"balance": "3.453800",
"locked": "0.0000000000",
"staked": "0.0000000000",
"converted_balance": "4786.759572",
"reference_currency": "NGN",
"is_crypto": "1",
"created_at": "2026-02-10T11:48:38.000Z",
"updated_at": "2026-02-23T10:53:41.000Z",
"deposit_address": "bc1qel75acv9tdwqdx86tla6yyxagp2fvq2tntxntp"
},
"user": {
"id": "24rhpmow",
"sn": "Qw1os7uj7",
"email": "test@gmail.com",
"first_name": "test",
"last_name": "tester",
"display_name": "Adigun Efon Exchange",
"created_at": "2026-02-09T13:22:14.000Z",
"updated_at": "2026-02-13T10:45:42.000Z"
},
"recipient": {
"type": "internal_transfer",
"details": {
"address": "test90999@gmail.com",
"name": "Qb3fwf0uk",
"destination_tag": "N/A"
}
},
"transaction_note": "Internal Crypto Transfer: We love you.",
"created_at": "Wed Feb 11 16:41:11 UTC 2026",
"done_at": "Wed Feb 11 16:41:11 UTC 2026"
}
]
}