Retrieve Account Activity

📘

Supported on Sui Mainnet.

🚧

The Account's Activity API on Sui are currently available to approved Members. If you're interested, please apply through here.

Parameter

• address, string - a 32 Byte address with '0x' as prefix. The address to search for the account.
• protocol, string - DeFi protocol (currently support "Cetus","Scallop","Turbos", "KriyaDEX", "NAVI", "Aftermath ", "FlowX", "Hyperspace", "BlueMove",and "Clutchy").
• packageIds, string - package address, if you have more than one, separate them with comma,. The maximum is 10 packages per call.
• cursor, string - next page cursor.

Response

• data - an array of the specified On-Chain activity detail. An empty array will be returned if there are no data.
  • digest, string - transaction block digest associated with the particular activity. For example, '2vgT6cCmkbFqpYyaT6NisPmoWWG1KVQSZU2wZhztbeYQ'.
  • type, string - transaction type, such as 'AddLiqudity', 'Transfer', 'Swap',and etc.
  • gasFee, string - transaction fee, measured in MIST.
  • status, string - transaction status, either success or fail.
  • sender, string - transaction sender.
  • timestampMs, integer - the time when this transaction block is validated, measured in milliseconds, , e.g.,1687635197434.
  • interactAddresses, array object- the package or account that the transaction sender interacted in this transaction.
    • address, string - the package ID or an account address.
    • type, string - the address type, package or account.
    • name, string - the project name associated with the package or the account.
    • logo, string - the project logo.
  • coinChanges, array object - an array of the Coin change of the holders.
    • amount, string - coin change amount, e.g., -34980000000.
    • coinAddress, string - coinType, e.g.,0x2::sui::SUI.
    • symbol, string - the symbol return from the coin's metadata, e.g., SUI.
    • decimal, string - the decimal return from the coin's metadata, e.g., 9.
    • logo, string - the icon url return from the coin's metadata, e.g.,https://imagedelivery.net/cBNDGgkrsEA-b_ixIp9SkQ/sui.svg/public.
  • nftChanges, array object an array of the NFT change of the holders.
    • objectId, string - the Object ID for the NFT. , e.g., 0xc255c7e8a0c4aabaec79cfce3eb184164ff0803b1c86ce60ed32bffe354cc4c0
    • objectType, string - the Object Type or Collection Type for the NFT, e.g., 0xee496a0cc04d06a345982ba6697c90c619020de9e274408c7819f787ff66e1a1::suifrens::SuiFren\<0xee496a0cc04d06a345982ba6697c90c619020de9e274408c7819f787ff66e1a1::capy::Capy>)
    • marketPlace, string ,the relative marketplace where the transaction is initiated, including HyperSpace, BlueMove, Clutchy, TradePort, Tocen, Keepsake and Souffl3.
    • imageURL, string - the image url of the NFT returned from its metadata.
    • name, string- the name of the NFT returned from its metadata.
    • packageId, string the package id associated with the particular activity. Taking the transaction digest mentioned above, the associated package is 0x80d114c5d474eabc2eb2fcd1a0903f1eb5b5096a8dc4184d72453f7a9be728e4.
    • amount, string - the trading amount of this NFT.
    • price, string- the last sale price of the NFT on the marketplace, measured in MIST.
• nextPageCursor, integer - the index of the next page to retrieve. Current page index will be returned if the last page is reached.