Skip to content

Transactions and events

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’