| Tool |
Summary |
get_transaction |
Read one Sui transaction’s sender, status, gas, balance changes, decoded actions and event fields; no hand-written GraphQL is needed to read event values. |
get_transactions |
Read 1-50 transaction digests in batched calls. |
query_events |
Query decoded events by type, sender, emitting module, affected object or time/checkpoint range. |
query_transactions |
Query raw transactions by sender, affected address or object, Move function, or time/checkpoint range. |
- Title: Get transaction
- Profile:
core (default)
- Annotations:
openWorldHint: true, readOnlyHint: true
- Metadata:
anthropic/maxResultSizeChars: 500000
Read one Sui transaction’s sender, status, gas, balance changes, decoded actions and event fields; no hand-written GraphQL is needed to read event values. It identifies protocols from calls and events (including wrappers), and unnamed packages by their curated publishing key; protocols_unchecked marks unread publishers. It shows address-balance deposits and withdrawals, requested withdrawals and gas source; non-sender object deliveries (coins separately when no other object moved); sender-owned capabilities mutated without transfer; and router coin round trips with cost from pool events, or null with a reason. High-bit u256 event numbers get signed readings; full detail also gives two’s-complement readings of high-bit u64/u128/u256 pure values. Use detail:‘full’ for inputs with declared types and object versions, resolved command arguments and Result origins, and every changed object’s ID, type and version by kind. Summary may fold or cap event rows past ~20k chars, retaining events emitted by called non-framework packages; omitted reports reductions. Full detail lists all events in pages: follow events_page.next_call. For command-only or pre-sign inspection use decode_ptb; for exploit profit, state deltas and anomaly leads use analyze_attack_tx.
| Parameter |
Type |
Required |
Description |
digest |
string |
yes |
Transaction digest (Base58) |
max_event_field_bytes |
integer (0 to 500000) |
no |
Decoded event-field byte cap; unset decodes every event. Set only to bound fields knowingly; skips are reported. 0 skips decoding. |
detail |
summary | full |
no |
‘summary’ (default): object counts, no inputs/commands; ~20k chars of deliveries/transfers/balance changes, prioritizing all capabilities and, for SUI/verified coins, sender changes and largest credits/debits. omitted reports the rest. ‘full’: all rows plus typed inputs, resolved arguments and objects by kind; commands page at ~30k chars, non-framework Move calls first. |
commands |
array of integer (at least 0) (at most 100 items) |
no |
Command indices to list with detail:‘full’, e.g. [3, 7], instead of the first page. Where attributable, events narrow to emitting calls and objects to commands taking them or returning their type; events_omitted and object_changes_omitted report exclusions. |
event_offset |
integer (at least 0) |
no |
Where the full-detail event page starts (after any commands narrowing); pages are ~40k chars and events_page.next_call carries the next offset. |
network |
mainnet | testnet | devnet |
no |
Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’ |
- Title: Get transactions
- Profile:
core (default)
- Annotations:
openWorldHint: true, readOnlyHint: true
- Metadata:
anthropic/maxResultSizeChars: 500000
Read 1-50 transaction digests in batched calls. Returns sender, status, timing, balance changes, non-coin object transfers and objects created for other owners, Move calls, decoded events and protocols. GraphQL misses are retried through the archive. object_changes_truncated marks an incomplete bounded object read; use get_transaction for that digest. Summary caps displayed rows with counts and omitted retrieval; detail: ‘full’ removes display caps, not object or event read bounds.
| Parameter |
Type |
Required |
Description |
digests |
array of string (1 to 50 items) |
yes |
Transaction digests, Base58 (1-50). Duplicates are collapsed. |
detail |
summary | full |
no |
‘summary’ (default): events, calls, balances and object custody share about 30k characters across the batch. ‘full’: every fetched row, subject to read bounds. |
network |
mainnet | testnet | devnet |
no |
Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’ |
- Title: Query events
- Profile:
forensics
- Annotations:
openWorldHint: true, readOnlyHint: true
Query decoded events by type, sender, emitting module, affected object or time/checkpoint range. With affected_object (an object ID such as a pool, or up to 20), scans transactions touching it, failed ones included, and lists every event with its digest, checkpoint, timestamp and names_object (true when a decoded field within eight levels names a listed ID); names_object_at gives the matching field path. names_object: true lists only those, including a router’s echo of a pool’s swap, so count trades by the venue’s own event_type. Empty filtered slices report how many events names_object dropped. Several objects merge into one checkpoint-ordered list whose events carry object_refs into objects. Event type and module narrow the returned events; sender selects transactions it sent. For a date range, pass ISO 8601 times directly as after_checkpoint and before_checkpoint, e.g. “2026-08-07T00:00:00Z”; checkpoint numbers are optional. Use a protocol’s own events to measure its flow: whole-PTB balance changes can over-attribute it. For one known transaction, use get_transaction. Pages default to newest first and report order, timestamp bounds and the resolved window. Continue with next_cursor as cursor, preserving order and filters; short service pages are filled to limit, and scan names the continuation if the read budget stops first. An object event scan whose nested event connection cannot be completed lists incomplete_transactions; read those digests with get_transaction. Event types use their struct’s defining package ID: upgraded IDs are rewritten and event_type_resolution reports it. A full event type absent from the lineage is rejected with candidate struct names. Module filters use the module whose call emitted the event, which may differ from the struct’s defining module. They follow the network’s emitting-ID cutover, using the original ID before it and the called version afterward, merging both for crossing windows. module_scope reports the scope and other version IDs; after cutover, one ID covers only that version. Framework packages upgraded in place keep one ID covering the lineage.
| Parameter |
Type |
Required |
Description |
event_type |
string |
no |
Filter by event type: 0x…, 0x…::module or 0x…::module::Name. An unknown struct or struct-less module returns candidates from its package. |
sender |
string |
no |
Filter by transaction sender |
affected_object |
array of string (1 to 20 items) |
no |
Object ID (such as a pool), or up to 20: lists every event of the transactions touching it, failed ones included, with names_object. sender selects transactions it sent; event_type and module narrow events after the transactions are read. |
names_object |
boolean |
no |
With affected_object: list only events with a decoded field naming a listed object ID (including nested fields). names_object_at gives its field path. Some venues’ events name no pool ID. |
module |
string |
no |
Module of the emitting call, not necessarily the event struct’s module; e.g. 0x2::coin or 0x2. The window selects original or called-version ID across the network cutover. module_scope reports scope; other_version_ids lists versions a post-cutover ID misses. |
after_checkpoint |
string | number |
no |
Window start: ISO 8601 time such as 2026-08-07T00:00:00Z (inclusive), or checkpoint number (exclusive). No checkpoint lookup is needed. |
before_checkpoint |
string | number |
no |
Window end: ISO 8601 time such as 2026-08-08T00:00:00Z (inclusive), or checkpoint number (exclusive). |
order |
newest | oldest |
no |
‘newest’ (default) starts at the most recent event in range and pages back; ‘oldest’ starts at the earliest and pages forward. |
limit |
integer (1 to 50) |
no |
Max results (default 20, max 50) |
cursor |
string |
no |
next_cursor from the previous page. Pass the same order and filters. |
network |
mainnet | testnet | devnet |
no |
Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’ |
- Title: Query transactions
- Profile:
core (default)
- Annotations:
openWorldHint: true, readOnlyHint: true
Query raw transactions by sender, affected address or object, Move function, or time/checkpoint range. Pass ISO 8601 times directly in after_checkpoint and before_checkpoint, e.g. “2026-08-07T00:00:00Z”; checkpoint numbers are optional. Only one of affected_address, affected_object and function is allowed. Prefer get_transaction_history for readable wallet activity. Pages default to newest first and report order, timestamp bounds and resolved window; pass next_cursor as cursor with the same order and filters. Short service pages are filled to limit within a read budget; scan reports exhaustion and the continuation call. Continue while has_next_page, even with no transactions. A function filter covers only the named package version; function_scope names other versions and all_versions:true merges the whole lineage. Rows wait for each stream’s next rows or exhaustion to establish global order. It matches any PTB containing the call, even one leg among several protocols. Whole-PTB balance changes therefore over-attribute protocol volume. Use include_functions to inspect every Move call, and query_events for a protocol’s own flow.
| Parameter |
Type |
Required |
Description |
sender |
string |
no |
Filter by sender address |
affected_address |
string |
no |
Filter by affected address (sender, sponsor, or recipient). Mutually exclusive with affected_object and function. |
affected_object |
string |
no |
Filter by affected object ID. Mutually exclusive with affected_address and function. |
function |
string |
no |
Filter by Move function (e.g. 0x2::coin::transfer or 0x2::pay). Mutually exclusive with affected_address and affected_object. |
after_checkpoint |
string | number |
no |
Window start: ISO 8601 time such as 2026-08-07T00:00:00Z (inclusive), or checkpoint number (exclusive). No checkpoint lookup is needed. |
before_checkpoint |
string | number |
no |
Window end: ISO 8601 time such as 2026-08-08T00:00:00Z (inclusive), or checkpoint number (exclusive). |
order |
newest | oldest |
no |
‘newest’ (default) starts at the most recent match and pages back; ‘oldest’ starts at the earliest and pages forward. |
limit |
integer (1 to 50) |
no |
Max results (default 20, max 50) |
cursor |
string |
no |
next_cursor from the previous page. Pass the same order and filters. |
include_functions |
boolean |
no |
List every Move call to expose multi-protocol PTBs. With function, adds total_calls and matched_calls at the filter’s function/module/package granularity, for the named version or all_versions. |
all_versions |
boolean |
no |
With function, merge calls through all lineage versions (default false: named version only). |
network |
mainnet | testnet | devnet |
no |
Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’ |