Sandbox::https://docs.etherscan.io/api-reference/endpoint/verifysourcecode

Verify Solidity Source Code

curl --request POST \
  --url 'https://api.etherscan.io/v2/api?apikey=' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7 \
  --data 'sourceCode=<string>' \
  --data contractname=contracts/Verified.sol:Verified \
  --data 'compilerversion=v0.8.24+commit.e11b9ed9' \
  --data codeformat=solidity-standard-json-input \
  --data optimizationUsed=0 \
  --data runs=200 \
  --data constructorArguments=00000000000000000000000074271f2282ed7ee35c166122a60c9830354be42a \
  --data evmVersion=default \
  --data licenseType=1

import requests

url = "https://api.etherscan.io/v2/api?apikey="

payload = {
    "contractaddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "sourceCode": "<string>",
    "contractname": "contracts/Verified.sol:Verified",
    "compilerversion": "v0.8.24+commit.e11b9ed9",
    "codeformat": "solidity-standard-json-input",
    "optimizationUsed": "0",
    "runs": "200",
    "constructorArguments": "00000000000000000000000074271f2282ed7ee35c166122a60c9830354be42a",
    "evmVersion": "default",
    "licenseType": "1"
}
headers = {"Content-Type": "application/x-www-form-urlencoded"}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/x-www-form-urlencoded'},
  body: new URLSearchParams({
    contractaddress: '0xdAC17F958D2ee523a2206206994597C13D831ec7',
    sourceCode: '<string>',
    contractname: 'contracts/Verified.sol:Verified',
    compilerversion: 'v0.8.24+commit.e11b9ed9',
    codeformat: 'solidity-standard-json-input',
    optimizationUsed: '0',
    runs: '200',
    constructorArguments: '00000000000000000000000074271f2282ed7ee35c166122a60c9830354be42a',
    evmVersion: 'default',
    licenseType: '1'
  })
};

fetch('https://api.etherscan.io/v2/api?apikey=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.etherscan.io/v2/api?apikey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7&sourceCode=%3Cstring%3E&contractname=contracts%2FVerified.sol%3AVerified&compilerversion=v0.8.24%2Bcommit.e11b9ed9&codeformat=solidity-standard-json-input&optimizationUsed=0&runs=200&constructorArguments=00000000000000000000000074271f2282ed7ee35c166122a60c9830354be42a&evmVersion=default&licenseType=1",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/x-www-form-urlencoded"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.etherscan.io/v2/api?apikey="

	payload := strings.NewReader("contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7&sourceCode=%3Cstring%3E&contractname=contracts%2FVerified.sol%3AVerified&compilerversion=v0.8.24%2Bcommit.e11b9ed9&codeformat=solidity-standard-json-input&optimizationUsed=0&runs=200&constructorArguments=00000000000000000000000074271f2282ed7ee35c166122a60c9830354be42a&evmVersion=default&licenseType=1")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/x-www-form-urlencoded")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.etherscan.io/v2/api?apikey=")
  .header("Content-Type", "application/x-www-form-urlencoded")
  .body("contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7&sourceCode=%3Cstring%3E&contractname=contracts%2FVerified.sol%3AVerified&compilerversion=v0.8.24%2Bcommit.e11b9ed9&codeformat=solidity-standard-json-input&optimizationUsed=0&runs=200&constructorArguments=00000000000000000000000074271f2282ed7ee35c166122a60c9830354be42a&evmVersion=default&licenseType=1")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.etherscan.io/v2/api?apikey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/x-www-form-urlencoded'
request.body = "contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7&sourceCode=%3Cstring%3E&contractname=contracts%2FVerified.sol%3AVerified&compilerversion=v0.8.24%2Bcommit.e11b9ed9&codeformat=solidity-standard-json-input&optimizationUsed=0&runs=200&constructorArguments=00000000000000000000000074271f2282ed7ee35c166122a60c9830354be42a&evmVersion=default&licenseType=1"

response = http.request(request)
puts response.read_body

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

POST

api

Verify Solidity Source Code

curl --request POST \
  --url 'https://api.etherscan.io/v2/api?apikey=' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7 \
  --data 'sourceCode=<string>' \
  --data contractname=contracts/Verified.sol:Verified \
  --data 'compilerversion=v0.8.24+commit.e11b9ed9' \
  --data codeformat=solidity-standard-json-input \
  --data optimizationUsed=0 \
  --data runs=200 \
  --data constructorArguments=00000000000000000000000074271f2282ed7ee35c166122a60c9830354be42a \
  --data evmVersion=default \
  --data licenseType=1

import requests

url = "https://api.etherscan.io/v2/api?apikey="

payload = {
    "contractaddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "sourceCode": "<string>",
    "contractname": "contracts/Verified.sol:Verified",
    "compilerversion": "v0.8.24+commit.e11b9ed9",
    "codeformat": "solidity-standard-json-input",
    "optimizationUsed": "0",
    "runs": "200",
    "constructorArguments": "00000000000000000000000074271f2282ed7ee35c166122a60c9830354be42a",
    "evmVersion": "default",
    "licenseType": "1"
}
headers = {"Content-Type": "application/x-www-form-urlencoded"}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/x-www-form-urlencoded'},
  body: new URLSearchParams({
    contractaddress: '0xdAC17F958D2ee523a2206206994597C13D831ec7',
    sourceCode: '<string>',
    contractname: 'contracts/Verified.sol:Verified',
    compilerversion: 'v0.8.24+commit.e11b9ed9',
    codeformat: 'solidity-standard-json-input',
    optimizationUsed: '0',
    runs: '200',
    constructorArguments: '00000000000000000000000074271f2282ed7ee35c166122a60c9830354be42a',
    evmVersion: 'default',
    licenseType: '1'
  })
};

fetch('https://api.etherscan.io/v2/api?apikey=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.etherscan.io/v2/api?apikey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7&sourceCode=%3Cstring%3E&contractname=contracts%2FVerified.sol%3AVerified&compilerversion=v0.8.24%2Bcommit.e11b9ed9&codeformat=solidity-standard-json-input&optimizationUsed=0&runs=200&constructorArguments=00000000000000000000000074271f2282ed7ee35c166122a60c9830354be42a&evmVersion=default&licenseType=1",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/x-www-form-urlencoded"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.etherscan.io/v2/api?apikey="

	payload := strings.NewReader("contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7&sourceCode=%3Cstring%3E&contractname=contracts%2FVerified.sol%3AVerified&compilerversion=v0.8.24%2Bcommit.e11b9ed9&codeformat=solidity-standard-json-input&optimizationUsed=0&runs=200&constructorArguments=00000000000000000000000074271f2282ed7ee35c166122a60c9830354be42a&evmVersion=default&licenseType=1")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/x-www-form-urlencoded")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.etherscan.io/v2/api?apikey=")
  .header("Content-Type", "application/x-www-form-urlencoded")
  .body("contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7&sourceCode=%3Cstring%3E&contractname=contracts%2FVerified.sol%3AVerified&compilerversion=v0.8.24%2Bcommit.e11b9ed9&codeformat=solidity-standard-json-input&optimizationUsed=0&runs=200&constructorArguments=00000000000000000000000074271f2282ed7ee35c166122a60c9830354be42a&evmVersion=default&licenseType=1")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.etherscan.io/v2/api?apikey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/x-www-form-urlencoded'
request.body = "contractaddress=0xdAC17F958D2ee523a2206206994597C13D831ec7&sourceCode=%3Cstring%3E&contractname=contracts%2FVerified.sol%3AVerified&compilerversion=v0.8.24%2Bcommit.e11b9ed9&codeformat=solidity-standard-json-input&optimizationUsed=0&runs=200&constructorArguments=00000000000000000000000074271f2282ed7ee35c166122a60c9830354be42a&evmVersion=default&licenseType=1"

response = http.request(request)
puts response.read_body

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

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

Authorizations

apikey

string

query

required

Enter your Etherscan API key, or set one up if you don't have one.

Query Parameters

chainid

string

required

Chain ID to query, eg 1 for Ethereum, 42161 for Arbitrum from our supported chains.

module

string

default:contract

required

Set to contract for this endpoint.

action

string

default:verifysourcecode

required

Set to verifysourcecode for this endpoint.

Body

application/x-www-form-urlencoded

contractaddress

string

required

The address where the contract is deployed.

Example:

"0xdAC17F958D2ee523a2206206994597C13D831ec7"

sourceCode

string

required

The Solidity source code to verify.

contractname

string

required

The contract name, including path if applicable. If codeformat=solidity-standard-json-input, then enter contractname as erc20.sol:erc20.

Example:

"contracts/Verified.sol:Verified"

compilerversion

string

required

Compiler version used for compilation. See the supported Solidity compiler versions.

Example:

"v0.8.24+commit.e11b9ed9"

codeformat

string

Use solidity-single-file for a single file or solidity-standard-json-input for JSON input.

Example:

"solidity-standard-json-input"

optimizationUsed

string

Required for solidity-single-file verification and when codeformat is omitted or unrecognized. Not required for solidity-standard-json-input.

Example:

"0"

runs

string

Number of optimization runs.

Example:

"200"

constructorArguments

string

Optional constructor arguments used in contract deployment.

Example:

"00000000000000000000000074271f2282ed7ee35c166122a60c9830354be42a"

evmVersion

string

Use compiler default or specify an EVM version such as byzantium, shanghai.

Example:

"default"

licenseType

string

The open source license to associate with the verified source code, e.g 3 for MIT.

Example:

"1"

Response

200 - application/json

Successful response

status

string

1 if the request returned data, 0 otherwise. A status of 0 can indicate an error or a valid request that returned no records.

message

string

OK on success, otherwise an error description such as NOTOK. See common error messages.

result

string

GUID for the verification submission. Use it with checkverifystatus to poll the result.

API Endpoints

Beta Endpoints

Verify Solidity Source Code

Authorizations

Query Parameters

Body

Response