Parameters

address

string

REQUIRED

The bitcoin address to validate

Returns

result

object

Validation result for the address

isvalid

boolean

If the address is valid or not

address

string

(Optional) The validated bitcoin address

scriptPubKey

string

(Optional) The hex encoded scriptPubKey generated by the address

isscript

boolean

(Optional) It verifies if the key is a script or not

iswitness

boolean

(Optional) It verifies if the address is a witness address or not

witness_version

integer

(Optional) The version number of the witness program

witness_program

string

(Optional) The hex value of the witness program

error

string

(Optional) Error message when isvalid is false

error_locations

array

(Optional) Character indexes related to the validation error

error

object | null

(Optional) JSON-RPC error when the request failed; omitted or null on success

code

integer

Error code

message

string

Error message

Request

1
curl -X POST "https://docs-demo.btc.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "validateaddress",
6
  "params": [
7
    "bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl"
8
  ],
9
  "id": 1
10
}'

1
curl -X POST "https://docs-demo.btc.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "validateaddress",
6
  "params": [
7
    "bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl"
8
  ],
9
  "id": 1
10
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'validateaddress',
4
    params: ["bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl"],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.btc.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'validateaddress',
4
    params: ["bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl"],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.btc.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.btc.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "validateaddress",
9
  "params": [
10
    "bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl"
11
  ],
12
  "id": 1
13
})
14
headers = {
15
  'Content-Type': 'application/json'
16
}
17

18
response = requests.request("POST", url, headers=headers, data=payload)
19

20
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.btc.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "validateaddress",
9
  "params": [
10
    "bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl"
11
  ],
12
  "id": 1
13
})
14
headers = {
15
  'Content-Type': 'application/json'
16
}
17

18
response = requests.request("POST", url, headers=headers, data=payload)
19

20
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.btc.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "validateaddress",
11
  params: ["bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl"]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.btc.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "validateaddress",
11
  params: ["bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl"]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

Response

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "isvalid": true,
5
    "address": "bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl",
6
    "scriptPubKey": "0014a5c8a4ec03f73afee872d4319b2202c2cdbfae07",
7
    "isscript": false,
8
    "iswitness": true,
9
    "witness_version": 0,
10
    "witness_program": "a5c8a4ec03f73afee872d4319b2202c2cdbfae07"
11
  },
12
  "id": 1
13
}

1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "isvalid": true,
5
    "address": "bc1q5hy2fmqr7ua0a6rj6scekgszctxmlts8smwxcl",
6
    "scriptPubKey": "0014a5c8a4ec03f73afee872d4319b2202c2cdbfae07",
7
    "isscript": false,
8
    "iswitness": true,
9
    "witness_version": 0,
10
    "witness_program": "a5c8a4ec03f73afee872d4319b2202c2cdbfae07"
11
  },
12
  "id": 1
13
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free