Skip to main content
GET
/
users
/
by-address
/
{address}
/
fee-balances
Get KOL fee balances for all mini-apps by address
curl --request GET \
  --url http://localhost:4000/v1/users/by-address/{address}/fee-balances \
  --header 'Authorization: <api-key>'
{
  "kolAddress": "0x123abc456def789012345678901234567890abcd",
  "totalMiniApps": 5,
  "successfulCalls": 4,
  "failedCalls": 1,
  "feeBalances": [
    {
      "miniAppId": "uuid-here",
      "contractAddress": "0x123abc456def789012345678901234567890abcd",
      "miniAppType": "swap",
      "chainName": "Avalanche",
      "chainId": 43114,
      "balances": [
        {
          "tokenAddress": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
          "balance": "1500000000000000000",
          "balanceFormatted": "1.5",
          "symbol": "USDC"
        }
      ],
      "success": true,
      "error": "Contract call failed"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Use this format: ApiKey <your_api_key>

Path Parameters

​
address
string
required

KOL Ethereum wallet address

Example:

"0x123abc456def789012345678901234567890abcd"

Response

Fee balances retrieved successfully

​
kolAddress
string
required

KOL wallet address

Example:

"0x123abc456def789012345678901234567890abcd"

​
totalMiniApps
number
required

Total number of mini apps for this KOL

Example:

5

​
successfulCalls
number
required

Number of successful contract calls

Example:

4

​
failedCalls
number
required

Number of failed contract calls

Example:

1

​
feeBalances
object[]
required

Fee balance details for each mini app