Hanzo
OpenapiBooks

Answers a plain-language question about the caller's own books — "what is my…

Answers a plain-language question about the caller's own books — "what is my MRR?", "how long is my runway?" — with figures taken from their ledger, never…

POST /v1/books/ask

Addresshttps://api.hanzo.ai/v1/books/ask
MethodPOST
Operationpost_books_ask
AuthAuthorization: Bearer $HANZO_API_KEY

Answers a plain-language question about the caller's own books — "what is my MRR?", "how long is my runway?" — with figures taken from their ledger, never a guessed number. A deterministic keyword router picks the intent and reads the real metrics, and those figures, followups and report sources are computed BEFORE any model call and are never altered by one: the optional narration seam only rephrases the sentence, and it degrades silently to the templated answer when no AI plane is wired. It is strictly read-only — it restates the books, it never posts to them.

Request

3 fields, body application/json (required).

FieldInTypeRequiredDescription
frombodystringFrom is the RFC3339 start of the metric window.
questionbodystringQuestion is the plain-language question about the org's books, e.g.
tobodystringTo is the RFC3339 end of the metric window.

Response

StatusBodyMeaning
200AskResponseok

200 body — 7 fields.

FieldInTypeAlwaysDescription
answerbodystringAnswer is one or two sentences answering the question, every number in it taken from Figures.
figuresbodyFigure[]Figures are the grounded numbers the answer states, each already formatted.
figures[].labelbodystringLabel names the metric, e.g.
figures[].periodbodystringPeriod is the window the figure covers, e.g.
figures[].valuebodystringValue is the figure already formatted through books' own money formatter, so a consumer never re-derives it.
followupsbodystring[]Followups are sharper questions to ask next, chosen from the same intent.
sourcesbodystring[]Sources name the books reports the figures were computed from — "pnl", "position", "trial".

Failure carries the platform error shape — see Errors.

Examples

hanzo books ask

Books API · All Hanzo APIs · Interactive reference

How is this guide?

On this page