Skip to content

NFTs

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’