Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Etherscan

Query read-only Ethereum mainnet account, contract, token, and gas data.

Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

Connector
Authentication

Etherscan

API Key

Etherscan

Connect to Etherscan for read-only Ethereum mainnet data.

Set up in Etherscan

  1. Prepare the Etherscan account or service that the workflow will access. Grant access to the required resources and operations.

  2. API Key: Create an API key in your Etherscan account, then paste it here.

Set up in StackAI

  1. Open Settings → Connections, add a connection, and select Etherscan.

  2. Enter the credentials and connection details in the fields below.

  3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

Connection fields

StackAI field
Required
What to enter

API Key

Yes

Create an API key in your Etherscan account, then paste it here. Provider instructions.

Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

Use an action

  1. Add the required Etherscan action to the workflow.

  2. Select a connection when the action requests one.

  3. Complete the required fields. Use the reference picker when a value comes from another workflow step.

  4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

Actions

Get Account Balance

Get an Ethereum mainnet address's exact native balance in wei.

Inputs

Field
Type
Required
Description

Ethereum Address

string

Yes

The Ethereum mainnet account address to inspect.

Outputs

Field
Type
Description

Ethereum Address

string

The queried Ethereum address.

Balance (Wei)

string

The exact native balance in wei.

List Transactions by Address

List a page of normal Ethereum mainnet transactions for an address.

Inputs

Field
Type
Required
Description

Ethereum Address

string

Yes

The Ethereum mainnet address whose transactions to list.

Start Block

integer

No

First Ethereum block to include. Minimum: 0. Default: 0.

End Block

integer

No

Last Ethereum block to include. Minimum: 0. Default: 999999999.

Page

integer

No

One-based results page to return. Minimum: 1. Default: 1.

Transactions per Page

integer

No

Number of transactions to return, from 1 to 1,000. Minimum: 1. Maximum: 1000. Default: 100.

Sort Order

select (string)

No

Order transactions from newest or oldest. Available values: Latest first, Oldest first. Default: desc.

Outputs

Field
Type
Description

Transactions

object_array

Typed normal Ethereum transactions for this page.

Next Page

integer

Next page number when more results may exist.

Get Contract ABI

Get the parsed ABI for a verified Ethereum mainnet contract.

Inputs

Field
Type
Required
Description

Contract Address

string

Yes

The verified Ethereum mainnet contract address.

Outputs

Field
Type
Description

Contract Address

string

The queried contract address.

Contract ABI

object_array

Parsed ABI entries for the contract.

Get Token Balance

Get an address's exact ERC-20 token balance on Ethereum mainnet.

Inputs

Field
Type
Required
Description

Token Contract Address

string

Yes

The ERC-20 token contract on Ethereum mainnet.

Holder Address

string

Yes

The Ethereum address whose token balance to inspect.

Outputs

Field
Type
Description

Holder Address

string

The queried token holder address.

Token Contract Address

string

The queried ERC-20 contract address.

Token Balance (Smallest Unit)

string

The exact token balance in its smallest unit.

Get Gas Price Oracle

Get current Ethereum mainnet gas price recommendations.

Inputs

No input fields are required in this catalog entry.

Outputs

Field
Type
Description

Last Block

string

Latest block used for the recommendation.

Safe Gas Price (Gwei)

string

Lower-priority gas recommendation in Gwei.

Proposed Gas Price (Gwei)

string

Standard gas recommendation in Gwei.

Fast Gas Price (Gwei)

string

Higher-priority gas recommendation in Gwei.

Suggested Base Fee (Gwei)

string

Suggested base fee in Gwei.

Gas Used Ratios

string_array

Recent exact gas-used ratios.

Important behavior

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.

Last updated

Was this helpful?