ParseForge
L2BEAT Rollup TVL Scraper
parseforge/l2beat-rollup-tvl-scraper
Developer toolsAutomationOther
Scrapes L2BEAT rollup projects with total value locked, maturity stage, category, and links. Filter by layer type, rollup category, stage, and archived status. Returns a flat row per project.
- Total users
- 1
- Monthly active
- 0
- Total runs
- 87
- Bookmarked
- 0
- Rating
- Not rated yet
- Last modified
- 12 days ago
Overview
L2BEAT Rollup TVL Scraper
Scrape L2BEAT rollup TVL data for every Layer 2 and Layer 3 project, up to a million per run. Each row includes total value locked, canonical and external TVL, maturity stage, category, and project links. No API key. Export to CSV, JSON, Excel, or XML.
L2BEAT is the reference dashboard for Ethereum rollup activity, but its data lives behind a web UI with no public API. This actor reads the public project feeds directly, filters by layer type, rollup category, maturity stage, or archived status, and returns each match in one fixed schema.
| Who uses it | What they scrape L2BEAT for |
|---|---|
| Crypto analysts | Tracking which rollups are gaining or losing TVL week over week |
| DeFi researchers | Comparing canonical versus external TVL across Layer 2s |
| Investment funds | Monitoring maturity stages of rollup projects before allocating |
| Journalists | Pulling current TVL figures for articles about Ethereum scaling |
What it does
This Actor collects L2BEAT rollup projects by layer type, category, maturity stage, and archived status, and returns each one as a flat row.
- 📊 Layer type filter: choose Layer 2, Layer 3, or all types.
- 🏷️ Category filter: Optimistic Rollup, ZK Rollup, Validium, Optimium, or Other.
- 🧪 Maturity stage filter: Stage 0, Stage 1, Stage 2, or Not applicable.
- 🗄️ Archived projects: optionally include projects L2BEAT has archived.
- 🔢 Max rollups: cap the number of projects returned per run.
Results export to CSV, JSON, Excel, or XML, or straight from the API.
What you can do with L2BEAT data
📈 Track TVL trends.
A crypto analyst runs the actor daily for all Layer 2 projects and charts total value locked over time to spot growth or decline.
🔍 Compare rollup categories.
A DeFi researcher filters by ZK Rollup and Optimistic Rollup to compare canonical TVL and see which technology is attracting more capital.
🧪 Monitor maturity stages.
An investment fund filters by Stage 1 and Stage 2 to build a watchlist of rollups that have reached higher security guarantees.
🗄️ Audit archived projects.
A journalist includes archived projects to report on rollups that have shut down or been deprecated, with their final TVL figures.
Why choose this scraper
| What you get | |
|---|---|
| No API key | Reads the public L2BEAT feeds directly, no registration or rate limits. |
| Fixed schema | Every project returns the same flat row, ready for analysis. |
| Filter before export | Narrow by type, category, stage, or archived status before data is written. |
| Export anywhere | CSV, JSON, Excel, or XML, or push to Apify storage. |
How it compares
No other Store actor targets L2BEAT the same way, so the honest comparison is with the alternatives teams actually weigh.
| L2BEAT Rollup TVL Scraper | Build it in-house | By hand | |
|---|---|---|---|
| Setup | Run it now, zero config | Days of engineering | None, but hours per pull |
| When L2BEAT 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 from layer type, rollup category, maturity stage, and archived status, alone or together, and filters run as each project 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.01 per result collected. You pay only for the results written to your dataset.
| Results collected | Approximate cost |
|---|---|
| 100 results | $1.00 |
| 1,000 results | $10.00 |
| 10,000 results | $100.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 L2BEAT Rollup TVL 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 L2BEAT 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/l2beat-rollup-tvl-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 Category to ZK Rollup and Stage to Stage 2, only projects that match both will be returned. Try clearing filters one at a time to see which one is too restrictive.
Why are archived projects missing?
By default, archived projects are excluded. Set Include Archived Projects to true in the input to include them.
Why is the run slow?
The actor reads the L2BEAT feeds directly, so speed depends on L2BEAT's response time. If you set a very high Maximum rollups, the run may take longer. Try reducing the cap.
Why do I see duplicate projects?
L2BEAT sometimes lists the same project under multiple categories. The actor returns each entry as a separate row. You can deduplicate in your downstream processing by project name.
Why is the TVL value different from what I see on L2BEAT?
TVL changes constantly. The actor captures the value at the moment of the run. If you compare later, the number may have moved. Run the actor again to get the latest figure.
FAQ
| Question | Answer |
|---|---|
| What is L2BEAT? | L2BEAT is a public analytics and research website that tracks Ethereum Layer 2 and Layer 3 scaling projects, including their total value locked, maturity stage, and risk analysis. |
| Does this actor need an API key? | No. It reads the public L2BEAT project feeds directly, so there is no registration, OAuth, or rate limit to manage. |
| What data does each row contain? | Each row includes the project name, layer type, category, maturity stage, total value locked, canonical TVL, external TVL, and links to the project page and social profiles. |
| Can I filter by rollup category? | Yes. Use the Category input to select Optimistic Rollup, ZK Rollup, Validium, Optimium, or Other. Leave it empty to include all categories. |
| Can I include archived projects? | Yes. Set Include Archived Projects to true to add projects that L2BEAT has archived. By default they are excluded. |
| What is the difference between canonical and external TVL? | Canonical TVL is value locked in the rollup's native bridge contracts. External TVL is value locked through third-party bridges. L2BEAT reports both, and this actor returns both fields. |
| How many projects can I scrape in one run? | Use the Maximum rollups input to set a cap. The default is 10, and you can set it up to 1,000,000. |
| What export formats are supported? | You can export the dataset as CSV, JSON, Excel, or XML, or push it to Apify storage for further processing. |
| How often should I run this actor? | TVL changes with every block, so daily runs are common for trend tracking. You can schedule the actor in Apify to run automatically. |
| Does this actor scrape historical TVL data? | No. It returns the current TVL and project metadata from L2BEAT at the time of the run. For historical data, you would need to run it repeatedly and store snapshots. |
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 L2BEAT. 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 |
|---|---|---|---|
| maxItems | integer | Maximum number of rollups to collect per run. | 10 |
| type | string (3 options) | Filter projects by layer type. Leave empty to include every type. | not set |
| category | string (6 options) | Filter projects by rollup category. Leave empty to include every category. | not set |
| stage | string (5 options) | Filter projects by L2BEAT maturity stage. Leave empty to include every stage. | not set |
| includeArchived | boolean | Include projects that L2BEAT has archived. Off by default. | false |
Pricing
from $8.00 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| result | Single result in the default dataset. | $0.008 to $0.01 |
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~l2beat-rollup-tvl-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.