ParseForge
Base Token List Scraper
parseforge/base-org-token-list-scraper
AutomationIntegrationsDeveloper tools
Scrapes the Base Token List for ERC-20 tokens on Base. Returns chain ID, symbol, name, decimals, and logo URI for each token. Filter by chain ID or symbol, export to CSV, JSON, Excel, or XML.
- Total users
- 2
- Monthly active
- 1
- Total runs
- 86
- Bookmarked
- 0
- Rating
- Not rated yet
- Last modified
- 9 days ago
Overview
Base Token List Scraper
Scrape the Base Token List for every token on Base, up to a million per run. Each token comes with its chain ID, symbol, name, decimals, and logo URI. No login or API key. Export to CSV, JSON, Excel, or XML.
The Base Token List is the canonical registry of ERC-20 tokens on the Base network, but querying it manually or via RPC calls is slow and rate-limited. This Actor reads the public token list directly, filters by chain ID or symbol, and returns each match in one fixed schema.
| Who uses it | What they scrape Base Token List for |
|---|---|
| DeFi developers | Which tokens are officially recognized on Base for their dApp's token picker |
| Crypto analysts | The full set of Base tokens to monitor for liquidity or listing trends |
| Wallet builders | A clean token list to preload into their Base wallet interface |
| Market researchers | Token metadata for Base ecosystem reports and dashboards |
What it does
This Actor collects tokens from the Base Token List, filtered by chain ID or symbol, and returns each one as a flat row.
- 🔗 Chain ID filter: restrict results to a specific EVM chain, such as 8453 for Base or 1 for Ethereum.
- 🔤 Symbol filter: match tokens by symbol substring, case insensitive, like 'usd' to find all stablecoins.
- 📦 Bulk export: collect up to 1,000,000 tokens per run and export to CSV, JSON, Excel, or XML.
Results export to CSV, JSON, Excel, or XML, or straight from the API.
What you can do with Base Token List data
🪙 Build a token picker for a Base dApp.
A DeFi developer runs the Actor with chainId 8453 and maxItems 1000 to get the official Base token list, then imports the CSV into their frontend for a dropdown menu.
📊 Monitor new token listings on Base.
A crypto analyst schedules the Actor daily with no filters to capture the full list, then diffs the output against the previous run to spot newly added tokens.
🔍 Find all stablecoins on Base.
A researcher sets symbolFilter to 'usd' and chainId 8453 to collect every USD-pegged token, then uses the decimals field to normalize prices across sources.
🧪 Seed a test environment with real token data.
A QA engineer runs the Actor with maxItems 50 to get a small sample of Base tokens, then loads the JSON into a local blockchain fork for integration tests.
Why choose this scraper
| What you get | |
|---|---|
| No API key | Reads the public token list directly, no registration or rate limits |
| Fixed schema | Every token returns the same flat fields: chainId, symbol, name, decimals, logoURI |
| Filter early | Chain and symbol filters run as tokens are read, so only matches reach your dataset |
How it compares
This Actor is the only one that reads the Base Token List directly and returns token metadata in a flat schema. The competitors below scrape different sources or return unstructured content.
| Feature | ParseForge | Website Content Crawler | TikTok Data Extractor |
|---|---|---|---|
| Scrapes Base Token List | Yes | Not listed | Not listed |
| Returns token metadata (chain ID, symbol, decimals) | Yes | Not listed | Not listed |
| Filter by chain ID | Yes | Not listed | Not listed |
| Filter by symbol substring | Yes | Not listed | Not listed |
| Export to CSV, JSON, Excel, XML | Yes | Not listed | Not listed |
| No API key required | Yes | Not listed | Not listed |
Configure the run
Drive the Actor with an optional chain ID and symbol substring, and set a maximum number of tokens to collect per run. 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
- Create a free Apify account with $5 in credit.
- Open the Base Token List Scraper.
- Set your inputs and any filters, then click Start.
- 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 Base 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/base-org-token-list-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. If you set a chainId that is not present in the token list, or a symbolFilter that matches nothing, the Actor returns an empty dataset. Try clearing the filters and running again.
Why did the run stop before reaching maxItems?
The Actor stops when it has read all tokens in the list, even if that number is less than maxItems. The token list has a finite size, so maxItems is only an upper bound.
Why is the logoURI empty for some tokens?
Some tokens in the list do not have a logo entry. The Actor returns an empty string for those, which is normal.
Can I get tokens from Ethereum using this Actor?
Yes. Set chainId to 1 to get tokens from the Ethereum list, or leave chainId empty to get tokens from all chains included in the source list.
FAQ
| Question | Answer |
|---|---|
| What is the Base Token List? | It is the canonical JSON registry of ERC-20 tokens on the Base network, maintained by the Base team. Each entry includes the token's chain ID, symbol, name, decimals, and logo URI. |
| Do I need an API key or authentication? | No. The Actor reads the public token list directly, so there is no registration, OAuth, or rate limit. |
| Can I filter by chain ID? | Yes. Set the chainId input to any EVM chain ID, such as 8453 for Base or 1 for Ethereum. Leave it empty to get tokens from all chains in the list. |
| Can I filter by token symbol? | Yes. The symbolFilter input matches any token whose symbol contains the given substring, case insensitive. For example, 'usd' matches USDC, USDbC, and DAI. |
| How many tokens can I collect in one run? | You can set maxItems up to 1,000,000. The Actor stops after reaching that number, so you control the size of your dataset. |
| What output formats are supported? | The Actor exports to CSV, JSON, Excel, and XML. You can choose the format in the run settings or download from the dataset. |
| Does the Actor return token logos? | Yes. Each token includes a logoURI field with a URL to the token's icon, which you can use directly in your UI. |
| Is the data live or cached? | The Actor fetches the token list at the start of each run, so you always get the current published version. |
| Can I schedule this Actor to run daily? | Yes. Use Apify's scheduler to run it at any interval, then compare outputs to track changes in the token list. |
| What is the difference between this and the Optimism Token List Scraper? | This Actor is configured for the Base Token List by default, but you can set chainId to 10 to scrape the Optimism list as well. The underlying logic is the same. |
Related actors
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 Base. 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.
Input
| Field | Type | What it does | Default |
|---|---|---|---|
| chainId | integer | Filter by EVM chain ID (e.g. 1 = Ethereum, 10 = Optimism, 8453 = Base). Leave empty for all chains. | not set |
| symbolFilter | string | Filter by symbol substring (case insensitive). Leave empty for all tokens. | not set |
| maxItems | integer | Maximum number of tokens to collect per run. | 10 |
Pricing
from $7.50 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| result | Single result in the default dataset. | $0.0075 to $0.0085 |
Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.
API
One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.
curl -X POST "https://api.apify.com/v2/acts/parseforge~base-org-token-list-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"helloWorld": 123
}' Examples
Input that runs as-is.
{
"helloWorld": 123
} Reviews
No reviews yet. Be the first.
Issues
We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.
Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.