Skip to main content
GET
/
?module=contract&action=listcontracts
Get List of Contracts
curl --request GET \
  --url 'https://eth.blockscout.com/api/?module=contract&action=listcontracts'
{
  "message": "OK",
  "result": [
    {
      "address": "0x1234",
      "contractName": "Example",
      "verified": "true"
    }
  ],
  "status": "1"
}

Documentation Index

Fetch the complete documentation index at: https://docs.blockscout.com/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
module
enum<string>
required

Module name (must be 'contract')

Available options:
contract
​
action
enum<string>
required

Action name (must be 'listcontracts')

Available options:
listcontracts
​
page
integer

Page number for pagination

​
offset
integer

Max number of records per page

​
filter
string

Filter verified unverified empty or 1 2 3

​
verified_at_start_timestamp
string

Unix timestamp for start (verified filter only)

​
verified_at_end_timestamp
string

Unix timestamp for end (verified filter only)

Response

200 - application/json

Successful response

​
status
enum<string>

Status code (1 = OK)

Available options:
1
​
message
string

Response message

Example:

"OK"