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

Authorizations

​
apikey
string
query
required

Optional API key for increased rate limits.

Without API key:

  • 5 requests per second (shared pool)
  • No registration required

With API key:

  • 10 requests per second per key
  • Up to 3 free keys per account
  • Get your API key at https://blockscout.com (login required)

Usage: Add apikey=YOUR_KEY to any request query string.

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"