Optimism Superchain Token List Scraper

Optimism Superchain Token List Scraper

Scrape the official Optimism Superchain token list for any EVM chain, up to a million tokens per run. Every token comes with its name, symbol, decimals, logo URI, and chain id. Export to CSV, JSON, Excel, or XML.

The Optimism Superchain token list is the canonical registry of bridged and native tokens across OP Mainnet, Base, Zora, and other OP Stack chains. Manually tracking deployments or verifying token addresses across multiple chains is slow and error-prone. This Actor reads the public token list directly, lets you filter by chain id, symbol, or name, and returns each matching token in one fixed schema.

Who uses it	What they scrape Optimism Superchain Token List for
DeFi developers	Bootstrapping a token selector dropdown with verified Superchain assets.
Blockchain analysts	Auditing which tokens are bridged or native on a specific OP Stack chain.
Wallet teams	Populating a wallet's default token list with canonical names and logos.
Crypto data providers	Feeding a pipeline that enriches token metadata with price and volume data.

What it does

This Actor collects token entries from the Optimism Superchain token list and returns each one as a flat row with its on-chain identifiers and metadata.

• ⛓️ Chain id filter: restrict results to a single EVM chain, such as Ethereum (1), OP Mainnet (10), Base (8453), or Zora (7777777).
• 🔤 Symbol filter: pull a single token by its ticker, case-insensitive, like USDC or WETH.
• 🔍 Name search: substring match on the token name to find all variants of a protocol's token.
• 📦 Bulk export: collect up to 1,000,000 tokens in one run and download as a structured dataset.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with Optimism Superchain Token List data

🪙 Build a token selector.

A DeFi frontend developer runs the Actor with chainId=8453 to fetch every verified token on Base and populate a swap interface's token picker.

🔎 Audit a chain's token registry.

A security researcher pulls the full list for Zora (chainId=7777777) to check for duplicate symbols or suspicious token names before a protocol launch.

🏷️ Resolve token metadata.

A data engineer runs the Actor with symbol=USDC to collect every USDC deployment across all Superchain chains and build a cross-chain mapping table.

🖼️ Fetch token logos in bulk.

A wallet team scrapes the entire list, extracts every logoURI, and downloads the icons to serve from their own CDN for faster wallet load times.

Why choose this scraper

	What you get
Canonical source	Reads the official Superchain token list repository, the same one wallets and bridges trust.
Multi-chain coverage	One Actor covers Ethereum, OP Mainnet, Base, Zora, and every other OP Stack chain.
Fixed schema	Every token row has the same fields: chainId, address, name, symbol, decimals, and logoURI.
No API key	The token list is public. No registration, no rate limits, no RPC endpoint needed.

How it compares

No other Store actor targets Optimism Superchain Token List the same way, so the honest comparison is with the alternatives teams actually weigh.

	Optimism Superchain Token List Scraper	Build it in-house	By hand
Setup	Run it now, zero config	Days of engineering	None, but hours per pull
When Optimism Superchain Token List changes	Maintained for you	You fix it	You re-learn the page
Proxies, retries, anti-bot	Built in	Your problem	Browser only
Output	Fixed JSON schema, CSV/Excel export	Whatever you build	Copy-paste
Cost	Pay per result	Engineering time	Analyst hours

Configure the run

Drive the Actor with an optional chain id, token symbol, or name substring, alone or together, and filters run as each token is read so only matches reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

{
 "maxItems": 10
}

A larger pull:

{
 "maxItems": 200
}

Pricing

Pay-per-result: $0.0085 per result collected. You pay only for the results written to your dataset.

Results collected	Approximate cost
100 results	$0.85
1,000 results	$8.50
10,000 results	$85.00

New Apify accounts start with $5 in free credit.

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

1. Create a free Apify account with $5 in credit.
2. Open the Optimism Superchain Token List Scraper.
3. Set your inputs and any filters, then click Start.
4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to Optimism Superchain Token List through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/optimism-superchain-tokens-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting no results?

Check your filters. A chainId that has no tokens in the list, a symbol that does not exist, or a nameContains string with no matches will return an empty dataset. Try running without any filters first to see the full list.

The logoURI links are broken or return 404.

Logo URIs are provided by the token list maintainers and may point to external domains that change or go offline. The Actor returns the URI as-is. Consider downloading and re-hosting logos if you need reliable availability.

I set maxItems to 1000 but only got 500 results.

The Actor returns at most the number of tokens that match your filters. If only 500 tokens exist on the chain or match your symbol or name search, you will receive exactly 500 rows.

The token I need is missing from the results.

The Superchain token list is community-maintained and may not include every token. If a token is missing, it may not have been submitted to the list yet. Check the official GitHub repository to verify or submit an addition.

Can I get historical versions of the token list?

This Actor always fetches the current version. If you need a historical snapshot, you can run the Actor on a schedule and store each run's dataset, or clone the token list's GitHub repository at a specific commit.

FAQ

Question	Answer
What is the Optimism Superchain token list?	It is the official, community-maintained registry of token addresses, symbols, decimals, and logos for all chains built on the OP Stack, including OP Mainnet, Base, Zora, and others. It is the default token list used by the Optimism Bridge and many Superchain wallets.
Which chains are included in the Superchain token list?	The list covers Ethereum mainnet and every OP Stack chain that has submitted token entries, including OP Mainnet (chain id 10), Base (8453), Zora (7777777), Mode, and others. Use the chainId filter to target one chain.
Do I need an RPC endpoint or API key to scrape this?	No. The token list is a public JSON file hosted on GitHub. This Actor reads it directly without any blockchain RPC calls, API registration, or authentication.
What fields does each token row contain?	Every row returns the chain id, token contract address, name, symbol, number of decimals, and a logoURI pointing to the token's icon image.
Can I filter tokens by chain?	Yes. Set the chainId input to a specific EVM chain id like 10 for OP Mainnet or 8453 for Base, and the Actor returns only tokens deployed on that chain.
Can I search for a token by its symbol?	Yes. Use the symbol filter with a ticker like USDC or WETH. The match is case-insensitive, so usdc and USDC return the same results.
How many tokens can I collect in one run?	You can set maxItems up to 1,000,000. The full Superchain token list contains thousands of entries, and the Actor will return as many as you request, up to the total available.
Is the data live or cached?	The Actor fetches the latest version of the token list from the official GitHub repository on every run, so you always get the most current token entries.
Can I export the data to CSV or JSON?	Yes. Apify datasets can be exported to CSV, JSON, Excel, XML, and other formats directly from the run console or via API.
Does this Actor verify token contracts or check liquidity?	No. It returns the metadata exactly as published in the token list. It does not perform on-chain verification, liquidity checks, or security audits.

Related actors

• coinmarketcap-scraper: Use this if you need live price, market cap, and volume data to enrich the token metadata from the Superchain list.

Browse the full ParseForge collection for more scrapers.

🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by OP Labs PBC. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.