Wallet endpoints operate in the business account context for the issued API key. Use them to create wallets, list balances, fetch deposit addresses, preview withdrawals or payouts, and calculate fees.

​
Main flows

​
Create a crypto wallet

POST /api/v1/wallets/generate-wallet
Request body: 
{
  "token": "usdt",
  "name": "Main USDT Wallet"
}

​
Create an NGN wallet for payouts

Use token: "naira" when the user needs a naira wallet for local payouts. 
POST /api/v1/wallets/generate-wallet
Request body: 
{
  "token": "naira",
  "name": "Naira Wallet"
}

​
List wallets

GET /api/v1/wallets
GET /api/v1/wallets/by-coins
GET /api/v1/wallets/by-coins returns one row per supported asset with balances, network details, and wallet addresses where applicable.

​
Get a crypto deposit address

GET /api/v1/wallets/deposit-address
Required query parameters:
FieldDescription
coinSupported crypto asset, for example usdt.
chainSupported network for the coin, for example tron.
Example network response: 
{
  "status": "success",
  "message": "success",
  "data": [
    {
      "reference": "ethereum",
      "name": "ERC20"
    },
    {
      "reference": "binance",
      "name": "BEP20"
    }
  ]
}

​
Preview and confirm NGN payout

POST /api/v1/wallets/preview-withdraw-local-transfer
POST /api/v1/wallets/verify-withdrawal
Always preview a payout before confirming it. Preview request body: 
{
  "amount": 10000,
  "coin": "ngn",
  "accountNumber": "0123456789",
  "bankCode": "044",
  "remark": "Customer payout"
}
Confirm request body: 
{
  "transactionId": "TRANSACTION_ID_FROM_PREVIEW",
  "password": "CUSTOMER_AUTHORIZATION_VALUE"
}

​
Fees, limits, and markets

POST /api/v1/wallets/preview-withdraw
GET  /api/v1/wallets/minimum-withdrawal-amount
GET  /api/v1/wallets/withdrawal-fee
GET  /api/v1/wallets/markets
GET  /api/v1/wallets/markets/{market}
Use crypto withdrawal endpoints only with supported assets and chains. Example withdrawal-fee response: 
{
  "status": "success",
  "message": "OK",
  "data": {
    "fee": 1,
    "feeUSD": 1,
    "feeNGN": 1
  }
}