POST
/
95e61622bf6a8af293978377718e3b77
/
wallet
/
scanshieldedtrc20notesbyivk
wallet/scanshieldedtrc20notesbyivk
curl --request POST \
  --url https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/scanshieldedtrc20notesbyivk \
  --header 'Content-Type: application/json' \
  --data '{
  "start_block_index": 10000000,
  "end_block_index": 10001000,
  "ivk": "0x05d4e5f6789012345678901234567890123456789012345678901234567890abcdef",
  "ak": "0x03b2c3d4e5f6789012345678901234567890123456789012345678901234567890ab",
  "nk": "0x04c3d4e5f6789012345678901234567890123456789012345678901234567890abcd",
  "shielded_TRC20_contract_address": "TGzz8gjYiYRqpfmDwnLxfgPuLVNmpCswVp"
}'
{
  "note_txs": [
    {
      "block_num": 123,
      "tx_id": "<string>",
      "index": 123,
      "note": {}
    }
  ]
}
TRON API method that scans for shielded TRC20 notes using an incoming viewing key (ivk). This method allows users to detect incoming shielded transactions without revealing their spending keys or compromising privacy.
Get you own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Parameters

  • start_block_index — the starting block number for scanning
  • end_block_index — the ending block number for scanning
  • ivk — the incoming viewing key for decrypting notes
  • ak — the authentication key for verification
  • nk — the nullifier key for note identification
  • shielded_TRC20_contract_address — the shielded TRC20 contract address to scan

​
Response

  • note_txs — array of found shielded note transactions
  • block_num — block number where notes were found
  • tx_id — transaction ID containing the notes
  • index — index of the note within the transaction
  • note — the decrypted note details including value and payment address

​
Use case

The wallet/scanshieldedtrc20notesbyivk method is used for:
  • Scanning the blockchain for incoming shielded TRC20 payments
  • Detecting received transactions without compromising sender privacy
  • Building wallet interfaces that show shielded transaction history
  • Monitoring shielded contract activity for specific addresses

Body

application/json
​
start_block_index
integer
required

Starting block number for scanning

Example:

10000000

​
end_block_index
integer
required

Ending block number for scanning

Example:

10001000

​
ivk
string
required

Incoming viewing key for decrypting notes

Example:

"0x05d4e5f6789012345678901234567890123456789012345678901234567890abcdef"

​
ak
string
required

Authentication key for verification

Example:

"0x03b2c3d4e5f6789012345678901234567890123456789012345678901234567890ab"

​
nk
string
required

Nullifier key for note identification

Example:

"0x04c3d4e5f6789012345678901234567890123456789012345678901234567890abcd"

​
shielded_TRC20_contract_address
string
required

Shielded TRC20 contract address to scan

Example:

"TGzz8gjYiYRqpfmDwnLxfgPuLVNmpCswVp"

Response

200 - application/json

Successfully scanned for shielded notes

​
note_txs
object[]

Array of found shielded note transactions