Agent Books: one agent's payments and receipts for a period, signed and logged (free)
agent_booksUse this when someone needs a record they can hand to an accountant, an auditor, a platform or a counterparty: what one registration paid and received on Base in a closed month (period=YYYY-MM) or since its first event (period=to-date, the default). Returns counted payments (count, USD, what left the agent's control, what went into its own positions, payees, split by token, ten largest payees), what was left out and why (routing hops, own transfers, payments before registration), counted receipts (count, USD, senders, the part from wallets of other registered agents), detections logged in the period and transfers of the registration. The statement is signed with Ed25519, its hash is a leaf of our signed statement log and a daily Base transaction commits to that log; the answer says how to check each step without trusting us. One statement per agent, period and day; the answer's permalink returns that same statement on any later day. A record of observed facts under agent.books.v1: not an audit, not an opinion, says nothing about who owns the agent, about tax, or about safety.
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": {
"agent": "<agent>"
},
"name": "agent_books"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent | Yes | Agent token id, act_8453_N, slug or bound wallet | |
| period | No | YYYY-MM for a closed UTC month, or to-date (default) |