| Tool |
Summary |
get_nft_sales |
Read TradePort, BlueMove and OriginByte NFT sale events over a recent window, with volume and per-marketplace totals. |
get_top_holders |
Scan objects of a Move type and report holders. |
list_nft_collections |
Summary of the NFT collections a wallet holds: every kiosk plus directly owned objects, one row per collection type with its count. |
list_nfts |
List NFTs owned by a wallet, including kiosk-stored NFTs. |
- Title: Get NFT sales
- Profile:
forensics
- Annotations:
openWorldHint: true, readOnlyHint: true
- Metadata:
anthropic/maxResultSizeChars: 500000
Read TradePort, BlueMove and OriginByte NFT sale events over a recent window, with volume and per-marketplace totals. Records sale-derived kiosk ownership for get_top_holders.
| Parameter |
Type |
Required |
Description |
hours |
number (1 to 168), default 24 |
no |
How far back to read, in hours (default 24, max 168) |
collection_type |
string |
no |
Keep only sales of this Move type. Most sale events name no collection; those count as unattributable_sales, so a low count does not show the collection did not trade. |
max_pages |
integer (1 to 200), default 40 |
no |
Request cap across all marketplaces (default 40, 50 events per request) |
include_sales |
boolean, default false |
no |
Also return each sale with its checkpoint and time (default false, since a busy window has thousands of rows). |
detail |
summary | full |
no |
With include_sales: ‘summary’ (default) lists the newest sales that fit and counts the rest in omitted; ‘full’ lists every sale. |
network |
mainnet | testnet | devnet |
no |
Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’ |
- Title: Get top holders
- Profile:
forensics
- Annotations:
openWorldHint: true, readOnlyHint: true
Scan objects of a Move type and report holders. NFT collections are ranked by count; tokens by balance across Coin<T> objects and address balances. A truncated scan returns sampled_holders, unranked and with no supply share; a token ranking is complete only when both walks, coin objects and address balances, reach the end. Kiosk-held NFTs use sale-derived owner snapshots that get_nft_sales records, where available; remaining kiosk owner fields are self-declared and marked. Accepts a Move type, coin type or mainnet collection name. A scan stops at its time budget and reports time_budget_reached. Results not stopped by time are cached for 24 hours.
| Parameter |
Type |
Required |
Description |
type |
string |
no |
NFT struct type or coin type, e.g. ‘0xabc::module::NFT’ or ‘0x2::sui::SUI’. A coin type is wrapped in Coin<…> automatically. |
collection_name |
string |
no |
NFT collection name or slug to look up in the registry (e.g. ‘gawblenz’). Alternative to ‘type’. |
mode |
nft | token |
no |
‘nft’ ranks by count, ‘token’ by balance. If omitted, a type the chain knows as a coin is scanned as a token, anything else as an NFT collection. |
limit |
integer (1 to 100) |
no |
Top N holders to return (default 20, max 100) |
max_scan |
integer (1 to 50000) |
no |
Objects to scan per walk (default 5000, max 50000). Token mode walks Coin<T> objects and address balances separately, each to this bound. The 35s time budget applies regardless. |
time_budget_ms |
integer (1000 to 600000) |
no |
Wall-clock scan budget in milliseconds (default 35000, max 600000); a longer request may exceed a client’s timeout. |
network |
mainnet | testnet | devnet |
no |
Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’ |
- Title: List NFT collections
- Profile:
core (default)
- Annotations:
openWorldHint: true, readOnlyHint: true
Summary of the NFT collections a wallet holds: every kiosk plus directly owned objects, one row per collection type with its count. Each collection carries an estimated value (tier heuristic): per item, the lower of the collection’s lowest active listing and its last sale in the 30 days before now, or whichever of the two exists (a listing alone only if placed in that window), with zero-price sales, sales within one address or kiosk, and sales where one side first funded the other left out; unpriced otherwise. estimated_value totals every collection; the default view keeps every priced collection and caps the rest, and detail: 'full' returns all rows. value: false skips the valuation.
| Parameter |
Type |
Required |
Description |
address |
string |
yes |
Owner wallet address (0x…) |
value |
boolean, default true |
no |
Estimate each collection’s value from its market (default true). Costs a few requests per collection that has a market. |
max_collections |
integer (1 to 5000) |
no |
Collection types whose markets are valued (default 100); raise when estimated_value lists collections beyond this bound. |
market_depth |
integer (1 to 20) |
no |
Multiplier for per-collection sale/listing reads (default 1); raise through estimated_value.market_next_call when market coverage is limited. |
detail |
summary | full |
no |
‘summary’ (default): priced collections, then the most-held others that fit; omitted counts the rest. ‘full’: every collection. |
network |
mainnet | testnet | devnet |
no |
Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’ |
- Title: List NFTs
- Profile:
core (default)
- Annotations:
openWorldHint: true, readOnlyHint: true
(Recommended for NFTs) List NFTs owned by a wallet, including kiosk-stored NFTs. Each row has an object id, collection_ref (zero-based index into this page’s exact collection_types), kiosk and display metadata. detail: 'full' adds raw Move contents and valuation evidence. est_usd is a heuristic NFT estimate; other valued objects carry value_usd and a tier. value: false skips valuation. Pass next_cursor as cursor for the next page; its absence means the wallet is fully enumerated. Use list_nft_collections for a per-collection summary and wallet total.
| Parameter |
Type |
Required |
Description |
address |
string |
yes |
Owner wallet address (0x…) |
limit |
integer (1 to 1000) |
no |
Most NFTs to return (default 50, max 1000). |
cursor |
string |
no |
Opaque pagination token from a prior response’s next_cursor. Omit on first call. |
detail |
summary | full |
no |
‘summary’ (default) leaves out raw contents and valuation evidence, counted in omitted. ‘full’ includes both. |
value |
boolean, default true |
no |
Estimate each NFT’s value from its collection’s market (default true). Costs a few requests per collection on the page. |
max_collections |
integer (1 to 5000) |
no |
Collection types valued on this page (default 100); raise through valuation.next_call if more are present. |
market_depth |
integer (1 to 20) |
no |
Multiplier for per-collection sale/listing reads (default 1); raise through valuation.market_next_call when market coverage is limited. |
network |
mainnet | testnet | devnet |
no |
Network: ‘mainnet’ (default) | ‘testnet’ | ‘devnet’ |