List Wallets

This endpoint returns a list of all wallets belonging to the authenticated user.

Request

GET /wallets

Query Parameters

Parameter	Type	Required	Description
limit	number	No	Maximum number of wallets to return (default: 10)
offset	number	No	Pagination offset (default: 0)

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

Example Request

curl -X GET "https://api.cryptofuse.io/wallets?limit=5&offset=0" \
  -H "X-API-Key: your_api_key"

Response

A successful response returns a list of wallets and pagination information.

Example Response

{
  "result": {
    "wallets": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Trading Wallet",
        "created_at": "2025-03-15T10:20:30.456Z"
      },
      {
        "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
        "name": "Savings Wallet",
        "created_at": "2025-04-01T08:15:30.123Z"
      }
    ],
    "total": 2,
    "limit": 5,
    "offset": 0
  }
}

Response Fields

Field	Type	Description
result.wallets	array	List of wallet objects
result.total	number	Total number of wallets
result.limit	number	Limit used in the request
result.offset	number	Offset used in the request

Each wallet object contains:

Field	Type	Description
id	string	Unique ID of the wallet (used in all API calls)
name	string	Custom name of the wallet
created_at	string	ISO 8601 timestamp of wallet creation

Error Responses

Status Code	Error Code	Description
401	unauthorized	Authentication failed
403	forbidden	User doesn't have required permissions
500	server_error	Internal server error

Notes

• The wallet ID (id) is used in all API calls related to the wallet
• Use this endpoint to retrieve the IDs of all your wallets when needed
• Results are paginated; use the limit and offset parameters to navigate through the results
• The total count of wallets is included in the response for pagination purposes