B3TR: User app overview (totals)
getB3TRUserAppOverviewRetrieve a user's B3TR rewards, rewarded actions, and sustainability rankings for a specific veBetterDAO app, with optional round or date filters.
Instructions
Get a users overview for a specific app on veBetterDao via /api/v1/b3tr/actions/users/{wallet}/app/{appId}/overview. Returns total B3TR rewards, number of rewarded actions, sustainability impact totals, global rankings for a specific app. appId must be the veBetterDaoId (32-byte hex). If the user gives an app name, call getAppHubApps first to resolve the veBetterDaoId. Optionally filter by roundId OR date (yyyy-MM-dd UTC), but not both — they are mutually exclusive.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"wallet": "<wallet>",
"appId": "<appId>"
},
"name": "getB3TRUserAppOverview"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Optional date (UTC) to filter by, format yyyy-MM-dd. Mutually exclusive with roundId. | |
| appId | Yes | B3TR appId (a.k.a. veBetterDaoId) — 32-byte hex. If the user gives a human-readable app name, look it up via getAppHubApps first and pass the resulting veBetterDaoId here. | |
| wallet | Yes | User wallet address (path parameter) | |
| roundId | No | Optional round id to filter by. Mutually exclusive with date. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| data | No | B3TR user overview for a specific app (totals and rankings) | |
| error | No | ||
| network | Yes |