API Documentation

FindBlock provides a public API that simplifies common tasks when it comes to working with EVM chains. At the moment, it supports 1115 of them - the full list is available here.

This documentation provides a brief overview of the available functionality. You can find the complete API docs alogn with examples and detailed descriptions in the Swagger UI. The swagger specification file is available at https://api.findblock.xyz/v1/swagger.json.

Learn more about Swagger / OpenAPI

Listing available chains

Try it out

GET /v1/chains

Returns a list of available chains in JSON format.

Getting chain details

Try it out

GET /v1/chains/[chainId]

Returns details of a particular chain by its native chain ID.

Finding the last block before timestamp

Try it out

GET /v1/chains/[chainId]/block/before/[timestamp]

Returns details of the last block before the specified timestamp.

By default the timestamp is exclusive (i.e. if there is a block whose timestamp matches this timestamp, it will be excluded). If the search should be includive, inclusive query parameter needs to be passed.

Finding the first block after timestamp

Try it out

GET /v1/chains/[chainId]/block/after/[timestamp]

Returns details of the first block after the specified timestamp.

By default the timestamp is exclusive (i.e. if there is a block whose timestamp matches this timestamp, it will be excluded). If the search should be includive, inclusive query parameter needs to be passed.

Proxying a request to the best-performing RPC

Try it out

POST /v1/chains/[chainId]/rpc/use

Returns the result of a JsonRPC call proxied to the best-performing RPC.