# Blockscout Smart Contracts List by Chain

> Blockscout Smart Contracts List by Chain is a paid API for AI agents from api.blockscout.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-12).

Retrieves a paginated list of verified smart contracts on a specified blockchain network via Blockscout's multichain explorer API

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/smart-contracts
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-smart-contracts-list-by-chain-a18f3791
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OtIyOPKtgkRM5XuPVjH9b

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blockscout-smart-contracts-list-by-chain-a18f3791
```

Example prompt: Can you pull up the list of verified smart contracts on the Ethereum mainnet (chain ID 1) from Blockscout, sorted by transaction count in descending order?

## When to prefer this

Choose this endpoint when you need to browse, search, or filter verified smart contracts on a specific blockchain supported by Blockscout, especially when you need rich contract metadata like verification status, compiler version, reputation, and GitHub links. Prefer this over generic block explorers when cross-chain contract discovery or certified contract filtering is needed.

## Known failure modes

- Invalid chain_id returns no results or 404 error
- Unrecognized filter or sort parameters may be ignored or return an error
- Pagination with invalid items_count or smart_contract_id may cause unexpected results
- Rate limiting may occur for high-frequency queries
- Chain not supported by Blockscout returns empty or error response

## How this service works

Explore crypto activities with Blockscout's multichain search. Find transactions, addresses, tokens, and dapps across top blockchain networks — your go-to explorer for cross-chain blockchain data

## Output

Returns a paginated JSON list of smart contracts, each including address hash, contract name, verification status, compiler version, programming language, license type, market cap, coin balance, transaction count, proxy type, reputation, certification status, GitHub repository metadata, and pagination parameters for fetching the next page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "properties": {
      "chain_id": {
       "type": "string"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string"
      },
      "hash": {
       "type": "string"
      },
      "sort": {
       "type": "string"
      },
      "order": {
       "type": "string"
      },
      "filter": {
       "type": "string"
      },
      "items_count": {
       "type": "integer"
      },
      "coin_balance": {
       "type": "string"
      },
      "smart_contract_id": {
       "type": "integer"
      },
      "transactions_count": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "address": {
     "hash": "string",
     "name": "string",
     "is_scam": true,
     "metadata": {},
     "proxy_type": "string",
     "reputation": "string",
     "is_contract": true,
     "is_verified": true,
     "public_tags": [
      {
       "label": "string",
       "address_hash": "string",
       "display_name": "string"
      }
     ],
     "private_tags": [
      {
       "label": "string",
       "address_hash": "string",
       "display_name": "string"
      }
     ],
     "ens_domain_name": "string",
     "implementations": [
      {
       "name": "string",
       "address_hash": "string"
      }
     ],
     "watchlist_names": [
      {
       "label": "string",
       "display_name": "string"
      }
     ]
    },
    "language": "string",
    "certified": true,
    "market_cap": "string",
    "reputation": "string",
    "verified_at": "string",
    "coin_balance": "string",
    "license_type": "string",
    "package_name": "string",
    "compiler_version": "string",
    "transactions_count": 0,
    "has_constructor_args": true,
    "optimization_enabled": true,
    "github_repository_metadata": {}
   }
  ],
  "next_page_params": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-smart-contracts-list-by-chain-a18f3791/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.blockscout.com](https://www.zero.xyz/host/api.blockscout.com/llms.txt)