Skip to main content
Nikiwa signals outcomes at two levels: standard HTTP status codes for transport and auth, and in-body status markers for tool-level results.

​
HTTP status codes

​
Tool-level status markers

A tool call can return 200 OK and still contain no data. Nikiwa tools return their data object on success, or one of these markers:
Always branch on the body, not just the HTTP code. A 200 with {"status": "no_data"} means the query was valid but nothing matched, for example a wallet with no activity on the requested network.
1

Check the HTTP status

Handle 401, 404, and 429 before parsing the body.
2

Check for a status marker

If the body has status: "error" or status: "no_data", handle it explicitly.
3

Otherwise, use the data

A body with no error or no-data marker is a successful data result.