User Need
“Read a wallet/account balance without embedding provider-specific endpoint logic or upstream keys in my agent.”Current Status
At publication time, the public Registry does not advertise a wallet-balance route. Do not invent a route identifier or call an old provider-specific example. Use Discovery to research providers or request an integration until a suitable route becomesready.
Recommended PubFi Flow
- Read
GET https://api.pubfi.ai/v1/capabilities. - Find a
readyoperation whose description and schema match the required chain and balance request. - Use the exact path and method from that Registry generation.
- Inspect the operation in
GET https://api.pubfi.ai/openapi.json. - Execute it through the HTTP gateway or the authenticated MCP route tools.
- Validate the provider JSON against the advertised response schema.
Why Not Call Provider Directly?
Direct provider calls make the agent own provider auth, endpoint shape, response validation, freshness evidence, and usage accounting. A ready PubFi Registry operation keeps those concerns behind a reviewed execution plan while returning the exact bounded provider response.Claim Boundary
This use case is executable only when the current Registry lists the exact path and method asready. A Discovery listing or integration request is not execution evidence.
Use Route Planning for selection rules and Registry Gateway
Examples for request construction.