POST
/
95e61622bf6a8af293978377718e3b77
/
wallet
/
scanshieldedtrc20notesbyovk
wallet/scanshieldedtrc20notesbyovk
curl --request POST \
  --url https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/scanshieldedtrc20notesbyovk \
  --header 'Content-Type: application/json' \
  --data '{
  "start_block_index": 10000000,
  "end_block_index": 10001000,
  "ovk": "0x06e5f6789012345678901234567890123456789012345678901234567890abcdef12",
  "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 outgoing viewing key (ovk). This method allows senders to track their outgoing shielded transactions and monitor sent payments for record-keeping purposes.
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
  • ovk — the outgoing viewing key for decrypting sent notes
  • shielded_TRC20_contract_address — the shielded TRC20 contract address to scan

​
Response

  • note_txs — array of found outgoing 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 recipient information

​
Use case

The wallet/scanshieldedtrc20notesbyovk method is used for:
  • Tracking outgoing shielded TRC20 payments for transaction history
  • Monitoring sent transactions without revealing recipient details
  • Building wallet interfaces that show outbound shielded transaction records
  • Providing audit trails for shielded transaction activity

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

​
ovk
string
required

Outgoing viewing key for decrypting sent notes

Example:

"0x06e5f6789012345678901234567890123456789012345678901234567890abcdef12"

​
shielded_TRC20_contract_address
string
required

Shielded TRC20 contract address to scan

Example:

"TGzz8gjYiYRqpfmDwnLxfgPuLVNmpCswVp"

Response

200 - application/json

Successfully scanned for outgoing shielded notes

​
note_txs
object[]

Array of found outgoing shielded note transactions