Walletguide
DevelopersAPIReferencedata

ExpensesByMerchant

Whole-wallet figures need the permissions listed without assets:read; scoping the request with assetIds makes it a per-asset breakdown, which needs…

POST
/wallets/{walletId}/data/expensesByMerchant

Authorization

bearerAuth
headerAuthorization<token>

A Walletguide API key (wg_…) or an OAuth bearer token. Paste the value only. Create a key under Wallet settings → API keys.

Path Parameters

walletId*string

The wallet id (row uuid)

Formatuuid

Request Body

application/json
  1. body
period*|

Window the merchant spend is aggregated over.

limit?integer

Max merchants to return (default 10).

Range0 < value
assetIds?array<string>

Scope to these asset uuids; omit for whole-wallet.

categoryIds?array<string>

Scope to these category uuids; omit for all categories.

Response Body

expensesByMerchant result

application/json
  1. response
[index: integer]?
Example Request
curl -X POST 'https://api.walletguide.com/wallets/497f6eca-6276-4993-bfeb-53cbbbba6f08/data/expensesByMerchant' \  -H 'Content-Type: application/json' \  -d '{  "period": "today"}'
Example Response
[  {    "merchantId": "string",    "merchantName": "string",    "amount": 0,    "logo": "string"  }]

PlanVsActual

PlanVsActual (data endpoint) in the Walletguide REST API. Parameters, response fields, and a playground you can run.

NetWorthByAssetAccess

NetWorthByAssetAccess (data endpoint) in the Walletguide REST API. Parameters, response fields, and a playground you can run.