Skip to main content
GET
/
api
/
v1
/
wallets
Get Wallets
curl --request GET \
  --url https://api.example.com/api/v1/wallets
{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key"
  }
}

​
Authentication

This endpoint requires authentication via Bearer token. 
Authorization: Bearer YOUR_API_KEY

​
Request

​
workspace_id
string
required
The workspace ID to fetch wallets for
​
chain
string
Filter wallets by blockchain network
  • ethereum
  • polygon
  • arbitrum
  • bsc
​
page
number
default:"1"
Page number for pagination
​
limit
number
default:"50"
Number of wallets per page (max 100)

​
Response

​
success
boolean
Indicates if the request was successful
​
data
array
​
pagination
object

​
Example Request

curl -X GET "https://api.cryptotally.xyz/v1/wallets?workspace_id=ws_123&chain=ethereum" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Example Response

{
  "success": true,
  "data": [
    {
      "id": "wlt_abc123",
      "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
      "label": "Treasury",
      "chain": "ethereum",
      "balance": {
        "native": "5.234",
        "tokens": [
          {
            "symbol": "USDC",
            "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
            "balance": "50000.00",
            "fiat_value": 50000.00
          },
          {
            "symbol": "DAI",
            "address": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
            "balance": "10000.00",
            "fiat_value": 10000.00
          }
        ],
        "fiat_value": 69500.00
      },
      "transaction_count": 147,
      "created_at": "2024-01-15T10:30:00Z",
      "last_synced": "2024-03-20T14:22:00Z"
    },
    {
      "id": "wlt_def456",
      "address": "0x8Ba1f109551bD432803012645Ac136ddd64DBA72",
      "label": "Operations",
      "chain": "polygon",
      "balance": {
        "native": "1200.50",
        "tokens": [
          {
            "symbol": "USDC",
            "address": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
            "balance": "25000.00",
            "fiat_value": 25000.00
          }
        ],
        "fiat_value": 26500.00
      },
      "transaction_count": 89,
      "created_at": "2024-02-01T09:15:00Z",
      "last_synced": "2024-03-20T14:22:00Z"
    }
  ],
  "pagination": {
    "total": 2,
    "page": 1,
    "pages": 1,
    "limit": 50
  }
}

​
Error Responses

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key"
  }
}

​
Rate Limits

  • Free Tier: 100 requests per hour
  • Pro Tier: 1,000 requests per hour
  • Enterprise Tier: Custom limits
Rate limit headers are included in the response: 
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1679334400

​
Filtering Examples

​
Get Ethereum wallets only

GET /api/v1/wallets?workspace_id=ws_123&chain=ethereum

​
Paginate results

GET /api/v1/wallets?workspace_id=ws_123&page=2&limit=20

​
Webhook Support

Subscribe to wallet events:
  • wallet.created - New wallet added
  • wallet.updated - Wallet label or details changed
  • wallet.synced - Wallet sync completed
  • wallet.deleted - Wallet removed
See Webhooks for setup instructions.

Add Wallet

Create a new wallet in your workspace

Get Transactions

Fetch transactions for a specific wallet

Sync Wallet

Manually trigger a wallet sync