GET
/
api
/
v1
/
wallets
/
by-coins
Group wallets by coin
curl --request GET \
  --url https://secureapi.dyrectpay.com/api/v1/wallets/by-coins \
  --header 'x-api-key: <api-key>' \
  --header 'x-signature: <api-key>' \
  --header 'x-timestamp: <api-key>'
{
  "status": "success",
  "message": "Success",
  "data": [
    {
      "coin": "usdt",
      "balanceInUSD": 25.5,
      "totalBalance": 25.5,
      "balanceInNGN": 34450,
      "balance": "25.5",
      "name": "Tether",
      "symbol": "USDT",
      "type": "crypto",
      "walletAddress": "0xexampleaddress",
      "subscribedChains": [
        {
          "reference": "binance",
          "name": "BSC",
          "type": "evm",
          "tokenType": "BEP20"
        }
      ]
    },
    {
      "coin": "naira",
      "balanceInUSD": 7.4,
      "totalBalance": 10000,
      "balanceInNGN": 10000,
      "balance": 10000,
      "name": "Naira",
      "symbol": "NGN",
      "type": "fiat",
      "walletAddress": "",
      "subscribedChains": [],
      "accountNumber": "0000000000"
    }
  ]
}

Authorizations

x-api-key
string
header
required

API key issued to your integration.

x-timestamp
string
header
required

Request timestamp used for signature verification.

x-signature
string
header
required

Request signature generated by your backend.

Response

Successful response.

status
string
Example:

"success"

message
string
Example:

"success"

data
any | null

Endpoint-specific response payload.