Wallets
Get Wallet

Get Wallet

Fetches details for a specific cryptocurrency wallet by its unique ID. This includes the wallet's address and network information.


Endpoint

GET {{baseURL}}/v1/ramp/wallet/{walletId}


Example cURL Request

curl --request GET \
  --url {{baseURL}}v1/ramp/wallet/{{walletId}} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: {{API_KEY}}'

Headers

Header NameValueDescription
Content-Typeapplication/jsonSpecifies the media type
x-api-key{{API_KEY}}Your API authentication key

Path Parameters

ParameterTypeDescription
walletIdstringThe unique identifier of the wallet

Request Parameters

  • Query Parameters: None
  • Request Body: None

Success Response (200 OK)

{
  "message": "fetch wallet balances successfully",
  "status": "success",
  "data": {
    "id": "ad14b5f8-bf59-4300-8749-xxxxxxxxxxxxx",
    "address": "0xc2132d05d31c914a87c6611cXXXXXXXXXXXXX",
    "network": {
      "name": "Polygon",
      "blockchain": "MATIC"
    }
  }
}

Response Fields

FieldTypeDescription
messagestringGeneral status message from the server
statusstringOperation status, typically "success"
dataobjectContains wallet details

Fields inside data:

FieldTypeDescription
idstringUnique wallet identifier
addressstringBlockchain wallet address
network.namestringName of the network (e.g. Polygon)
network.blockchainstringBlockchain code (e.g. MATIC)

Error Codes

CodeMessageMeaning
401UnauthorizedMissing or invalid API key
404Not FoundWallet not found
500Internal Server ErrorServer-side error fetching wallet