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}

Headers

Header Name	Value	Description
`Content-Type`	`application/json`	Specifies the media type
`x-api-key`	`{{API_KEY}}`	Your API authentication key

Path Parameters

Parameter	Type	Description
`walletId`	string	The unique identifier of the wallet

Example Request

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

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 Example

If the request is successful, the API returns the wallet data.

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

Response Fields

Field	Type	Description
`message`	string	General status message from the server
`status`	string	Operation status, typically `"success"`
`data`	object	Contains wallet details

Fields inside `data`:

Field	Type	Description
`id`	string	Unique wallet identifier
`address`	string	Blockchain wallet address
`network.name`	string	Name of the network (e.g. Polygon)
`network.blockchain`	string	Blockchain code (e.g. MATIC)

Error Codes

Code	Message	Meaning
401	Unauthorized	Missing or invalid API key
404	Not Found	Wallet not found
500	Internal Server Error	Server-side error fetching wallet

Get All Wallet Get Wallet Balance