Skip to main content
GET
/
api
/
partner
/
v2
/
users
/
{userId}
/
wallets
/
balance
cURL
curl --request GET \
  --url https://staging-api.capa.fi/api/partner/v2/users/{userId}/wallets/balance \
  --header 'partner-api-key: <partner-api-key>'
{
  "success": true,
  "data": {
    "balances": [
      {
        "blockchain": "POL",
        "token": "USDC",
        "balance": "150.50",
        "walletAddress": "0x4d2f3d8f83b6f2f8e0f3f4f3f3f3f3f3f3f3f3f3",
        "flow": "OTC"
      }
    ]
  }
}
Retrieves the crypto balances for all wallets belonging to a user. Supports optional filtering by blockchain and token.

​
Error Codes

​
Common Errors

HTTP StatusCodeMessage
401UNAUTHORIZED”API Key is missing”
401UNAUTHORIZED”Invalid API Key format”
401UNAUTHORIZED”Invalid API Key”
403INVALID_PARTNER_FLOW”The partner has an invalid flow.”

​
User Ownership Errors

HTTP StatusCodeMessage
401UNAUTHORIZED”Partner information is required for this operation”
401UNAUTHORIZED”User is not associated with the partner”

​
Endpoint-Specific Errors

HTTP StatusCodeMessage
400INVALID_USER_INPUT_ERROR”Invalid User Input” (invalid UUID)

Headers

​
partner-api-key
string
required

Api key for the affiliated partner that is performing the request

Path Parameters

​
userId
string
required

The userId of the user

Example:

"8374f327-38bd-4b0b-b8a7-2524599eb903"

Query Parameters

​
blockchain
enum<string>

Filter by blockchain

Available options:
POL,
SOL,
ETH
Example:

"POL"

​
token
enum<string>

Filter by token symbol

Available options:
USDC,
USDT
Example:

"USDC"

Response

200 - application/json

Retrieves wallet balances for a user with optional filters

​
success
boolean
Example:

true

​
data
object