> ## Documentation Index
> Fetch the complete documentation index at: https://docs.etherscan.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ChatGPT Plugin

> Install the Etherscan plugin in ChatGPT and query live onchain data in chat, with no API key.

The Etherscan plugin brings live onchain data into ChatGPT. Install it from ChatGPT's plugin directory, then ask about wallets, transactions, and contracts in plain language. It needs no API key or Etherscan account, and every tool is read-only.

## Get started

<Steps>
  <Step title="Install the plugin">
    Open [Etherscan in ChatGPT's plugin directory](https://chatgpt.com/plugins/plugin_asdk_app_6a9a645c20f4819187369704eae1f1ec), sign in to ChatGPT, and select **Install plugin**.

    <Frame>
      <img src="https://mintcdn.com/etherscan/R64_c93VXA2DWBFt/images/chatgpt-plugin.png?fit=max&auto=format&n=R64_c93VXA2DWBFt&q=85&s=13c1b77725eb27b6997d8abdc50c57c6" alt="The Etherscan plugin in ChatGPT's plugin directory, with the Install plugin button and three starter prompts" width="1594" height="1208" data-path="images/chatgpt-plugin.png" />
    </Frame>
  </Step>

  <Step title="Ask your first question">
    Start a new chat and ask in plain language:

    ```text theme={null}
    Inspect a verified Ethereum smart contract and its deployment details. 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
    ```

    In this example, ChatGPT reads the contract's verified source, ABI, and deployment details from Etherscan, then shows the result in an interactive Etherscan card. It explains that this is USDC, a verified upgradeable proxy, with its deployment block, creator, and implementation contract.

    <Frame>
      <img src="https://mintcdn.com/etherscan/R64_c93VXA2DWBFt/images/chatgpt-plugin-ask.png?fit=max&auto=format&n=R64_c93VXA2DWBFt&q=85&s=e4120ae3cbd7d510aded0d9897fa2a7d" alt="ChatGPT showing an interactive Etherscan card for the USDC contract: contract overview, upgradeable proxy type, and deployment block" width="1588" height="1080" data-path="images/chatgpt-plugin-ask.png" />
    </Frame>
  </Step>
</Steps>

## What you can ask

Ask in plain language. ChatGPT picks the right Etherscan tools for:

* Native coin balances and ERC-20, ERC-721, and ERC-1155 token transfers for any address
* Normal and internal transaction history
* A transaction's details, receipt, and status
* Verified contract source code and ABI, plus a contract's creator and creation transaction
* Event logs filtered by address and topics
* The block at a given time, current gas prices, and the list of supported chains

It works across all 60+ [supported chains](/supported-chains). Name the chain in your question, such as "on Base" or "on Arbitrum".

## Limits

The plugin uses the keyless [Etherscan MCP](/build-with-ai/mcp) server:

* **16 read-only tools.** The PRO tools are not included: token holdings, token info, top holders, funding source, and address labels.
* **Rate limited.** Its limits are separate from API plans.

Need the PRO tools or higher limits? Set up the Etherscan MCP server with your own API key in Codex instead. It includes all 21 tools and uses your API plan's limits. See [Etherscan MCP](/build-with-ai/mcp) for setup.

## What the plugin installs

The plugin installs two parts:

* **The Etherscan app:** the connection to Etherscan's tools.
* **The `etherscan` skill:** instructions that guide how ChatGPT uses those tools. It calls the narrowest tool for your question, shows results in an Etherscan card unless you ask for plain text, and keeps exact addresses, hashes, and amounts. It never invents labels, identities, or risk scores that Etherscan did not return.

If you don't name a chain, the skill uses Ethereum Mainnet and says so. Name the chain in your question to query another one.

## Good to know

* **Read-only.** Every tool reads public onchain data. Nothing signs or sends a transaction.
* **Verify what matters.** Results keep exact addresses, hashes, and amounts, so you can check them on Etherscan.
* **Chat context.** When the plugin is connected, ChatGPT may share relevant chats and memories with it to answer your requests. See OpenAI's [apps in ChatGPT](https://help.openai.com/en/articles/11487775-apps-in-chatgpt) guide and Etherscan's [privacy policy](https://etherscan.io/privacypolicy).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.