Keys / Etherscan

ETHERSCAN_API_KEY

The Etherscan API key your app reads onchain data with, across 50+ EVM chains. The free plan allows 3 calls a second and 100,000 a day.

Expires
the docs don't say
API
none; dashboard only

Get it

Create one on etherscan.io/apidashboard. The steps aren't recorded yet.

Set it

ETHERSCAN_API_KEY=...

The Etherscan CLI reads it from this variable, ahead of a key saved with etherscan login. For the HTTP API, your app sends it as apikey. Or keep it out of .env with keypin: keypin run -- npm run dev

Replace it

  1. On the API dashboard, select Add to create a new key. Limits are shared across all keys on the account.
  2. A new key can take a few minutes to activate. Once it works, deploy it everywhere that reads ETHERSCAN_API_KEY. Both keys work in the meantime.
  3. Check that nothing still uses the old key, then remove it from the API dashboard.

Set rotate_every on the key in keypin.toml and a rotated date on its vault item, and keypin status shows when it's due.

Sources, checked 2026-11-16