Scrollscan
HomeTwitterKnowledge Base
Scroll Mainnet
Scroll Mainnet
  • Introduction
  • ✨Getting Started
    • Creating an Account
    • Getting an API key
    • Endpoint URLs
  • 🎯API Endpoints
    • Accounts
    • Contracts
    • Transactions
    • Blocks
    • Logs
    • Geth/Parity Proxy
    • Tokens
    • Stats
  • ✅Contract Verification
    • What's Contract Verification
    • Awesome Verification
    • Verifying Contracts Programmatically
    • Contract Verification Plugins
    • Common Verification Errors
  • 🔧Misc Tools & Utilities
    • Libraries
  • 🤝Support
    • FAQ
    • Rate Limits
    • Common Error Messages
    • Getting Help
  • Visit Scrollscan.io
Powered by GitBook
On this page
  • Get Block by BlockNo
  • Get Estimated Block Countdown Time by BlockNo
  • Get Block Number by Timestamp
  1. API Endpoints

Blocks

PreviousTransactionsNextLogs

Last updated 1 year ago

Endpoints with are under the API Pro subscription. To upgrade your API plan, browse through the page.

Get Block by BlockNo

Returns the block rewards.

https://api.scrollscan.com/api
   ?module=block
   &action=getblockreward
   &blockno=634658
   &apikey=YourApiKeyToken

Try this endpoint in your

Query Parameters

Parameter
Description

blockno

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": {
    "blockNumber": "634658",
    "timeStamp": "1699413875",
    "blockMiner": "0x2448e8bb66f2e79163a6afe95a91fc024e59dfb2",
    "blockReward": "4936230533996952",
    "uncles": [],
    "uncleInclusionReward": "0"
  }
}

​​ Tip : The timestamp field is denoted in

Get Estimated Block Countdown Time by BlockNo

Returns the estimated time remaining, in seconds, until a certain block is sequenced.

https://api.scrollscan.com/api
   ?module=block
   &action=getblockcountdown
   &blockno=1000000
   &apikey=YourApiKeyToken

Query Parameters

Parameter
Description

blockno

Sample Response

{
  "status": "1",
  "message": "OK",
  "result": {
    "CurrentBlock": "634706",
    "CountdownBlock": "1000000",
    "RemainingBlock": "365294",
    "EstimateTimeInSec": "1205485.2"
  }
}

Get Block Number by Timestamp

Returns the block number that was sequenced at a certain timestamp.

https://api.scrollscan.com/api
   ?module=block
   &action=getblocknobytime
   &timestamp=1578638524
   &closest=before
   &apikey=YourApiKeyToken

Query Parameters

Parameter
Description

timestamp

the integer representing the Unix timestamp in seconds.

closest

the closest available block to the provided timestamp, either before or after

Sample Response

{
   "status":"1",
   "message":"OK",
   "result":"624695"
}

the integer block number to check block rewards for eg.

Try this endpoint in your

the integer block number to estimate time remaining to be mined eg.

Try this endpoint in your

Tip : Convert a regular date-time to a

🎯
🔗
browser
🔗
browser
⏳
Unix timestamp.
12697906
12697906
🔗
⏳
Scrollscan APIs
browser
Unix timestamp.