Etherscan integration overview

Overview

Etherscan is a blockchain explorer and API platform for Ethereum and other EVM-compatible chains. Persona’s integration with Etherscan lets you retrieve blockchain balances, transaction activity, contract logs, and execution status directly within Persona workflows.

This integration is especially helpful for Fraud, Compliance, and Crypto Operations teams that need on-chain visibility inside Persona workflows—without requiring manual blockchain lookups across systems.

Benefits

Blockchain investigation automation: Automatically retrieve wallet balances, internal transactions, and smart contract activity during fraud reviews or compliance investigations.

Enhanced risk analysis: Incorporate on-chain signals into Persona workflows to help identify suspicious behavior, investigate transaction patterns, or validate crypto-related activity.

More streamlined crypto operations: Reduce manual blockchain searches by pulling Etherscan data directly into operational workflows and review processes.

Integration Features

Persona’s Etherscan integration helps teams enrich workflows with blockchain and transaction data from Ethereum and supported EVM-compatible chains. Key capabilities include:

  • Retrieve wallet balances: Fetch native token balances for one or more wallet addresses.
  • Retrieve internal transaction history: Pull internal transaction activity associated with blockchain addresses.
  • Check transaction execution status: Verify whether blockchain transactions succeeded or failed.
  • Retrieve smart contract event logs: Access event log data for supported smart contracts and blockchain activity monitoring.

Setting up the Etherscan integration

Prerequisites

To set up the Etherscan integration, ensure you have:

  • An Etherscan API key
  • Access to the wallets, contracts, or transactions you want to monitor
  • Appropriate permissions to manage Persona integrations

Setting up the Etherscan Credentials

  1. In the Persona Dashboard, navigate to Integrations > Marketplace and click on Etherscan.
  2. Click on Add Credential at the top of the page.
  3. Enter a Nickname for Credential to help identify this connection.
  4. Provide your Etherscan API key when prompted.
  5. Click Continue to save the credential.

Using the Etherscan integration in a workflow

  1. Create a new workflow, or open an existing workflow you’d like to update.
  2. Add a new action step > Integrations.
  3. Select the Etherscan integration and choose your saved Etherscan credential.
  4. Choose an operation and configure the input fields to pass in the correct information.
  5. Save/publish the workflow.

Etherscan Operations Overview

In addition to enriching workflows with blockchain activity, Persona can retrieve balances, transaction history, event logs, and transaction execution status directly from Etherscan. These actions support fraud investigations, crypto compliance reviews, and operational workflows without requiring teams to leave Persona.

See below for a comprehensive list of available Workflow Action steps and possible configurations for the Etherscan integration:

Get Native Balance Workflow Action Step

Retrieve the native token balance for one or more wallet addresses. This is useful when validating wallet ownership, reviewing blockchain activity, or enriching fraud and compliance workflows with current on-chain balances.

Configuration Steps:

  • Provide values for required fields:
    • Address
  • Optionally add:
    • Chain ID
    • Block Tag

Get Internal Transactions Workflow Action Step

Retrieve internal transaction history associated with a blockchain address. This is useful when investigating wallet activity, reviewing transaction flows, or identifying suspicious on-chain behavior tied to smart contract execution.

Configuration Steps:

  • Provide values for required fields:
    • Address
  • Optionally add:
    • Chain ID
    • Start Block
    • End Block
    • Page Number
    • Offset
    • Sort Order

Get Event Logs Workflow Action Step

Retrieve smart contract event logs for a contract address. This action helps teams monitor contract activity, review emitted events, or investigate blockchain interactions tied to a specific smart contract.

Configuration Steps:

  • Provide values for required fields:
    • Contract Address
  • Optionally add:
    • Chain ID
    • Start Block
    • End Block
    • Page Number
    • Offset

Get Contract Execution Status Workflow Action Step

Check whether a blockchain transaction executed successfully or failed. This is useful when validating transaction outcomes during investigations, customer support reviews, or crypto-related operational workflows.

Configuration Steps:

  • Provide values for required fields:
    • Transaction Hash
  • Optionally add:
    • Chain ID

FAQs

Does the Etherscan integration support multiple chains?

Yes. The Etherscan integration supports Ethereum and supported EVM-compatible chains through configurable chain IDs.

Can I verify transaction execution status?

Yes. You can verify whether a blockchain transaction succeeded or failed using transaction hashes within the workflow action step.

Are Etherscan API rate limits enforced?

Yes. Etherscan API rate limits apply to integration requests and may affect high-volume workflows or large-scale investigations.