Zec Address Received
zec_address_receivedINCOMING Zcash (zec, ZEC, mainnet) outputs for an address — every coin received (tx, amount, output type: payment/change/mining (block reward), time), most recent first. Indexed by address (fast). Use to see what a ZEC address received and in which transactions. NOT what this address spent → use zec_sent_from_address. NOT sums over its whole history → use zec_address_flow_summary or zec_address_profile. An address can receive several coins (outputs) in one transaction, each its own row. Returns up to limit rows (default 20, at most 1000), newest first; page back with the last row's Cursor - a page shorter than limit is the last one. Set sort='amount' for the largest receipts instead: a top-N page with no Cursor. NOTE: shows receiving events, not the sender addresses (a UTXO output has no single sender) — pass a Tx to zec_tx_flow to see the addresses that funded it, or call zec_address_flow_summary for the top senders. Coins that arrive from the shielded pool are listed here too: their transaction has no transparent inputs in zec_tx_flow, and where they came from cannot be traced. Only the TRANSPARENT side of Zcash is visible: transparent addresses start with t1 or t3. Coins moved into or out of the shielded pool (z-addresses, unified u1… addresses) cannot be traced here. Each row: Time, Tx, Type, Amount_ZEC, Cursor.
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": {
"address": "<address>"
},
"name": "zec_address_received"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | "amount" = largest outputs first; "recent" (default) = newest first; any other value is refused. Ranking by amount returns a TOP-N, not the head of a page-walk: such a page carries no Cursor, so start a walk with sort='recent'. | recent |
| limit | No | Max outputs (ordered by `sort`; default newest first). 1-1000. | |
| cursor | No | Exact paging cursor: pass the Cursor value of the LAST row of the previous page to get the next page. Prefer this over before_time, which skips any rows sharing the last row's timestamp (a busy address can receive hundreds of outputs in one second). When set, before_time is ignored and rows come back newest-first whatever sort says. Empty = first page. Any other value is rejected. | |
| format | No | Shape of the returned data. "rows" (the default) returns one item per row. "columnar" returns a single item, {"columns":[...],"rows":[[value,...],...]}, naming the columns once and listing each row's values in that order; it is more compact for large results and carries the same values. | rows |
| address | Yes | Zcash TRANSPARENT address — t1… or t3…, 35 characters, case-sensitive, matched verbatim. Shielded z-addresses and unified u1… addresses are not supported and are rejected. An address of another chain does not have this form and is refused. | |
| after_time | No | Only outputs at/after this UTC time: "YYYY-MM-DD", "YYYY-MM-DD HH:MM:SS" or ISO "2026-07-01T00:00:00Z" (the form Time comes back in). Must be earlier than before_time when both are set. Empty = no lower bound. Other formats and impossible dates (2026-02-30, 25:00) are rejected. | |
| before_time | No | Only outputs strictly before this UTC time ("YYYY-MM-DD", "YYYY-MM-DD HH:MM:SS" or ISO "2026-07-01T00:00:00Z" (the form Time comes back in)) — a coarse upper bound, NOT a paging mechanism (it drops every row sharing the last row's timestamp). Page with cursor instead. Ignored when cursor is set. Empty = no upper bound. Other formats and impossible dates are rejected. |