Skip to main content

Get Wallet Details

This endpoint retrieves detailed information about a specific wallet by its ID.

Request

GET /wallets/{wallet_id}

Path Parameters

ParameterTypeRequiredDescription
wallet_idstringYesID of the wallet to retrieve

Authentication

This endpoint requires authentication using one of the following methods:

  • API Key: X-API-Key header
  • OAuth 2.0: Authorization: Bearer {access_token} header

Response

A successful response returns the details of the specified wallet:

FieldTypeDescription
idstringUnique wallet identifier
namestringUser-defined name for the wallet
blockchainstringBlockchain type (ETH, BSC, TRX, SOL)
addressstringBlockchain address for the wallet
is_cold_walletbooleanWhether this is a cold wallet
balancenumberCurrent balance of the wallet
tokenstringToken type, typically USDT
last_checkstringISO 8601 timestamp of the last balance check
created_atstringISO 8601 timestamp of wallet creation
updated_atstringISO 8601 timestamp of last wallet update

Example Request

curl -X GET "https://api.cryptofuse.io/wallets/b5f1e5a0-6a7b-4c3d-8a2e-7f8d9e0b1c2d" \
-H "X-API-Key: your_api_key" \
-H "Content-Type: application/json"

Example Response

{
"data": {
"id": "b5f1e5a0-6a7b-4c3d-8a2e-7f8d9e0b1c2d",
"name": "My ETH Wallet",
"blockchain": "ETH",
"address": "0x1234567890abcdef1234567890abcdef12345678",
"is_cold_wallet": false,
"balance": 1500.75,
"token": "USDT",
"last_check": "2025-04-20T08:15:30.000Z",
"created_at": "2025-03-15T14:30:00.000Z",
"updated_at": "2025-04-20T08:15:30.000Z"
}
}

Error Responses

Status CodeError CodeDescription
400invalid_requestInvalid wallet ID format
401unauthorizedAuthentication failed
403forbiddenUser doesn't have required permissions
404not_foundWallet not found
500server_errorInternal server error