Curated, ready-to-run scripts that pull onchain data with HyperSync. Each one answers a real question, like how much USDC was minted on Ethereum this week or who holds a tokenized stock, and prints the answer in your terminal.
Pick the one closest to what you need, swap in your contract, chain or dates, and you've got the start of your own dashboard, backfill or pipeline. Each one also has a prompt you can paste into Claude Code or Cursor if you'd rather your agent did the editing.
- 69 examples across Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Monad, Gnosis, Ink, Arc, Robinhood Chain, HyperEVM, Tempo and Solana.
- Plain Python. Standard library only, so there's nothing to install and no node to run.
New to HyperSync? The hypersync-examples repo walks through the basics of the API first. Looking for live data behind a GraphQL API? See hyperindex-use-cases for HyperIndex indexers.
- Get a free API token at envio.dev/app/api-tokens.
- Clone the repo and run one.
git clone https://github.com/enviodev/hypersync-use-cases.git
cd hypersync-use-cases/stablecoins-and-payments/usdc-supply-ethereum
export ENVIO_API_TOKEN=your-token
python3 script.pyEvery folder has its own README with what we found, what the script pulls, how to point it at another chain or window, and how to check the numbers.
| Example | Chain | How to |
|---|---|---|
| usdc-supply-ethereum | Ethereum | Pull every USDC mint and burn on Ethereum and track supply day by day |
| rlusd-ethereum-supply | Ethereum | Rebuild Ripple USD (RLUSD) supply from every mint and burn |
| arc-usdc-mint-burn | Arc | Pull every USDC mint and burn on Arc, including Circle Gateway and CCTP |
| arc-stablecoins-30d | Arc | Track USDC and EURC supply on Arc over 30 days |
| monad-stablecoin-weekends | Monad | Pull every stablecoin transfer on Monad and compare weekdays with weekends |
| ousd-supply-by-chain | Ethereum, Base, Tempo | Track Open USD (OUSD) supply and holders on each chain |
| base-usdc-micropayments | Base | Pull every gasless USDC payment on Base and size it down to the cent |
| uniswap-stable-volume-by-chain | 22 EVM chains | Get Uniswap stablecoin-to-stablecoin volume on 22 chains |
| usdg-arbitrum-where-it-sits | Arbitrum | Find every USDG balance on Arbitrum and see how much sits in GMX markets, Morpho and wallets |
| etherfi-cash-card-payments | Optimism | Pull every ether.fi Cash card payment settled onchain |
| Example | Chain | How to |
|---|---|---|
| tokenized-stocks-ethereum | Ethereum | Track every Ondo Global Markets and xStocks token transfer on Ethereum |
| tokenized-circle-stock | EVM chains | Find tokenized Circle (CRCL) stock on every chain, by issuer |
| ondo-stocks-by-chain | Ethereum, BNB Chain, HyperEVM, Robinhood Chain | Pull every Ondo stock and ETF token transfer, by chain |
| ondo-stocks-robinhood | Robinhood Chain | Pull every Uniswap v4 swap in Ondo tokenized stock pools |
| uniswap-stock-tokens-after-hours | Robinhood Chain | Split stock token swaps on Uniswap by US market hours |
| pancakeswap-robinhood-stock-traders | Robinhood Chain | Count the wallets swapping stock tokens on PancakeSwap |
| aero-tokenized-stocks-base | Base | Get Coinbase tokenized stock volume on Aero, in and out of market hours |
| base-tokenized-stock-holders | Base | Find every holder of Coinbase tokenized stocks on Base |
| aave-v4-spcxc-base | Base | Track SPCXc holders and the Aave v4 tokenized stocks market on Base |
| pendle-strcx | Ethereum | Find every STRCx holder and how much sits in Pendle |
| Example | Chain | How to |
|---|---|---|
| blackrock-buidl-by-chain | EVM chains | Track BlackRock BUIDL supply on each chain from every mint and burn |
| ondo-intelligent-portfolios | Ethereum, BNB Chain | Track Ondo Intelligent Portfolios supply and holders |
| spiko-safo | Ethereum, Arbitrum, Polygon, Base | Track Spiko SAFO supply and holders by chain and share class |
| grove-basin-jtrsy | Ethereum | Pull every Grove Basin swap of JTRSY into USDC |
| paxg-on-morpho-base | Base | Track USDC borrowed against Paxos Gold (PAXG) on Morpho |
| Example | Chain | How to |
|---|---|---|
| aave-monad-tvl | Monad | Get Aave v3 TVL on Monad by asset from every transfer |
| aave-usdc-ethereum-weekly | Ethereum | Track weekly USDC deposits and borrows on Aave V3 Ethereum |
| aave-v4-avalanche | Avalanche | Pull every Aave v4 deposit on Avalanche, by asset and depositor |
| aave-v4-sentora-markets | Ethereum | Track supply and borrows in Sentora's Aave v4 markets, day by day |
| coinbase-borrow-morpho-base | Base | Track the Morpho markets behind Coinbase's crypto-backed loans |
| morpho-midnight-loans | Five chains | Pull every fixed-rate loan on Morpho Midnight |
| morpho-vaults-arc | Arc | Find every Morpho vault on Arc and the markets it lends to |
| usdg-on-morpho | Robinhood Chain, Arbitrum, Ethereum | Find every Morpho market lending Paxos USDG |
| robinhood-earn-usdg-vault | Robinhood Chain | Count depositors in the USDG vault behind Robinhood Earn |
| Example | Chain | How to |
|---|---|---|
| uniswap-robinhood-chain | Robinhood Chain | Pull every Uniswap v2, v3 and v4 swap on Robinhood Chain |
| uniswap-volatilepair-robinhood | Robinhood Chain | Get swaps, volume and LP fees for one Uniswap pool |
| uniswap-v4-hooks-ethereum | Ethereum | Find every Uniswap v4 pool with a hook on Ethereum |
| uniswap-v4-hooks-robinhood | Robinhood Chain | Find every Uniswap v4 pool and swap by hook |
| 1inch-aqua-strategies | 15 EVM chains | Pull every strategy created on 1inch Aqua |
| aero-pools-arbitrum | Arbitrum | Rank every Aero pool on Arbitrum by volume and liquidity |
| aero-robinhood-ethereum | Robinhood Chain, Ethereum | Track Aero DEX volume day by day on two chains |
| yieldbasis-weth-propamm | Ethereum | Compare Yield Basis pool volume and fees before and after oracle pricing |
| metric-first-month-ethereum | Ethereum | Pull every swap on Metric's pools, per day |
| ostium-markets-arbitrum | Arbitrum | Pull every Ostium position and group it by market |
| polymarket-election-day | Polygon | Get Polymarket trading volume by hour on US election day |
| polymarket-election-night | Polygon | Get Polymarket trading volume hour by hour on US election night |
| Example | Chain | How to |
|---|---|---|
| base-smart-accounts-gas-covered | Base | Count ERC-4337 smart accounts and how many had gas covered by a paymaster |
| active-addresses-without-dusting | EVM chains | Count daily active addresses with dusting filtered out |
| monad-biggest-apps | Monad | Rank Monad apps by transactions over 30 days |
| monad-volatility-day | Monad | Compare one day on Monad with a 30-day baseline, hour by hour |
| gnosis-biggest-protocols | Gnosis | Rank the busiest protocols on Gnosis Chain |
| ink-monthly-activity | Ink | Count Ink transactions and active addresses by month |
| polygon-october-fees | Polygon | Find which contracts paid the most gas on Polygon PoS |
| arbitrum-priority-fees | Arbitrum | Count Arbitrum transactions paying a priority fee, day by day |
| erc4337-user-operations-ethereum | Ethereum | Pull every ERC-4337 user operation on Ethereum |
| ethereum-approval-cleanups | Ethereum | Find every ERC-20 approval revoked on Ethereum |
| safe-growth | 14 chains | Count every Safe created, by month and chain |
| safe-shared-signer | Ethereum | Decode every new Safe's owners and find the most common signer |
| safenet-staking | Ethereum | Track SAFE staked in Safenet and active stakers week by week |
| circles-trust-gnosis | Gnosis | Count Circles v2 humans and trust links on Gnosis Chain |
| uni-new-holders | Ethereum | Count new UNI holders per day since 2020 |
| Example | Chain | How to |
|---|---|---|
| phantom-cash-supply | Solana | Track Phantom CASH stablecoin supply week by week |
| sofiusd-solana | Solana | Rebuild SoFiUSD supply on Solana from every mint and burn |
| huma-payfi-solana | Solana | Pull every Huma Institutional drawdown and repayment on Solana |
| jupiter-lend-stock-collateral | Solana | Pull every Jupiter Lend borrow position, grouped by collateral |
| backpack-stocks-solana | Solana | Track Backpack tokenized stock holders, mints and burns on Solana |
| tokenized-treasuries-solana | Solana | Track the supply of tokenized Treasury funds on Solana, day by day |
| kamino-rwa-collateral | Solana | Find real-world credit used as collateral on Kamino Lend |
| phoenix-perps-signups | Solana | Track Phoenix trading accounts and USDC deposits on Solana |
| metadao-launchpad-raises | Solana | Pull every MetaDAO launchpad raise on Solana |
| solana-durable-nonces | Solana | Count Solana transactions that use durable nonces |
Each example's README ends with a prompt written for that example. If you want something new, open the repo in Claude Code, Cursor or whatever agent you use and paste this:
Read README.md and two examples in this repo that are close to what I want, for
example usdc-supply-ethereum and aave-v4-avalanche. Then read the HyperSync docs
at https://docs.envio.dev/llms.txt.
Write a new example in its own folder that answers: <YOUR QUESTION>, on <CHAIN>.
Use the HyperSync endpoint for that chain from
https://docs.envio.dev/docs/HyperSync/hypersync-supported-networks, the Python
standard library only, and read my token from the ENVIO_API_TOKEN environment
variable. Run it on a short window first, print the result, then add a README
in the same format as the other examples.
Agents read docs better as plain text, so point yours at docs.envio.dev/llms.txt or the longer llms-full.txt.
What is HyperSync? It's Envio's blockchain data API. You ask for logs, transactions or blocks, it filters them on the server and sends back only the fields you want, so reading a chain's full history takes minutes rather than days. The overview has the details.
How do I get every ERC-20 transfer for a token?
Ask HyperSync for the token's Transfer logs from block 0 and keep going with next_block until you're caught up. usdc-supply-ethereum and rlusd-ethereum-supply both do exactly this and turn the transfers into supply.
Can I use this instead of eth_getLogs?
Yes. HyperSync hands back logs for huge block ranges in one request. And if your code already talks JSON-RPC, HyperRPC serves eth_getLogs and the other read methods from the same data, so you don't have to change anything.
Does it work on Solana? Yes. The Solana examples read instructions and token balance changes from HyperSync on Solana.
Which chains are supported? The full list is here. Moving most examples to another chain is a one-line change.
Do I need an SDK? No, the scripts just make HTTP requests. For bigger pipelines there are clients for Python, Rust and Node.js.
When should I use HyperIndex instead? A script is great when you want an answer or a one-off backfill. Reach for HyperIndex when you need the data kept up to date and served over GraphQL, and see hyperindex-use-cases for ready-to-run indexers.
- HyperSync overview
- HyperSync query reference
- HyperSync supported networks
- HyperSync on Solana
- HyperRPC
- HyperIndex and Envio Cloud
- Get an API token
- Envio Discord
MIT licensed. Got an idea for an example, or stuck on one? Come say hi in the Envio Discord.