Blockscout

Docs

• News Highlights: News, media coverage, and major announcements related to Blockscout.
• Newsletter & Blog
• Chains Using Blockscout: List of projects and links
• Features: Blockscout is a full-featured, open-source blockchain explorer
• Funding: Information about Blockscout funding sources, grants, and opportunities for support.
• Partners & Integrations: Blockscout featured integrations
• RaaS Providers: Rollup-as-a-Service Providers using Blockscout
• Vera: Verifier Alliance
• Roadmap: Upcoming enhancements, features, and strategic plans for Blockscout.
• Get a bundler by address hash: Retrieves a bundler by its address hash.
• Get a factory by address hash: Retrieves a factory by its address hash.
• Get a human-readable, LLM-based user operation summary: Retrieves a human-readable summary of what a user operation did, presented in natural language.
• Get a paymaster by address hash: Retrieves a paymaster by its address hash.
• Get a user operation by hash: Retrieves a user operation by its hash.
• Get an account abstraction wallet by address hash: Retrieves an account abstraction wallet by its address hash.
• Get the status of the account abstraction microservice: Retrieves the status of the account abstraction microservice.
• List of account abstraction wallets: Retrieves a list of account abstraction wallets.
• List of recent bundles: Retrieves a list of recent bundles.
• List of recent user operations: Retrieves a list of recent user operations.
• List of top bundlers: Retrieves a list of top bundlers.
• List of top paymasters: Retrieves a list of top paymasters.
• List of top wallet factories: Retrieves a list of top wallet factories.
• Get a List of Internal Transactions: Returns up to a maximum of 10,000 internal transactions. Also available through a GraphQL 'transaction' query.
• Get a List of Transactions by Address: Returns up to a maximum of 10,000 transactions for a given address. Also available through a GraphQL 'address' query.
• Get Balance for Multiple Addresses in a Single Call: Returns the balance of multiple accounts from a list of addresses (max 20 addresses)
• Get ERC-1155 Token Transfer Events by Address: Returns ERC-1155 (multi-token) transfer events
• Get ERC-20 Token Balance for a Single Address: Returns the token balance for a specific token contract and address
• Get ERC-20 Token Transfer Events by Address: Returns up to a maximum of 10,000 ERC-20 token transfer events. Also available through the GraphQL token_transfers query.
• Get ERC-404 Token Transfer Events by Address: Returns ERC-404 (hybrid fungible/non-fungible) transfer events
• Get ERC-721 Token Transfer Events by Address: Returns ERC-721 (NFT) token transfer events
• Get ETH Balance (JSON-RPC Format): Mimics Ethereum JSON RPC's eth_getBalance
• Get List of Blocks Mined by Address: Returns list of blocks mined by a given address.
• Get Native Token Balance for a Single Address: Returns the native token balance of a given address. Results are returned in wei. Many chains use their own native tokens (e.g., ETH on Ethereum, xDai on Gnosis).
• Get Pending Transactions for an Address: Returns pending transactions for a given address
• List Accounts and Native Balances: Lists accounts and native balances, sorted ascending by the time they were first seen
• Export Celo election rewards as CSV: Exports Celo election rewards for a specific address as a CSV file.
• Export internal transactions as CSV: Exports internal transactions for a specific address as a CSV file.
• Export logs as CSV: Exports logs for a specific address as a CSV file.
• Export token transfers as CSV: Exports token transfers for a specific address as a CSV file.
• Export transactions as CSV: Exports transactions for a specific address as a CSV file.
• Get activity count stats for a specific address: Retrieves count statistics for an address, including transactions, token transfers, gas usage, and validations.
• Get counters for address tabs: Retrieves counters for various address-related entities (max counter value is 51).
• Get daily native coin balance snapshots for an address from previous 10 days: Retrieves daily snapshots of native coin balance for a specific address. Useful for generating balance-over-time charts.
• Get native coin balance history for an address showing all balance changes: Retrieves historical native coin balance changes for a specific address, tracking how an address's balance has changed over time.
• List addresses holding native coins sorted by balance - top accounts: Retrieves a paginated list of addresses holding the native coin, sorted by balance.
• List all internal transactions involving a specific address: Retrieves all internal transactions involving a specific address, with optional filtering for internal transactions sent from or to the address.
• List all token balances held by a specific address: Retrieves all token balances held by a specific address, including ERC-20, ERC-721, ERC-1155, and ERC-404 tokens.
• List Beacon Deposits for a specific address: Retrieves Beacon deposits for a specific address.
• List blocks validated (mined) by a specific validator/miner address: Retrieves blocks that were validated (mined) by a specific address. Useful for tracking validator/miner performance.
• List Celo election rewards for a specific address: Retrieves Celo election rewards for a specific address.
• List event logs emitted by or involving a specific address: Retrieves event logs emitted by or involving a specific address.
• List NFTs owned by a specific address with optional type filtering: Retrieves a list of NFTs (non-fungible tokens) owned by a specific address, with optional filtering by token type.
• List NFTs owned by an address grouped by collection/project: Retrieves NFTs owned by a specific address, organized by collection. Useful for displaying an address's NFT portfolio grouped by project.
• List token balances for an address with pagination and type filtering: Retrieves token balances for a specific address with pagination and filtering by token type. Useful for displaying large token portfolios.
• List token transfers involving a specific address with filtering options: Retrieves token transfers involving a specific address, with optional filtering by token type, direction, and specific token.
• List transactions involving a specific address with to-from filtering: Retrieves transactions involving a specific address, with optional filtering for transactions sent from or to the address.
• List validator withdrawals involving a specific address: Retrieves withdrawals involving a specific address, typically for proof-of-stake networks supporting validator withdrawals.
• Retrieve detailed information about a specific address or contract: Retrieves detailed information for a specific address, including balance, transaction count, and metadata.
• Export advanced-filter results as CSV: Streams the items matching the advanced filter criteria as a CSV file. When asynchronous CSV export is enabled on the deployment, returns 202 Accepted with a request_id that can be polled via /api/v2/csv-exports/{request_id}; otherwise the CSV body is streamed inline.
• List known contract methods: Returns a list of known contract methods. When the q parameter is provided, searches for a single method by its 4-byte selector or name. Without q, returns the default list of popular methods.
• List transactions, internal transactions and token transfers matching the advanced filter criteria: Returns a paginated, mixed list of activity — native value transfers, internal transactions and token transfers — filtered by transaction type, contract method, time window, address relations, value range and/or token contract. The response also echoes the resolved human-readable names of the method…
• Get batch by AnyTrust data hash.: Retrieves an Arbitrum batch associated with the given AnyTrust data hash. By default, returns the most recently associated batch. When type=all, returns a paginated list of all batches referencing this data hash.
• Get batch by Celestia blob reference.: Retrieves an Arbitrum batch whose data availability blob is identified by the given Celestia block height and transaction commitment hash.
• Get batch by EigenDA data hash.: Retrieves an Arbitrum batch associated with the given EigenDA data hash. By default, returns the most recently associated batch. When type=all, returns a paginated list of all batches referencing this data hash.
• Get batch by number.: Retrieves detailed information about an Arbitrum batch by its number.
• Get batches count.: Retrieves the total count of Arbitrum batches committed to the Parent chain.
• Get claim data for a withdrawal.: Returns the ABI-encoded calldata and outbox contract address required to execute a Rollup withdrawal on the Parent chain.
• Get cross-chain messages count.: Retrieves the total count of Arbitrum cross-chain messages for the specified direction.
• Get the latest batch number.: Retrieves the number of the most recent Arbitrum batch submitted to the Parent chain. Returns 0 if no batches exist.
• Get withdrawal messages for a transaction.: Returns the list of Rollup withdrawal messages (L2ToL1Tx events) emitted by the given transaction.
• List batches.: Retrieves a paginated list of Arbitrum batches committed to the Parent chain.
• List committed batches on the main page.: Retrieves a list of Arbitrum batches that have been committed to the Parent chain, displayed on the main page.
• List cross-chain messages.: Retrieves a paginated list of Arbitrum cross-chain messages filtered by the specified direction.
• List recent Parent chain to Rollup messages on the main page.: Retrieves the most recent relayed messages from Parent chain to Rollup, displayed on the main page.
• Gets total count of beacon deposits: Retrieves the total count of beacon deposits.
• Lists all beacon deposits: Retrieves a paginated list of all beacon deposits.
• Get Block Number by Timestamp: Returns the block number that was mined at a certain timestamp
• Get Block Reward by Block Number: Returns the block reward and uncle block rewards when applicable
• Get Estimated Block Countdown Time by Block Number: Returns the estimated time remaining, in seconds, until a certain block is mined
• Get Latest Block Number (JSON-RPC Format): Mimics Ethereum JSON RPC's eth_blockNumber
• Get countdown information for a target block number: Calculates the estimated time remaining until a specified block number is reached based on current block and average block time.
• List beacon deposits in a specific block: Retrieves beacon deposits included in a specific block with pagination support.
• List blocks with optional filtering by block type: Retrieves a paginated list of blocks with optional filtering by block type.
• List internal transactions in a specific block: Retrieves internal transactions included in a specific block with optional filtering by type and call type.
• List L2 blocks in a Scroll batch: Retrieves L2 blocks that are bound to a specific Scroll batch number.
• List L2 blocks in an Arbitrum batch: Retrieves L2 blocks that are bound to a specific Arbitrum batch number.
• List L2 blocks in an Optimism batch: Retrieves L2 blocks that are bound to a specific Optimism batch number.
• List transactions and tx details included in a specific block: Retrieves transactions included in a specific block, ordered by transaction index.
• List validator withdrawals including amounts, index and receiver details processed in a specific block: Retrieves withdrawals processed in a specific block (typically for proof-of-stake networks).
• Retrieves detailed information for a specific block identified by its number or hash.: Retrieves detailed information for a specific block, including transactions, internal transactions, and metadata.
• Get apiv1celestiablob: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• Get apiv1celestial2batchmetadata: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• If the requested service is unknown, the call will fail with status NOT_FOUND.: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• Get Celo epoch details.: Retrieves detailed information about a Celo epoch.
• List Celo epoch election rewards.: Retrieves a paginated list of election rewards for a Celo epoch and reward type.
• List Celo epochs.: Retrieves a paginated list of Celo epochs.
• Celo chain configuration: Returns Celo-specific configuration (l2 migration block).
• CSV export limits: Returns configured limits for CSV export endpoints.
• Get backend environment configuration: Returns non-secret backend environment variables in the snake case (e.g., chain_type).
• Get backend version: Returns application backend version string.
• Indexer configuration: Returns config of indexer.
• Public metrics configuration: Returns update period / configuration for public metrics.
• Smart contract languages list: Returns list of smart contract languages supported by the database schema.
• Uncompleted background migrations: Returns list of background migrations that are not yet completed.
• Check Proxy Verification Status: Returns status of a proxy contract verification attempt.
• Check Verification Status: Returns status of a verification attempt. guid is received from verify or verifysourcecode methods.
• Get Contract ABI for Verified Contract: Returns the Contract Application Binary Interface (ABI) of a verified smart contract. Also available through a GraphQL 'addresses' query.
• Get Contract Creator and Creation Transaction Hash: Returns contract creator address and transaction hash (up to 10 contracts per request)
• Get Contract Source Code for Verified Contract: Returns the Solidity source code of a verified smart contract. Also available through a GraphQL 'addresses' query.
• Get List of Contracts: Returns list of contracts sorted by creation time. Can filter by verification status.
• Verify Contract via Sourcify: Verify a contract through Sourcify. If already verified on Sourcify fetches from repo.
• Verify Contract with Source Code: Verify a contract with its source code and compilation information. Returns a guid for checking verification status.
• Verify Contract with Standard JSON Input: Verify a contract using Standard JSON Input or flattened source code.
• Verify Proxy Contract: Verify that a contract is a proxy contract pointing to an implementation.
• Verify Vyper Contract: Verify a Vyper contract with its source code and compilation information.
• Get CSV export: Gets a CSV export by UUID
• Ethereum JSON-RPC endpoint: Single endpoint for all standard Ethereum JSON-RPC 2.0 methods. Send a POST request with a JSON body specifying the method and params.
• get account abstraction indexing status: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get address coin balance history: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get address coin balance history by day: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get address counters: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get address info: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get address internal transactions: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get address logs: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get address token transfers: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get address transactions: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get address withdrawals: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get all tokens balances for the address: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get block info: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get block transactions: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get block withdrawals: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get blocks: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get blocks validated by address: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get human-readable transaction summary: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get indexing status: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get internal transactions: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get json rpc url: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get list of NFT owned by address: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get list of NFT owned by address, grouped by collection: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get main page blocks: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get main page transactions: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get market chart: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get native coin holders list: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get NFT instance by id: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get NFT instances: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get smart contract: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get stats counters: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get token holders: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get token holders: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get token info: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get token instance holders: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get token token transfers: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get token transfers: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get tokens list: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get transaction info: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get transaction internal transactions: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get transaction logs: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get transaction raw trace: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get transaction state changes: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get transaction token transfers: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get transactions: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get transactions chart: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get transfers count of NFT instance: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get transfers of NFT instance: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get verified smart contracts: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get verified smart contracts counters: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• get withdrawals: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• List internal transactions generated during smart contract execution: Retrieves a paginated list of internal transactions. Internal transactions are generated during contract execution and not directly recorded on the blockchain.
• Get block number by time stamp: Returns the block number created closest to a provided timestamp.
• Get Event Logs by Address and/or Topic(s): Event logs for an address and topic. Use and/or with the topic operator to specify topic retrieval options when adding multiple topics. Up to a maximum of 1,000 event logs.
• Get the latest block number: Returns the latest block number as a hex-encoded string in a JSON-RPC 2.0 response.
• Get Event Logs by Address/Topics/Block Range: Returns event logs for an address and topic combination. Up to a maximum of 1,000 event logs. Use topic operators (and/or) to specify topic retrieval options.
• Check if indexing is finished with indexing ratio: Retrieves the current status of blockchain data indexing by the BlockScout instance.
• Last 6 transactions from the current user's watchlist: Retrieves a list of last 6 transactions from the current user's watchlist.
• Retrieve recent blocks as displayed on Blockscout homepage: Retrieves a limited set of recent blocks for display on the main page or dashboard.
• Retrieve recent transactions as displayed on Blockscout homepage: Retrieves a limited set of recent transactions displayed on the home page.
• List of MUD world system ABI methods.: Retrieves a list of MUD system ABI methods registered in the specific MUD world.
• List of MUD world systems.: Retrieves a list of MUD systems registered in the specific MUD world.
• List of MUD world table records.: Retrieves a paginated list of records in the specific MUD world table.
• List of MUD world tables.: Retrieves a paginated list of MUD tables in the specific MUD world.
• List of MUD worlds.: Retrieves a paginated list of MUD worlds with basic stats.
• Number of known MUD world table records.: Retrieves the total number of records in the specific MUD world table.
• Number of known MUD world tables.: Retrieves the total number of known MUD tables in the specific MUD world.
• Number of known MUD worlds.: Retrieves the total number of known MUD worlds.
• Single MUD world table record.: Retrieves a single record in the specific MUD world table.
• Batch by celestia blob.: Retrieves batch detailed info by the given celestia blob metadata (height and commitment).
• Batch by its number.: Retrieves batch detailed info by the given number.
• List batches.: Retrieves a paginated list of batches.
• List deposits.: Retrieves a paginated list of deposits.
• List deposits on the main page.: Retrieves a list of deposits for the main page.
• List games.: Retrieves a paginated list of games.
• List output roots.: Retrieves a paginated list of output roots.
• List withdrawals.: Retrieves a paginated list of withdrawals.
• Number of batches in the list.: Retrieves a size of the batch list.
• Number of deposits in the list.: Retrieves a size of the deposits list.
• Number of games in the list.: Retrieves a size of the games list.
• Number of output roots in the list.: Retrieves a size of the output roots list.
• Number of withdrawals in the list.: Retrieves a size of the withdrawals list.
• Delete adminapiv1offers secrets
• Get adminapiv1codes
• Get adminapiv1distributions
• Get adminapiv1networks
• Get adminapiv1networks 1
• Get adminapiv1offers redemptions
• Get adminapiv1offers secrets
• Get adminapiv1users
• Get adminapiv1users 1
• Patch adminapiv1codes
• Patch adminapiv1networks
• Patch adminapiv1offers
• Post adminapiv1codes
• Post adminapiv1distribute
• Post adminapiv1networks
• Post adminapiv1offers
• Post adminapiv1offers secrets
• Post adminapiv1users code
• re-fetch token instance metadata: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• Batch by its number.: Retrieves batch info by the given number.
• List batches.: Retrieves a paginated list of batches.
• List deposits.: Retrieves a paginated list of deposits.
• List withdrawals.: Retrieves a paginated list of withdrawals.
• Number of batches in the list.: Retrieves a size of the batch list.
• Number of deposits in the list.: Retrieves a size of the deposits list.
• Number of withdrawals in the list.: Retrieves a size of the withdrawals list.
• search: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• search redirect: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• Check if search query should redirect to a specific entity page: Checks if a search query redirects to a specific entity page rather than showing search results.
• Quick (unpaginated) search: Performs a quick, unpaginated search for short queries.
• Search for tokens, addresses, contracts, blocks, or transactions by identifier: Performs a unified search across multiple blockchain entity types including tokens, addresses, contracts, blocks, transactions and other resources.
• Search for tokens, addresses, contracts, blocks, or transactions by identifier: Performs a unified search across multiple blockchain entity types including tokens, addresses, contracts, blocks, transactions and other resources.
• Audit reports list: Returns audit reports for a given smart contract address.
• Get count statistics (new & newly verified) for deployed smart contracts: Retrieves count statistics for smart contracts, including total contracts, verified contracts, and new contracts in the last 24 hours.
• List verified smart contracts with optional filtering options: Retrieves a paginated list of verified smart contracts with optional filtering by proxy status or programming language.
• Retrieve detailed information about a verified smart contract: Retrieves detailed information about a specific verified smart contract, including source code, ABI, and deployment details.
• Submit audit report: Submits an audit report for a given smart contract address.
• Get daily closing price and market cap for native coin: Retrieves time series data of market information (daily closing price, market cap) for rendering charts.
• Get daily transaction counts: Retrieves time series data of daily transaction counts for rendering charts.
• Get ERC-20 or ERC-721 Token Total Supply: Returns the total supply of an ERC-20 or ERC-721 token by contract address
• Get Native Coin Price: Returns latest price of native coin in USD and BTC.
• Get Native Token Price: Returns the price of the native token in USD and BTC
• Get Total Coin Supply from DB: Returns total coin supply from database minus burnt tokens.
• Get Total Supply from Exchange: Returns total supply in Wei from exchange data.
• Get Total Supply of Native Token: Returns the total supply of the native token (e.g., ETH, xDai)
• Get Total Transaction Fees: Returns total transaction fees in Wei paid by users to validators per day.
• Retrieve blockchain network statistics and metrics: Retrieves blockchain network statistics including total blocks, transactions, addresses, average block time, market data, and network utilization.
• Retrieve hot smart-contracts: Retrieves paginated list of hot smart-contracts
• Secondary coin market history chart data: Returns market history for the secondary coin used for charting.
• token balances with filtering and pagination: Deprecation Notice: Per instance endpoints will be deprecated soon in favor of PRO API endpoints. Please see the PRO API reference page for information.
• List token transfers across all token types (ERC-20, ERC-721, ERC-1155): Retrieves a paginated list of token transfers across all token types (ERC-20, ERC-721, ERC-1155).
• Get Bridged Tokens List: Returns array of bridged token information from native bridge application.
• Get Token Holders: Returns an array of token holder accounts and amounts held for a specified token
• Get Token Info: Returns info on name, symbol, supply and type for a token contract address
• Export token holders as CSV: Exports the holders of a specific token as a CSV file.
• Get holder and transfer count statistics for a specific token: Retrieves count statistics for a specific token, including holders count and transfers count.
• Get total number of ownership transfers for a specific NFT: Retrieves the total number of transfers for a specific NFT instance. Useful for determining how frequently an NFT has changed hands.
• List addresses holding a specific token sorted by balance: Retrieves addresses holding a specific token, sorted by balance. Useful for analyzing token distribution.
• List current holders of a specific NFT: Retrieves current holders of a specific NFT instance. For ERC-721, this will typically be a single address. For ERC-1155, multiple addresses may hold the same token ID.
• List individual NFT instances for a token contract: Retrieves instances of NFTs for a specific token contract. This endpoint is primarily for ERC-721 and ERC-1155 tokens.
• List ownership transfer history for a specific NFT: Retrieves transfer history for a specific NFT instance, showing ownership changes over time.
• List token transfers for a specific token instance: Retrieves token transfers for a specific token instance (by token address and token ID).
• List tokens with optional filtering by name, symbol, or type: Retrieves a paginated list of tokens with optional filtering by name, symbol, or type.
• Retrieve detailed information about a specific NFT: Retrieves detailed information about a specific NFT instance, identified by its token contract address and token ID.
• Retrieve detailed information about a specific token: Retrieves detailed information for a specific token identified by its contract address.
• Trigger a refresh of metadata for a specific NFT: Triggers a refresh of metadata for a specific NFT instance. Useful when the NFT's metadata has been updated but is not yet reflected in the BlockScout database.
• Trigger metadata refetch for a token's NFT collection: Triggers a metadata refetch for a token's NFT collection (by token address). Requires API key.
• Get Transaction Execution Status: Returns transaction execution status with error description if applicable. Also available through a GraphQL 'transaction' query. isError: 0 = pass (no error), 1 = error
• Get Transaction Info by Transaction Hash: Returns transaction information including revert reason if available
• Get Transaction Receipt Status: Returns the status of a transaction receipt. Also available through a GraphQL 'transaction' query. Status: 0 = failed, 1 = successful
• Get a human-readable, LLM-based transaction summary: Retrieves a human-readable summary of what a transaction did, presented in natural language.
• Get on-chain state changes caused by a specific transaction: Retrieves state changes (balance changes, token transfers) caused by a specific transaction.
• Get step-by-step execution trace for a specific transaction: Retrieves the raw execution trace for a transaction, showing the step-by-step execution path and all contract interactions.
• Get transaction statistics: Retrieves statistics for transactions, including counts and fee summaries for the last 24 hours.
• List beacon deposits in a transaction: Retrieves beacon deposits included in a specific transaction with pagination support.
• List blobs for a transaction: Retrieves blobs for a specific transaction (Ethereum only).
• List blockchain transactions with filtering options for status, type, and method: Retrieves a paginated list of transactions with optional filtering by status, type, and method.
• List event logs emitted during a specific transaction: Retrieves event logs emitted during the execution of a specific transaction. Logs contain information about contract events and state changes.
• List external transactions linked to a transaction: Retrieves external transactions that are linked to the specified transaction (e.g., Solana transactions in neon chain type).
• List FHE operations for a specific transaction: Retrieves Fully Homomorphic Encryption (FHE) operations parsed from transaction logs. Includes operation details, HCU (Homomorphic Compute Unit) costs, operation types, and related metadata.
• List internal transactions triggered during a specific transaction: Retrieves internal transactions generated during the execution of a specific transaction. Useful for analyzing contract interactions and debugging failed transactions.
• List L2 transactions in a Scroll batch: Retrieves L2 transactions bound to a specific Scroll batch number.
• List L2 transactions in a ZkSync batch: Retrieves L2 transactions bound to a specific ZkSync batch number.
• List L2 transactions in an Arbitrum batch: Retrieves L2 transactions bound to a specific Arbitrum batch number.
• List L2 transactions in an Optimism batch: Retrieves L2 transactions bound to a specific Optimism batch number.
• List token transfers within a specific transaction: Retrieves token transfers that occurred within a specific transaction, with optional filtering by token type.
• List transactions executed on a specific execution node: Retrieves transactions that were executed on the specified execution node.
• List transactions in a user's watchlist: Retrieves transactions in the authenticated user's watchlist.
• Retrieve detailed information about a specific transaction: Retrieves detailed information for a specific transaction identified by its hash.
• List validator withdrawal details on proof-of-stake networks: Retrieves a paginated list of withdrawals, typically for proof-of-stake networks supporting validator withdrawals.
• Withdrawals counters: Returns total withdrawals count and sum from cache.
• Zilliqa validator by its BLS public key.: Retrieves Zilliqa validator detailed info by the given BLS public key.
• Zilliqa validators list.: Retrieves the list of Zilliqa validators.
• Base API
• Blockscout APIs: How to use Blockscout APIs
• Blockscout APIs
• API Archive
• API keys for self hosted chains
• Autoscout API
• GraphQL in Blockscout
• Requests & Limits: API variables and info
• REST API Endpoints
• Interpreter API
• Stats API
• JSON RPC & ETH Compatible RPC Endpoints: API designed for ease of use
• Account: ?module=account
• Block: ?module=block
• Contract: ?module=contract
• ETH RPC API
• Logs: ?module=logs
• Stats: ?module=stats
• Token: ?module=token
• Transaction: ?module=transaction
• Swagger Hub
• Blockscout Software Licence
• Blockscout SDK
• Chainscout Chains List: List of EVM networks supported by Blockscout
• Dev Portal
• Error Handling
• For Web3 Developers
• Integrate Merits
• MCP Server: Wraps Blockscout APIs to expose blockchain data such as balances, tokens, NFTs, and contract metadata via MCP
• Metadata Service
• Migrate from Etherscan
• Multichain Service
• PRO API General Info
• PRO API Responses and Routes: Blockscout's PRO API provides higher call limits and custom endpoints
• Link To Blockscout: Easily replace your current explorer links with Blockscout explorer links
• Stats Dashboard
• Tax Calculator
• API for AI Agents
• Overview
• Smart Contract Verification: Verifying your deployed contract using contract source code, JSON input, Sourcify and more.
• Blockscout Smart Contract Verification API: Blockscout also offers a contract verification API.
• Blockscout UI
• Sourcify Verification
• Foundry Verification
• Hardhat Verification Plugin
• Sourcify Plugin For Hardhat
• Interacting with Smart Contracts: Use Blockscout to Read and Write to Smart Contracts
• Remix Verification
• Stylus Verification: Verify stylus contracts with the Blockscout API
• Verification via thirdweb
• Wallet History
• Discord Channel
• Discussion
• Developer FAQs: FAQs for developers
• User FAQs: FAQs for users
• Integrating Blockscout into your Application: Using APIs, SDK, and other tools with Blockscout
• Migration Guide: Whether you are a developer, project, or blockchain user, learn how to migrate from other explorers to Blockscout
• Running Blockscout: Hosting, ENVs and other info
• Using an Explorer: Retrieving and interacting with blockchain data
• GitHub Repo
• What is WaaS: Blockscout's wallet as a service provides instant access to a robust global ecosystem wallet
• Integration Guide: Integrate the global wallet SDK into your app on a supported chain
• Current Integrations
• Blockscout Docs: Blockscout is a universal, open-source blockchain explorer for inspecting, analyzing, and interacting with EVM-based chains. Blockscout supports over 1000 L1, L2 and L3 EVM-based chains, optimistic rollups, and ZK rollups.
• Optimism API
• Contributing to Blockscout: How to contribute to Blockscout and collaborate with the community.
• Media Kit: Branding and Logos
• EaaS: Hosting with Blockscout: Explorer as a Service offerings from Blockscout
• Release Notes
• V5.0.0: 1/11/23: Release notes for Blockscout version 5.0.0 (January 11, 2023).
• V5.1.0: 2/13/23: Release notes for Blockscout version 5.1.0 (February 13, 2023).
• V5.2.0: 6/20/23: Release notes for Blockscout version 5.2.0 (June 20, 2023).
• V5.3.0: 10/23/23: Release notes for Blockscout version 5.3.0 (October 23, 2023).
• Security Program: Responsible security vulnerability disclosure
• Celestia Node / Indexer
• Configuration Options: Configuration options and settings for Blockscout deployment.
• Admin Panel Usage
• Automating Restarts
• Charts And Stats: New Blockscout stats service
• Circle CI Updates
• Exchange Rates
• Haproxy Settings For Blockscout.Com: Blockscout.com uses haproxy for all BlockScout hosted and external instances.
• Logger Configs: Adjust # of files and max size to impact disc space
• Memory Usage
• My Account Settings
• ReCAPTCHA
• Sorting And Pagination
• Tracing
• Metrics
• Reown (Previously WalletConnect) Project ID For Contract Read/Write
• DB Schema: Database schema structure and reference for Blockscout.
• Deployment: Blockscout deployment options
• AWS Marketplace (Deprecated): BlockScout is now available in the Amazon Marketplace.
• AWS EC2 Archive Node Setup With OpenEthereum (Formerly Parity): The following provides an example node setup. Performance related parameters will vary per chain.
• Prerequisites & Install Parameters: Prerequisites and installation parameters
• CloudFormation Template: CloudFormation template and topology for Blockscout AWS deployment.
• Customizing CSS: How to customize the Blockscout theme and CSS on AWS Marketplace deployments.
• Install From AWS Marketplace: AWS Marketplace provides an easy install option for BlockScout
• Overview: Overview of Blockscout deployment via AWS Marketplace.
• Updating & Redeploying In AWS: How to update or redeploy Blockscout on AWS Marketplace.
• AWS Permissions & Settings: AWS requirements for deployment
• Creating A Secret Key Pair: An access key is needed to utilize the aws cli
• Creating An AWS Certificate For SSL: Optional process if you want to use SSL with your BlockScout instance
• Login With AWS CLI: How to log in to AWS CLI for Terraform deployment.
• Manually Cleaning Terraform Related Instances: AWS cleaning resources
• Common Additional Tasks: Additional tasks for managing and maintaining Blockscout deployments with Ansible.
• Common Errors And Questions: Common errors and frequently asked questions for Ansible-based deployments.
• Deploying Blockscout: Step-by-step guide for deploying Blockscout using Ansible and Terraform.
• Deploying The Blockscout Infrastructure: Guide to deploying the infrastructure required for Blockscout using Ansible and Terraform.
• Destroying Provisioned Infrastructure: Instructions for destroying provisioned infrastructure with Ansible and Terraform.
• Overview: Overview of Ansible playbooks and infrastructure for Blockscout deployment.
• Prerequisites: Prerequisites and dependencies for Ansible-based Blockscout deployment.
• Variables: ENV variables must be configured per chain
• Avalanche Chains
• Cosmos Based Chains: Using Blockscout as an explorer for Cosmos-based chains with SHUTTLE proxy.
• Docker Compose Deployment: For local builds
• Frontend Migration: Options and instructions for migrating to the new Blockscout frontend.
• All In One Container: Migrate to the new frontend using Docker
• Customized Backend
• FAQs
• Proxy Setup: NGINX default template
• Separate Frontend
• Kubernetes Deployment: Deploy Blockscout using Kubernetes and Helm charts.
• Manual Deployment Guide: Deploy Blockscout with a user-friendly UI and all microservices
• MacOS Setup
• Ubuntu Setup
• Manual Deployment (Backend + Old UI): General deployment instructions for a hardware or cloud services environment
• Manual Cleaning An Instance From The Previous Deployment
• Rollup Deployment: Instructions and environment variables for deploying Blockscout on rollup chains.
• Terraform Deployment: Supernets deployment configs
• Upgrade Guide (V7.0 & V8.0): Guide for upgrading Blockscout to major versions 7.0 and 8.0.
• ENV Variables: Environment variables for configuring Blockscout instances.
• Backend ENVs: Common
• Backend ENVs: Chain Specific: ENVS for specific chains and rollups
• Backend ENVs: Integrations
• Deprecated Backend ENVs
• Frontend ENVs: Common
• Deprecated ENVs
• Frontend ENVs
• Indexing: Indexing process, monitoring, and troubleshooting for Blockscout.
• How Do I Fix Indexer Timeouts?
• How Do I Update Memory Consumption To Fix Indexer Memory Errors?
• General Overview: General overview of Blockscout architecture and settings.
• EVM Version Information
• Indexer Architecture Overview: Learn how the indexing architecture works in Blockscout
• Separate Indexer, Web App, And API
• ShareLock: ShareLock is the row-level locking mechanism used internally by PostgreSQL.
• Umbrella Project Organization: How the BlockScout project is organized
• Microservices: Overview of Blockscout microservices and their deployment.
• Blockscout ENS (BENS) Name Service Integration: BENS service extends Blockscout support for name services
• Smart Contract Verification: Details about the verification microservice
• Requirements: System, hardware, and software requirements for running Blockscout.
• Backend/Frontend Compatibility Matrix
• Client Setting Requirements
• Database Storage Requirements
• L2 > L1 JSON RPC Method Requests
• Node Tracing / JSON RPC Requirements
• General Backend Requirements / Blockscout Backend Prerequisites
• Hardware & Hosting Requirements
• Testing: How to test Blockscout, including requirements, commands, and environment setup.
• Soneium API
• Autoscout Explorer Launchpad: Deploy a production-ready instance on the cloud in 5 minutes
• Dappscout Apps Marketplace: Dappscout is a curated collection of on-chain applications
• DApp Integration: Prepare your DApp for submission to the DAppscout marketplace
• Creating an Instance
• Multisend: Multisend Essential Dapp
• Revoke: Check, manage and revoke your token approvals
• Swap: Swap and bridge multi-chain application for Blockscout users
• CSV Exports: Export of blockchain entities related to address into a CSV file
• Merits
• Activity Pass: Get you pass and earn more Merits
• Badges: Earn and collect NFT Scout badges by engaging and exploring the blockchain with Blockscout.
• Earn Merits when using Swap
• FAQs
• Leaderboard: View accounts by Merits
• Streak Rewards: Connecting to Blockscout on consecutive days increases your streak and your Merits
• My Account
• API keys
• Custom ABI
• For Developers: When setting up My Account for your chain
• Private tags
• Public tags: Request a tag or report an incorrect tag
• Verified Addresses
• Copy and Sign Message
• Watch list
• UI Sections
• Address Page: Address page details
• Beacon Chain Withdrawal Views: Coming Soon
• Blocks
• Glossary of Terms
• Main Menu
• Transaction Fields: Description of your new file.
• Transaction Types
• Token Support
• ERC 1155 Support: Basic support for ERC-1155s
• Widgets: Quick access to essential 3rd party address and contract info

OpenAPI Specs

• pro-api-v11
• openapi-deprecation
• pro-api
• jsonrpc-endpoints
• openapi
• merits-admin-service
• blockscout-rpc-api_2
• blockscout-rpc-api_1
• blockscout-pro-api

Optional

• Community
• Blog
• API Docs