Skip to main content
Access the dev portal and get a free API key at https://dev.blockscout.com/

​
General Info

The PRO API provides expanded rate limits for high-usage projects on Blockscout hosted networks. The free plan includes 100K API credits per day with a rate limit of 5 requests per second. View additional pricing tiers below.
If you are using accessing the PRO API via AI or an AI agent, direct the AI to this file to get started. https://dev.blockscout.com/llms.txt
Blockscout uses a credit system to weight different calls based on size and usage. This creates additional efficiency and saves resources depending on the types of call you need to make. See the blockscout credit costs table for more info on credit allotments for individual calls.

​
PRO API Pricing Tiers

PlanCost/MoAPI CreditsRate LimitOverage
Rate
Free$0100K/day5 RPS-
Builder$49100M/mo15 RPS$0.5/M
Pro$199500M/mo30 RPS$0.4/M
Business$9993B/mo50 RPS$0.32/M
EnterpriseCustom SLAunlimitedTBDN/A

​
PRO API Authorization

Pass an API key using either:
  • apikey query parameter
  • authorization header

​
PRO API Response Headers

The following information related to the PRO API plan are included in the response headers
  • x-credits-remaining: Number of credits remaining in your plan. If on the free plan, this will resent daily, othewise it is monthly. You can check additional details in the PRO API UI.
  • x-ratelimit-limit: Available RPS with your plan (can be -1 if there is an internal error)
  • x-ratelimit-remaining: Remaining rate limit based on your queries (can be -1 if there is an internal error)
  • x-ratelimit-reset: time in milliseconds until the rate limit resets (can be -1 if there is an internal error)
Screenshot2026 03 04at1 29 00PM

​
PRO API Routes

All current API routes can be used with the PRO Plan. See the PRO API Endpoints section to try example calls with your API key. The Route examples below use the Optimism chain (chain_id=10). In Previous per-instance routes API keys are optional for the free tier, they are required for all tiers (including the free tier) of the PRO API.

​
JSON PRC API v2 (compare to Etherscan PRO API)

PRO API Route: 
https://api.blockscout.com/v2/api?chain_id=10&module=block&action=eth_block_number&apikey=proapi_xxxxxxxx
Previous per-instance route:
https://optimism.blockscout.com/api?module=block&action=eth_block_number

​
JSON RPC API

PRO API Route: 
https://api.blockscout.com/10/api?module=account&action=eth_get_balance&address={addressHash}&apikey=proapi_xxxxxxx
Previous per-instance route:
https://optimism.blockscout.com/api?module=account&action=eth_get_balance&address={addressHash}

​
REST API

PRO API Route: 
https://api.blockscout.com/10/api/v2/blocks/{block_number_or_hash}?apikey=proapi_xxxxxxxx
Previous per-instance route:
https://optimism.blockscout.com/api/v2/blocks/{block_number_or_hash}

​
ETH RPC API

see ETH RPC docs for more info on post requests. PRO API Route 
curl -H "content-type: application/json" \
  -H "authorization: Bearer proapi_xxxxxx" \
  -X POST \
  --data '{"id":0,"jsonrpc":"2.0","method":"eth_blockNumber","params":[]}' \
  https://api.blockscout.com/10/json-rpc
Please see the API reference section for specific endpoint info related to the various API routes.

​
Pagination

Blockscout uses the keyset pagination method to quickly return results. By default an API response returns the first 50 results. To access additional results (in groups of 50), add the next_page_params to your query. For example, open https://api.blockscout.com/10/api/v2/transactions?apikey=proapi_xxxxxx and scroll to the bottom of the response.
Tx Pagination 1
You will see the next_page_params object. Add the parameters from this object to your next query to receive the next 50 results. https://api.blockscout.com/10/api/v2/transactions?apikey=proapi_xxxxxx&block_number=148445196&index=59&items_count=50 Repeat this process to continue receiving results in groups of 50 (remove params and substitute the new next_page_params found in the body of the query).
Tx Pagination 2
In this example, the query to receive the next 50 results would be: https://api.blockscout.com/10/api/v2/transactions?apikey=proapi_xxxxxx&block_number=148445366&index=24&items_count=50

​
Blockscout Credit Costs

Credit amounts vary based on resource usage for different calls. The number of credits required for different calls is subject to change based on current analytics and resource usage. You can check your credits, top calls and overall usage in the dev portal dashboard at https://dev.blockscout.com/ Credits are consumed per API call. The default cost is 20 credits for any endpoint not listed below.
EndpointCredits
default (all unlisted endpoints)20
api/v2/search/quick25
api/v2/transactions/:hash/logs30
api/v2/transactions/:hash/token-transfers30
api/v2/transactions/:hash/state-changes30
api/v2/tokens30
api/v2/tokens/:address_hash/transfers30
api/v2/addresses/:address_hash/token-transfers30
api/v2/addresses/:address_hash/logs30
api/v2/transactions/:hash/internal-transactions40
api/v2/addresses/:address_hash/internal-transactions40
api/v2/smart-contracts/verification/config40
api/v2/transactions/:hash/summary50
api/v2/transactions/:hash/raw-trace50
api/v2/addresses/:address_hash/coin-balance-history50
Last Updated February, 2026