> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fossapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Wallet by Address

> Retrieve crypto wallet details by wallet address

## Path Parameters

<ParamField path="address" type="string" required>
  Crypto wallet address (e.g., blockchain address)
</ParamField>

## Headers

<ParamField header="x-api-key" type="string" required>
  API Key for authentication
</ParamField>

## Request Example

```bash theme={null}
curl -X GET https://api-production.fossapay.com/v1/wallets/crypto/address/YcnysYh3Y***PxkazFyiTx76Upv12iP4sNGeHA2H4z2 \
  -H "x-api-key: your_api_key_here"
```

```javascript theme={null}
const response = await fetch(
  'https://api-production.fossapay.com/v1/wallets/crypto/address/YcnysYh3Y***PxkazFyiTx76Upv12iP4sNGeHA2H4z2',
  {
    method: 'GET',
    headers: {
      'x-api-key': 'your_api_key_here',
      'Content-Type': 'application/json'
    }
  }
);

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const wallet = await response.json();
```

## Response

<ResponseExample>
  ```json Success Response theme={null}
  {
    "status": "success",
    "statusCode": 200,
    "message": "Crypto wallet retrieved successfully",
    "data": [
      {
        "address": "8a0BY97fxiX26Pe2ckc3ke***z5MtWBCVk4pEx96Sqeb",
        "network": "solana",
        "tokens": {
          "usdc": {
            "amount": "0",
            "rawAmount": "0"
          },
          "usdt": {
            "amount": "0",
            "rawAmount": "0"
          }
        }
      }
    ]
  }
  ```
</ResponseExample>

## Error Responses

<ErrorResponse code="400">
  ```json Bad Request theme={null}
  {
    "status": "error",
    "statusCode": 400,
    "message": "Invalid wallet address format"
  }
  ```
</ErrorResponse>

<ErrorResponse code="404">
  ```json Not Found theme={null}
  {
    "status": "error",
    "statusCode": 404,
    "message": "Wallet not found"
  }
  ```
</ErrorResponse>
