🪙 Optimism Token List Scraper

🚀 Export the full Optimism cross-chain token list in seconds. Verified ERC-20 tokens with chain IDs, contract addresses, symbols, and decimals — direct from the public Optimism CDN.

🕒 Last updated. 2026-06-05 · 📊 9 fields per record · thousands of verified ERC-20 tokens across L1 Ethereum, Optimism, Base, and Mode · Public API · No login required

The Optimism Token List Scraper turns the Optimism Token List public endpoint into a clean, structured dataset. It queries the source live, normalizes the response into one row per record, and pushes the result into an Apify dataset you can download or pipe to your warehouse.

Thousands of verified ERC-20 tokens across L1 Ethereum, Optimism, Base, and Mode are covered in a single run, with stable field names and null-safe parsing.

🎯 Target Audience	💡 Primary Use Cases
🔌 DeFi devs	Bootstrap a token allowlist for swap UIs
📊 Data teams	Inventory every L2-bridged token
🤖 Bots	Hot-load token metadata at startup
🔍 Researchers	Audit which assets are canonical on each chain

📋 What the Optimism Token List Scraper does

• Calls the public Optimism Token List endpoint with the parameters you supply.
• Parses the response and flattens each record into a single dataset row.
• Casts numeric fields to numbers where applicable for clean spreadsheet imports.
• Surfaces rate-limit or upstream errors as a single-row error record instead of crashing.
• Exports to every Apify dataset format supported in the UI.

💡 Why it matters. The raw Optimism Token List response is great for API consumers but awkward for spreadsheets and BI tools. This actor normalizes the shape so the data drops straight into pandas, BigQuery, or a Google Sheet.

🎬 Full Demo

🚧 Coming soon.

⚙️ Input

Field	Type	Required	Description
chainId	integer	No	Filter by EVM chain ID (e.g. 1 = Ethereum, 10 = Optimism, 8453 = Base). Leave empty for all chains.
symbolFilter	string	No	Filter by symbol substring (case insensitive). Leave empty for all tokens.
maxItems	integer	No	Free users. 10. Paid users. up to 1,000,000. Prefill. 10.

Example 1.

{
  "chainId": 1,
  "symbolFilter": "example",
  "maxItems": 10
}

Example 2.

{
  "chainId": 1,
  "symbolFilter": "example",
  "maxItems": 50
}

⚠️ Good to Know. This actor calls the public Optimism Token List endpoint with no authentication required. Upstream rate limits apply; if the source returns a limit notice, you will see it as a single error record in your dataset.

📊 Output

Each record is a flat object. error is always last.

Field	Type	Description
🔹 chainId	string	Field from the Optimism Token List response.
🔹 address	string	Field from the Optimism Token List response.
🔹 name	string	Field from the Optimism Token List response.
🔹 symbol	string	Field from the Optimism Token List response.
🔹 decimals	string	Field from the Optimism Token List response.
🔹 logoURI	string	Field from the Optimism Token List response.
🔹 extensions	string	Field from the Optimism Token List response.
🔹 scrapedAt	string	Field from the Optimism Token List response.
🔹 error	string	Set if the upstream response was an error or rate-limit.

Sample record.

{
  "chainId": "sample_chainId",
  "address": "sample_address",
  "name": "sample_name",
  "symbol": "sample_symbol",
  "decimals": "sample_decimals",
  "logoURI": "sample_logoURI",
  "extensions": "sample_extensions",
  "scrapedAt": "sample_scrapedAt",
  "error": null
}

✨ Why choose this Actor

| 🆓 | Works with the public Optimism Token List endpoint. No API key, no signup. | | 🧹 | Clean field names, ready for BI tools. | | 🔢 | Numeric strings cast to real numbers where it makes sense. | | 🛟 | Upstream errors and rate limits surface as a clean error record. | | 🔌 | One-click export to every Apify dataset format. | | 💾 | Push to dataset, then pipe to BigQuery, Snowflake, Postgres, or Google Sheets. |

📈 How it compares to alternatives

Approach	Setup time	Clean shape	Pagination	Error handling
Roll your own fetch	30 min +	❌	manual	manual
Copy-paste from the browser	5 min, fragile	❌	❌	❌
This Actor	5 sec, no install	✅	✅	✅

🚀 How to use

1. Click Try for free.
2. Fill in the input (or leave defaults).
3. Click Start.
4. Within seconds, the dataset is ready for download or integration.

💼 Business use cases

📊 Analytics. Pipe records into your warehouse and join against internal data for cross-source dashboards.

🤖 Automation. Trigger this actor on a schedule, then push results to Slack, Airtable, or Google Sheets.

🧪 Research. Snapshot the public state of Optimism Token List on a date and archive it for reproducible studies.

📰 Editorial. Verify quotes, numbers, or records cited in stories with a one-click fresh pull.

🔌 Automating Optimism Token List Scraper

• Make / Zapier. Trigger this actor on a schedule, push results to Slack, Airtable, Google Sheets, or anywhere else.
• Cron schedule. Use the native Apify scheduler to run on any cadence.
• Webhooks. Get a POST to your endpoint the moment a run finishes.
• Pipe to BigQuery / Snowflake / Postgres. Native Apify integrations move datasets straight into your warehouse.

🌟 Beyond business use cases

🎓 Education. Build classroom datasets without paying for a commercial feed.

🧪 Personal research. Track changes in the source over time on your own schedule.

🤝 Non-profit and open data. Build public dashboards without writing client code.

🧰 Tinkering and prototyping. Wire up a fresh data feed in seconds to test a new chart or model.

🤖 Ask an AI assistant about this scraper

Pop this README into ChatGPT, Claude, or any AI assistant and ask it to map your specific workflow to the actor's inputs. The schema, examples, and field list above contain everything an LLM needs to design a working pipeline.

❓ Frequently Asked Questions

❓ Do I need an API key? No. This actor calls the public Optimism Token List endpoint with no authentication required.

❓ Is there a rate limit? The upstream source may rate-limit aggressive use. If you hit a limit, the actor pushes a single error record rather than crashing.

❓ Which formats can I download? Every format Apify's dataset UI supports.

❓ Are values cast to numbers? Where the source returns numeric strings for numeric fields, yes.

❓ How do you handle upstream errors? A single record with a populated error field is pushed, then the actor exits cleanly.

❓ Can I schedule runs? Yes. Use Apify's native scheduler, Make, Zapier, or cron.

❓ Is this scraping or API? API. The Optimism Token List endpoint is fully public; this actor only normalizes the response.

❓ Will the schema change? Core fields are stable. Optional fields surface as null when the source omits them.

❓ How fresh is the data? Each run hits the live endpoint, so the data is as fresh as the source allows.

❓ Can I filter the output? Yes. The input fields above let you narrow the result set before it lands in your dataset.

🔌 Integrate with any app

Apify ships native integrations with Make, Zapier, Slack, Discord, Google Drive, Google Sheets, Gmail, Airbyte, Keboola, Telegram, GitHub, and any REST API or webhook endpoint. Trigger runs from a calendar event, a form submission, a cron job, or pipe results straight into BigQuery, Snowflake, or a Postgres warehouse.

🔗 Recommended Actors

Actor	What it does
ParseForge OurAirports Scraper	Global airport database.
ParseForge Alpha Vantage Scraper	Stocks, FX, crypto, and indicators.
ParseForge CurseForge Mods Scraper	Public mod metadata from CurseForge.
ParseForge NBA Stats Scraper	Player and team stats from NBA.com.

💡 Pro Tip. Browse the complete ParseForge collection for 900+ production-grade scrapers across business intelligence, real estate, e-commerce, sports, finance, and public records.

---

Disclaimer. This actor scrapes only publicly available data. ParseForge is not affiliated with, endorsed by, or sponsored by any of the third-party services referenced. Users are responsible for complying with the target site's terms of service and applicable law. Create a free account w/ $5 credit.