Get Crypto Wallet By ID

Retrieve a single crypto wallet by its unique identifier, accessible to the authenticated API user(business).

Endpoint Details

Method: GET
Path: /api/crypto-wallet/{id}
Authentication: Required (API Key)

Request

GET /api/crypto-wallet/{id}
Authorization: Bearer <your_api_key>
Accept: application/json

Path Parameter

Example Request

GET /api/crypto-wallet/14b5c66b-3351-4120-8640-d17ed13ccb15
Authorization: Bearer <your_api_key>
Accept: application/json

Response

Success Response (200)

{
  "message": “crypto wallet successfully fetched",
    "status": "success",
    "data":  {
        "id": "uuid",
        "asset": "string",
        "network": "string", 
        "wallet_address": "string",
        "balance": {
          "total": 0.0,
          "locked_amount": 0.0,
          "available": 0.0,
          "pending": 0.0,
          "currency": "string",
          "has_minor": true
        },
        "status": "string",
        "created_at": "2023-10-27T10:30:00Z",
        "updated_at": "2023-10-27T10:30:00Z"
      }
}

{
    "message": “crypto wallet successfully fetched",
    "status": "success",
    "data":  {
        "id": "14b5c66b-3351-4120-8640-d17ed13ccb15",
        "asset": "USDC",
        "network": "ERC20",
        "wallet_address": "0x6BECC92E4c75F833D4036545dD4Aa84aaF8583ec",
        "balance": {
          "total": 0,
          "locked_amount": 54.88125845738305,
          "available": 241.40157205179526,
          "pending": 0,
          "currency": "USDC",
          "has_minor": false
        },
        "status": "active",
        "created_at": "2025-06-24T19:04:26.399099Z",
        "updated_at": "2025-06-24T19:04:26.399099Z"
      }
}

Error Responses

Status Code	Description
400	Invalid input or malformed query parameters
401	Unauthorized - Invalid or missing API key
500	Internal server error

Data Models

Crypto Wallet Object

Field	Type	Description
`id`	UUID	Unique wallet identifier
`asset`	string	Asset type (e.g., USDT, USDC)
`network`	string	Blockchain network (e.g., ERC20, TRC20)
`wallet_address`	string	Crypto wallet address
`balance`	object	Balance information (see Balance Object)
`status`	string	Wallet status (active, inactive, etc.)
`created_at`	timestamp	ISO-8601 formatted creation timestamp
`updated_at`	timestamp	ISO-8601 formatted last update timestamp

Balance Object

Field	Type	Description
`total`	float64	Total balance in the wallet
`locked_amount`	float64	Amount locked/reserved for pending operations
`available`	float64	Available balance for new transactions
`pending`	float64	Amount in pending transactions
`currency`	string	Currency code
`has_minor`	boolean	Whether the currency supports minor units (decimals)

Usage Examples

Basic Request

curl -X GET "https://ba-be-stg.usevaulta.com/v1/api/crypto-wallet/14b5c66b-3351-4120-8640-d17ed13ccb15" \
  -H "Authorization: Bearer your_api_key" \
  -H "Accept: application/json"